git-learn/devflow/projects/2026-05-21-sm-flow-v3-1-upgrade/brief.md

SM Flow v3.1 Upgrade Brief

背景

• 用户目标：把 sm-flow v3 使用中暴露的接口文档、流程顺序、上下文定位、子 skill 兼容和实现期冲突问题固化为 v3.1 协议。
• 当前问题：v3 已经确立 OpenSpec-first，但缺少接口影响分级、Draft/Committed OpenSpec gate、devflow 索引和 Phase 3 冲突沟通规则。
• 关联 OpenSpec：openspec/changes/sm-flow-v3-1-upgrade/
• devflow 分档：standard

范围

• 本次要做：更新 sm-flow skill 本体、phase contracts、fallbacks、templates、workflow 说明，并创建/维护 devflow 索引。
• 本次不做：修改业务代码、重写 OpenSpec CLI、把 devflow 变成执行真理源、强制所有接口变更都独立产出接口文档。
• 影响区域：
  • .agents/skills/sm-flow/SKILL.md
  • .agents/skills/sm-flow/references/*.md
  • skill-workbench/docs/sm-flow/workflow.md
  • devflow/index.md

OpenSpec 对齐

• proposal 覆盖状态：已覆盖
• specs 覆盖状态：已覆盖
• tasks 覆盖状态：已覆盖

OpenSpec 输入上下文摘要

• v3 历史决策：devflow/ 是上下文真理源，OpenSpec 是执行真理源，代码是实现结果。
• 用户问题来源：skill-workbench/docs/sm-flow/使用问题.md，共 6 个问题，集中在接口产物、流程顺序、上下文检索、子 skill 兼容和实现期冲突。
• 历史评估来源：devflow/projects/2026-05-19-dev-flow-skill-evaluation/dev-flow-skill-evaluation.md，已确认子 skill fallback、quick 模式、Phase 退出条件和 OpenSpec-first 是 v3 的关键设计。