# 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 的关键设计。