用途:在 PRODUCT.md 与 TECH.md 获批后实现已批准的功能,并在实现过程中让已提交的规格与代码保持一致。规格应放在 specs/ 下以工单命名的目录中,例如 specs/APP-1234/PRODUCT.md 与 specs/APP-1234/TECH.md。
前提:确认 PRODUCT.md 存在;若功能需要,确认 TECH.md 存在;确认相关规格已评审并获批到可以开始实现。
工作流:先阅读已批准的规格,把 PRODUCT.md 视为用户可见行为的唯一事实来源,把 TECH.md 视为架构、顺序与实现形态的唯一事实来源,理解预期行为、约束、风险与验证计划后再写代码。对大型或长期功能,可在实现前可选提供 PROJECT_LOG.md(记录检查点、探索路径、部分发现与当前实现状态)或 DECISIONS.md(记录 PRD 与技术设计过程中的具体决策),二者是可选辅助而非必需交付物。随后把工作拆成具体实现步骤,按规格实现,保持行为与 PRODUCT.md 一致、架构与顺序与 TECH.md 一致,并随工作落地添加或更新测试与验证产物;条件允许时把规格与实现放在同一 PR 中。若实现揭示预期行为或设计需要变更,应更新已提交的规格而非任其过时:用户可见行为、UX、边界情况或成功标准变化时更新 PRODUCT.md;架构、顺序、模块边界或验证策略变化时更新 TECH.md,并把这些更新与对应代码放在同一 PR。完成前验证代码与当前规格一致,优先采用符合仓库本地测试约定的单元测试与回归覆盖,以及重要用户流程的集成或端到端测试。
最佳实践:实现全程保持规格与代码同步;决策变化时立即更新规格而非最后批量清理;仅在复杂功能确有价值时使用可选跟踪文档;保持同一 PR 连贯,规格更新、代码变更、测试与可选跟踪文档都服务于同一功能叙事。相关技能:spec-driven-implementation、write-product-spec、write-tech-spec。