SuperAPI AI 工具集

openspec-archive-change

编程与开发

查看项目

更新于 10-16 09:52

技能介绍

用途:在实验性工作流中归档已完成的变更,适合实现完成后需要收尾并归档的场景。

主要能力与步骤:若未提供变更名,先运行 openspec list --json 获取可用变更,仅展示未归档的活跃变更,并尽量附带其使用的 schema,由用户选择,不猜测或自动选择。随后运行 openspec status --change "<name>" --json 检查产物完成情况,解析 schemaName 与 artifacts 状态;若存在未完成产物,列出警告并请求用户确认是否继续。再读取任务文件(通常为 tasks.md),统计 - [ ] 与 - [x] 数量;若有未完成任务,显示数量警告并请求确认;无任务文件则跳过该警告。之后检查 openspec/changes/<name>/specs/ 下的增量规格,与 openspec/specs/<capability>/spec.md 主规格比较,汇总将应用的增删改重命名,并提示同步选项;选择同步时执行 openspec-sync-specs 技能逻辑,无论选择如何都继续归档。

归档执行:mkdir -p openspec/changes/archive 创建归档目录,按 YYYY-MM-DD-<change-name> 生成目标名;若目标已存在则报错并建议重命名或换日期,否则用 mv openspec/changes/<name> openspec/changes/archive/YYYY-MM-DD-<name> 移动。最后输出归档摘要,含变更名、schema、归档位置、规格是否同步及警告说明。

限制:不猜测或自动选择变更,必须由用户选择;警告不阻断归档,仅提示并确认;移动目录时保留 .openspec.yaml。资料未提供安装命令、收费与平台信息。