SuperAPI AI 工具集

spec-driven-archive

通用与其它

查看项目

更新于 10-16 06:22

技能介绍

用途:帮助用户归档一个已完成的 spec-driven 变更。前置条件是项目根目录存在 .spec-driven/ 目录,可用 ls .spec-driven/ 验证;若失败说明项目未初始化,需先运行 /spec-driven-init。

主要步骤:先运行 node {{SKILL_DIR}}/scripts/spec-driven.js modify 列出活动变更并确认要归档的名称;再运行 node {{SKILL_DIR}}/scripts/spec-driven.js apply <name> 检查未完成任务,若剩余任务大于 0 则停止归档,列出未完成任务并建议 /spec-driven-apply <name> 或 /spec-driven-cancel <name>。

合并 delta specs:列出 .spec-driven/changes/<name>/specs/ 下所有文件;若为空,需用户明确确认该变更无可观察的 spec 影响。对每个 delta 文件合并到对应主 spec 文件:ADDED 追加 ### Requirement: 块(目标文件不存在则创建);MODIFIED 按名称定位并原地替换;REMOVED 按名称删除,文件变空则删除文件。合并后简要总结 specs/ 的变化,并更新 .spec-driven/specs/INDEX.md:新增文件加一行描述,删除文件移除条目,其余条目除非范围变化否则保持不变。

归档:运行 node {{SKILL_DIR}}/scripts/spec-driven.js archive <name>,将整个变更目录(含 questions.md)移入归档,并报告移动位置(如 .spec-driven/changes/archive/2024-01-15-<name>/),如有后续工作建议运行 /spec-driven-propose。

限制与规则:归档前必须检查未完成任务,绝不允许归档含未完成任务的变更;合并 delta specs 是硬性门槛,不可跳过;specs/ 为空时必须人工确认;不要手动删除变更目录,必须用 archive 命令归档。