SuperAPI AI 工具集

openspec-archiving

部署与运维

查看项目

更新于 10-15 21:46

技能介绍

用途:在变更完成后归档变更文件夹,并将其规范增量合并进长期 living spec 文档。归档代表变更已部署并完成,因此必须先确认所有任务完成且已测试、已部署,再执行归档。

主要能力:提供归档工作流,包括校验实现完成、审阅待合并的 spec delta、创建带时间戳的归档目录、按 ADDED/MODIFIED/REMOVED 操作合并需求、移动变更文件夹到归档、校验 living spec 结构。合并规则:ADDED 追加到 living spec 末尾;MODIFIED 按需求名定位并整体替换(含全部场景);REMOVED 删除整个需求块并可用注释记录移除原因与日期。

使用方式:按清单逐步操作。先检查 spec/changes/{change-id}/IMPLEMENTED 标记、查看 tasks.md 和 git status,并向用户确认是否全部完成、是否已部署、是否继续。随后列出 spec/changes/{change-id}/specs 下的 delta 文件并阅读。创建目录如 mkdir -p spec/archive/2025-10-26-add-user-auth。合并后移动文件夹:mv spec/changes/{change-id} spec/archive/${TIMESTAMP}-{change-id}。最后用 grep 校验 ### Requirement: 与 #### Scenario: 结构,并建议先提交合并后的 spec 再归档。

适用场景:已完成并部署的变更提案归档、规范增量并入 living spec、需求新增/修改/移除的规范维护。

限制与注意:归档目录应视为只读历史,禁止修改;不要归档未完成的实现;不要在部署前合并 delta;不要跳过合并后校验;不要忘记提交合并后的 spec;冲突时需人工合并,若多个变更修改同一需求,需手动处理。回滚需逆向操作。具体实现细节以 reference/MERGE_LOGIC.md 为准。未提供收费标准、平台与价格信息。