48 lines
2.7 KiB
Markdown
48 lines
2.7 KiB
Markdown
## Why
|
|
|
|
`sm-flow` 已经建立了 `OpenSpec-first / Devflow-assisted` 的主从关系，也补入了 Draft/Committed OpenSpec、接口影响分级、Phase 2.9 和实现期冲突分类等关键规则。但真实项目复盘显示，代理仍然会按“先读代码、先形成方案、尽快推进实现”的习惯行动，而不是稳定经过 phase gate、自检和一致性检查。
|
|
|
|
当前问题不是主设计方向错误，而是执行协议还不够“硬”：
|
|
|
|
- `micro` 模式容易被误解为可以跳过关键阶段。
|
|
- skill/fallback 声明存在规则，但没有成为阶段完成条件。
|
|
- Phase 2 有 one-at-a-time 约束，但没有先形成问题池，导致问题覆盖不足。
|
|
- Phase 1.5 和 2.9 的 cross-artifact 检查缺少更明确的执行清单，遗漏只能等用户 review 才暴露。
|
|
- devflow 产物容易被拖到 Phase 4 补写，而不是在过程内同步更新。
|
|
|
|
因此需要新增一轮“执行硬化”改造，把现有规则收敛成更明确的阶段检查点、问题池机制和一致性检查要求。
|
|
|
|
## What Changes
|
|
|
|
- 为 `sm-flow` 增加更短、更高频的 phase checklist / checkpoint 规则。
|
|
- 明确“未显式声明 skill 或 fallback = 本阶段未完成”。
|
|
- 为 Phase 2 增加“先形成问题池，再一次一问推进”的要求。
|
|
- 强化 Phase 1.5 / 2.9 的 cross-artifact diff 检查，覆盖 proposal、design、specs、tasks、brief、evidence、decisions 的一致性。
|
|
- 明确 `micro` 只能压缩产物，不能跳过 Phase 0.5、Phase 2、Phase 2.9 等关键 gate。
|
|
- 明确 devflow 默认在各阶段同步更新，而不是拖到 Phase 4 统一补写。
|
|
- 明确本次改造不强制固定 checkpoint / alignment 模板，也不把统一阶段汇报格式纳入验收范围。
|
|
|
|
## Capabilities
|
|
|
|
### New Capabilities
|
|
|
|
- `sm-flow-phase-checkpoints`: 定义各阶段的最小检查点和阶段完成条件。
|
|
- `sm-flow-question-pool`: 定义 Phase 2 的问题池生成与单题推进规则。
|
|
- `sm-flow-cross-artifact-alignment`: 定义 Phase 1.5 / 2.9 的跨产物一致性检查要求。
|
|
- `sm-flow-micro-gate-preservation`: 定义 `micro` 模式下不可跳过的关键 gate。
|
|
|
|
### Modified Capabilities
|
|
|
|
- `sm-flow-commit-gate`: 增强提交前检查，补充 cross-artifact diff 和阶段状态显式确认。
|
|
- `sm-flow-context-indexing`: 补充 devflow 过程内同步更新要求。
|
|
|
|
## Impact
|
|
|
|
- 修改 `.agents/skills/sm-flow/SKILL.md`
|
|
- 修改 `.agents/skills/sm-flow/references/phase-contracts.md`
|
|
- 修改 `.agents/skills/sm-flow/references/fallbacks.md`
|
|
- 可能修改 `.agents/skills/sm-flow/references/templates.md`
|
|
- 修改 `skill-workbench/docs/sm-flow/workflow.md`
|
|
- 不修改业务代码
|
|
- 不改变 `OpenSpec-first / Devflow-assisted` 主设计
|