用途:让规格与代码保持同步。规格作为生成代码的契约,代码变更后反过来更新规格。
触发时机:修改实现了 requirements.md 中定义行为的代码;变更 design.md 描述的架构或接口;发现尚未记录的边界情况或模式。
生命周期:生成阶段以规格为契约指导代码;修改阶段由代码更新规格。
同步协议:完成代码变更后,先识别受影响的规格,检查任务的 _writes: 清单,映射到具体需求或设计章节;再更新规格内容,删除过时描述、记录实际实现方式、把发现的边界情况补充为新的验收标准(AC),并保证规格脱离代码仍可读;随后添加可追溯性标记,格式为 <!-- impl: path/to/file.ts#FunctionName -->;最后将规格变更与代码变更放在同一次提交中。
更新对照:新增函数或模块写入 design.md#Components;行为变更更新 requirements.md 中的 AC;边界情况处理以 EARS 格式新增 AC;架构决策在 design.md 记录理由;移除的功能从两份规格中删除。
质量检查:规格描述当前现实而非原始计划;无残留过时章节;新读者仅凭规格即可理解系统;已添加可追溯性链接。
限制:资料未提供安装命令、平台支持、收费方式及具体工具集成细节。