git-learn/devflow/projects/2026-05-22-sm-flow-execution-hardening/brief.md

SM Flow Execution Hardening Brief

背景

• 用户目标：把 sm-flow 在真实项目执行中暴露出的流程失真问题，提炼为下一轮协议硬化需求。
• 当前问题：sm-flow 已经具备完整阶段规则，但实际执行时仍会出现跳过检查点、弱化显式声明、问题池不足、Cross-artifact 一致性检查不充分等情况。
• 关联 OpenSpec：openspec/changes/sm-flow-execution-hardening/
• devflow 分档：complex

范围

• 本次要做：把复盘中的执行问题整理为结构化需求，明确目标、非目标、用户故事、验收口径和建议改进方向。
• 本次不做：立即修改 sm-flow 协议、直接创建 OpenSpec change、重写 sm-flow 主设计。
• 影响区域：
  • .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
  • skill-workbench/docs/sm-flow/retrospective.md

OpenSpec 对齐

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

入口摘要

• 这次需求关注的不是 sm-flow 的理念是否成立，而是它在真实执行中为什么仍然会“按代码习惯行动”，而不是“按 phase gate 行动”。
• 目标是把这些问题固化为更强的执行约束，让后续代理在 micro 或 standard 模式下也不再轻易跳过关键阶段。