31 lines
1.6 KiB
Markdown
31 lines
1.6 KiB
Markdown
# 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 的关键设计。
|