SuperAPI AI 工具集

spec-driven-modify

编程与开发

查看项目

更新于 10-15 23:48

技能介绍

用途:修改已有的 spec-driven 变更产物,包括 proposal.md、specs/ 增量文件、design.md、tasks.md 和 questions.md,同时保留已完成任务的状态。

前提:项目根目录必须存在 .spec-driven/ 目录,可用 ls .spec-driven/ 验证;若失败说明项目未初始化,需先运行 /spec-driven-init。

使用方式:先运行 node {{SKILL_DIR}}/scripts/spec-driven.js modify 列出活动变更,并询问用户要修改哪个变更;再询问具体修改内容,关注变更内容而非要编辑哪些文件。随后判断受影响的产物:proposal.md 对应范围、目标或需求变化;specs/ 对应可观察行为变化的增量规格,按文件路径镜像 .spec-driven/specs/;design.md 对应实现方式或架构决策;tasks.md 对应任务拆分、增删;questions.md 对应新问题或已解决问题。编辑前需读取所有相关产物文件;若涉及 specs/,还需读取 .spec-driven/config.yaml、.spec-driven/specs/INDEX.md 及各相关主规格文件。

修改规则:proposal.md 和 design.md 可自由编辑;specs/ 需保留增量规格格式,保持 changes/<name>/specs/ 下匹配的文件路径,按需使用 ## ADDED Requirements、## MODIFIED Requirements、## REMOVED Requirements 标记,并保留 ### Requirement: 标题,只写可观察行为,不写成实现说明、架构细节或 API 设计文档;tasks.md 需保留所有 - [x] 已完成任务状态,除非用户明确要求,否则只增删或改写 - [ ] 未完成任务;questions.md 可在 ## Open 下添加新问题,或在人工给出答案后将问题移至 ## Resolved 并附 A: 答案行。

最后展示摘要,简要说明所有修改文件的变化并与用户确认。规则:除非用户明确要求,否则不得取消已完成任务;能定向编辑时不要整体重构文件;除非明确以改结构为目标,否则保持相同标题结构;一次变更请求可能跨多个文件,应一起编辑所有相关产物;编辑 specs/ 时遵循 .spec-driven/config.yaml 规则,并保持每个增量文件与对应主规格文件一致。