SuperAPI AI 工具集

spec-driven-implementation

编程与开发

查看项目

更新于 10-16 07:21

技能介绍

用途:为 Warp 中较重要的功能提供“先写规格、再实现”的工作流,借助书面规格提升实现质量、减少歧义并便于评审。资料说明并非所有改动都需要规格,应务实判断。

规格位置:通常放在 specs/<linear-ticket-number>/PRODUCT.md 与 specs/<linear-ticket-number>/TECH.md,例如 specs/APP-1234/PRODUCT.md、specs/APP-1234/TECH.md。specs/ 下只允许以工单号命名的目录直接作为子目录,不要创建工程师命名或功能 slug 的目录。若相关 Linear issue 不存在,需先创建,可使用 Linear MCP 工具:list_teams、list_issue_labels、save_issue;团队或标签不明确时用 ask_user_question 澄清。规格主要由智能体撰写并纳入源码控制。

需要规格的场景:产品/架构存在歧义、预计实现规模约 1k+ LOC、深度或跨栈改动、回归代价高的风险行为变更、更清晰输入能显著提升智能体质量时。通常不需要:小型局部修复、直接重构、歧义很小的界面微调。纯 UI 变更往往只需产品规格。

工作流:先判断是否需要规格;再写产品规格,用 write-product-spec 技能产出 PRODUCT.md,描述要解决的问题、期望用户体验、不变量与边界情况、成功标准、验证方式;有 UI 或交互设计时询问是否有 Figma 稿,没有也继续但需在规格中说明。必要时用 write-tech-spec 写技术规格,适用于跨多个子系统、架构或可扩展性重要、存在需要记录的权衡、评审者更受益于看计划等情形;也允许在端到端原型后再写。规格获批后用 implement-specs 技能实现,规格与代码可放在同一 PR。大型功能可选提供 PROJECT_LOG.md 与 DECISIONS.md,但非必需。实现中若偏离规格应更新规格;产品行为、成功标准、UX 细节或边界变化时更新 PRODUCT.md,实现方式、架构边界、风险依赖或验证计划变化时更新 TECH.md。完成后需按规格验证,优先单元与回归测试、关键流程集成测试,必要时用 loom 演示、截图或视频。引用代码块时尽量附上已检查的提交 SHA,并链接到精确的 GitHub blob/<sha>/...#Lx-Ly 行。评审时间应用于验证规格与行为,而非过度纠结代码风格。相关技能:implement-specs、write-product-spec、write-tech-spec。