Files

2.7 KiB

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 主设计