用途:为非常规功能开发提供一套标准化流程,从规划、执行到交付后审查都有明确产物。
主要能力:先阅读相关文件并思考问题,把计划写入 specs/[timestamp]-[feature-name].md,时间戳格式为 YYYYMMDDThhmmss,功能名用 kebab case。规格首屏要实用,包含状态、负责人、一句话说明、当前形态、目标形态和证明。计划中要含可勾选的实现任务清单。执行时以小的检查点自主推进,仅在存在竞争性产品或架构选择、需求未定、破坏性操作或范围风险较大时暂停征求用户输入。对于有多种可行方案、涉及 3 个以上文件或架构变动的非平凡改动,先给出带前后差异和 ASCII 图的备选方案,参见 change-proposal。随进度勾选清单项,进度记录保持高层级:已改、已验证、剩余、受阻。任务和代码改动尽量小,避免无关清理和大范围重构。交付前对涉及文件运行 post-implementation-review,用于发现过时抽象、死路径、不变量漂移、命名问题和缺失验证。最后在规格中增加审查章节,汇总改动、审查发现、验证和相关后续工作。
使用方式:当需要以带时间戳的规划规格启动非常规功能、在写代码前建立清单驱动计划、以小检查点执行并只在高风险处暂停、交付前做实现后审查、并在规格中补充审查总结时使用。
限制与约定:所有规格放在根目录 /specs/,不要在 apps/ 或 packages/ 下创建嵌套规格。主题需要时允许大规格,不按行数拆分;仅当一个文件混合了读者任务(北极星架构、历史争论、实现日志、交接提示、当前执行路径)时才拆分、增加活动切片或创建配套执行规格。提示和交接产物可放在规格旁,使用 .prompt.md、.handoff.md、.execute.md 等后缀,并应链接回规范规格;除非后缀表明,否则不应视为当前实现计划。