SuperAPI AI 工具集

archive

编程与开发

查看项目

更新于 11-01 13:28

技能介绍

用途 archive 是一个面向规格驱动开发流程的收尾技能,扮演“规格归档员”角色。当某个规格(spec)的实现完成后,它把该规格的意图与架构浓缩成一条扁平记录,保存到 .start/archive/ 下,然后移除对应的工作规格目录。规格目录从 .start/specs/ 消失,即代表该工作“已完成”。

主要能力

  1. 解析目标规格:通过 specify-meta 技能读取 $ARGUMENTS 指定的规格,获取目录路径、[NNN]-[name] 形式的文件名主干,以及 prd/sdd 路径(旧版规格则为 requirements.md 与 solution.md)。若规格不存在则报错停止;若既无需求也无方案,则询问用户是否仍要删除目录。
  2. 读取并提炼意图:从需求部分提取“这是什么功能、为何存在”,从方案部分提取组件、架构关系、架构图及关键模块/文件位置,要求改写为高层要点,而非逐字照搬。
  3. 识别实现提交:在 git 仓库中按规格 ID 与名称搜索历史,找到实现或合并该功能的提交,记录为“短 SHA — 提交主题”;无法确定时记录为 unknown,不虚构 SHA。多个候选时询问用户。
  4. 检查取代关系:扫描 .start/archive/ 中既有记录,判断当前规格是否影响或取代它们,被取代的记录需双向交叉链接。不确定时应询问用户。
  5. 写入归档记录:创建 .start/archive/[NNN]-[name].md,内容包含 Commit、可选的 Supersedes、What this is、Architecture、Implementation 四类信息,无 frontmatter,保持精简。
  6. 删除工作目录:确认归档记录存在且非空后,记录归档事件,把规格的事件日志移到归档记录旁,再一次性删除整个 .start/specs/[NNN]-[name]/ 目录(连同 spec.md、review.md、.tracker/ 及旧版规格的 plan/、units/、scenarios/、manifest.md、README.md 等脚手架)。

使用方式 以技能形式调用,参数为要归档的规格($ARGUMENTS)。执行顺序为:解析 → 读取意图 → 识别提交 → 检查取代 → 写记录 → 删除目录 → 报告。记录须由技能自身直接写入,不派生子代理。归档不要求 git、不要求测试通过或 100% 完成,只如实记录已完成的内容。

适用场景 适用于规格驱动开发流程中已完成规格的收尾与知识留存,特别适合希望以“目录消失”作为完成信号、并把历史规格压缩为单文件归档的团队。

限制 不包含用户故事、Gherkin、EARS、验收标准或决策日志;不逐字重述需求或方案;不添加仪式性内容、叙述或状态字段;不得在归档确认写入前删除源目录;无明确提交时不得编造 SHA。未在资料中提及的功能、收费、平台或效果暂未提供。