git-learn/devflow/projects/2026-05-21-sm-flow-v3-1-upgrade/acceptance.md

SM Flow v3.1 Upgrade Acceptance

结果

已接受。

验证

静态验证

• 命令/检查：openspec status --change "sm-flow-v3-1-upgrade"

• 结果：passed

• 备注：proposal、design、specs、tasks 均为 complete。

• 命令/检查：rg -n "Draft OpenSpec|Committed OpenSpec|Phase 2.9|devflow/index.md|接口影响|实现期冲突|能力契约|平台原生 skill|user-interview" ...

• 结果：passed

• 备注：关键术语已覆盖 .agents/skills/sm-flow/、OpenSpec change、workflow 文档和 devflow 项目档案。

脚本验证

• 命令：openspec instructions apply --change "sm-flow-v3-1-upgrade" --json
• 结果：passed
• 备注：所有 17 个 OpenSpec tasks 已完成。

浏览器/人工验证

• 步骤：不适用，本次是流程文档和 OpenSpec 规则改造。
• 结果：not run
• 备注：无 UI 行为。

已完成范围

• 增加 Draft OpenSpec / Committed OpenSpec / Phase 2.9 commit gate。
• 强化 Phase 2 grill 的显式人工确认约束。
• 增加“单个 grill 决策确认不等于 Phase 3 apply 授权”的硬约束。
• 增加接口影响 L1-L4 分级和接口影响记录模板。
• 增加 devflow/index.md 和 Phase 0.5 / Phase 4 索引维护规则。
• 增加 Phase 3 实现期冲突四分类和 fallback 执行规则。
• 将子 skill 兼容规则改为能力契约优先、路径其次。
• 更新 skill-workbench/docs/sm-flow/workflow.md 的 v3.1 说明。

已知限制

• openspec/config.yaml 由 OpenSpec CLI 创建并保持未跟踪状态。
• 工作区存在与本次无关的已删除文件，未处理。

流程偏差记录

• 偏差：本次执行中，Phase 2 grill 决策确认后曾直接进入执行文件修改，没有显式停在 Phase 2.9 checkpoint 等待 Phase 3 apply 授权。
• 分类：实现偏差。v3.1 规格方向正确，但执行过程没有严格遵守“grill 确认 ≠ apply 授权”的门禁。
• 修正：已回写 OpenSpec，新增 requirement 和 task，要求 Phase 2/2.5 回写后必须停在 Phase 2.9，并等待明确 Phase 3 apply 授权。
• 当前状态：用户已明确授权“执行apply”，该新增 requirement 已应用到 .agents/skills/sm-flow/* 和 workflow 文档。

交接

• 下一步：已归档，后续可从 devflow 档案和 OpenSpec archive 回溯。
• OpenSpec 归档确认：用户已确认归档。
• OpenSpec 归档位置：openspec/changes/archive/2026-05-21-sm-flow-v3-1-upgrade/
• Specs 同步：未执行；本仓库 openspec/specs/ 当前无主 spec 文件，本次保留 delta specs 于 archive 中。