附录 C. 检查清单和模板
本附录可作为项目工作期间快速参考使用。
创建规范前的检查清单
- 功能目标明确；
- 目标受众已知；
- 工作边界已确定；
- 明确哪些内容不在工作范围内；
- 技术栈限制已知；
- 至少有一个可验证的结果；
- 明确正在实现路线图中的哪个阶段；
- 不需要本地环境中没有的秘密或访问权限。
实现前的检查清单
requirements.md已创建；plan.md已创建；validation.md已创建；- 规范已提交；
- 向智能体提供的是文件链接，而非冗长的聊天记录；
- 当前分支是干净的或状态明确；
- 功能边界与
tech-stack.md不冲突； - 计划中没有不相关的重构。
发起合并请求前的检查清单
- 所有修改的文件都与功能相关；
validation.md中的必填验证项已检查；- 失败的验证项已明确列出；
- 延迟的验证项有原因说明；
- 新的 hooks 和 MCP 服务器已审查；
- 秘密未泄露到规范、日志和记忆中；
- 如果项目维护
CHANGELOG.md，则已更新； - 路线图已更新，或有理由不在此分支中更新。
合并请求模板
## 规范
- 文件夹：`specs/YYYY-MM-DD-feature-name/`
- 路线图阶段：
## 变更内容
-
## 验证事实
- [ ] `npm run typecheck`
- [ ] `npm test`
- [ ]
## 未验证或延迟的事实
-
## 功能边界外的变更
- 无 / 列举：
## 审查者需要特别注意检查的内容
- 回顾模板
# SDD 回顾
## 规范描述正确的部分
## 智能体需要自行推断的部分
## 验证发现的问题
## 哪些验证事实不够充分
## 需要转移到 QWEN.md 或 specs/ 的内容
## 需要从流程中移除的内容/clear 后新会话的检查清单
- 智能体已阅读
QWEN.md或AGENTS.md； - 智能体已阅读
mission.md； - 智能体已阅读
tech-stack.md； - 智能体已阅读所需的功能文件夹；
- 智能体知道哪些文件不能修改；
- 智能体知道预期的检查命令；
- 如果任务仅为研究性质，智能体在报告后会停止。
实现审查的最小请求模板
/clear
阅读 @QWEN.md、当前功能的规范和 git diff。
将实现与 requirements.md、plan.md 和 validation.md 进行比较。
展示：
- 一致之处；
- 不一致之处；
- 未验证的事实；
- 功能边界外的变更。
不要修改文件。重新规划的最小请求模板
/clear
阅读 @specs/mission.md、@specs/tech-stack.md、@specs/roadmap.md、
最近的功能规范和 @CHANGELOG.md。
展示在进入下一阶段前需要更新的内容。
在我批准之前不要修改文件。