阶段三：验证与归档

这一阶段做什么

前两个阶段完成了设计和实现，但"代码写完了"不等于"做完了"。这一阶段回答两个问题：怎么确认真的做对了，然后把成果正式收尾。

质量门：用证据证明做对了，而不是靠感觉

AI 说"我做完了"，你不能直接信。质量门就是替你把关的验证环节——它会跑检查、看证据、评估风险，然后给出一个明确的结论。

你不需要手动触发质量门，AI 实现完成后会自动调用它。

归档：正式收尾，把知识存下来

归档做三件事：

1. 冻结历史：把这次变更的全部文档（设计、行为、计划）存到 docs/archive/，之后不可修改。
2. 更新当前事实：把仍然有效的设计事实提升到 docs/current/，让后续任务知道系统当前是什么状态。
3. 生成追溯映射：生成 implementation-mapper.md，把需求对应到具体的文件、函数和符号。

做完这一步，才算 OpenFlow 意义上的"完成"。

为什么必须归档？

如果你的实现是在 Git Worktree 隔离环境中进行的，代码变更还在独立分支上，并没有合并到主项目。归档时会自动完成代码合并——跳过归档意味着你的代码不会生效。

操作步骤

你只需要做一件事：

/openflow-archive 添加用户资料页

如果质量门还没通过，归档会被自动驳回，AI 会告诉你哪里还需要处理。修好之后再重新运行归档就行。

归档完成后，你可以在以下位置确认结果：

• docs/archive/{日期}-{需求名}/ — 冻结的历史记录
• docs/archive/{日期}-{需求名}/implementation-mapper.md — 需求到代码的追溯映射
• docs/current/ — 更新后的当前系统事实

到这里，一次完整的 OpenFlow 工作流就结束了。下一次变更会从阶段一重新开始，但 docs/current/ 中沉淀的事实会让起点比上次更高。

返回：使用指南概览 →