SuperAPI AI 工具集

close-spec

通用与其它

查看项目

更新于 10-15 21:36

技能介绍

用途:当一个 specs/<feature>/ 下的规格已完成交付(write-spec 构建或任何产出规格的计划任务)后,close-spec 负责将其归档到 specs/done/ 并重写为记录文档。规格在构建时是计划,交付后应变成“理由记录”:代码是“怎么做”的唯一事实来源,关闭后的规格是“为什么”的事实来源,并作为进入代码的地图。

主要能力:确认已交付(功能已合并或在树内可用,测试/截图门禁通过);对照现实差异(阅读规格 README 与切片,再读实际落地的代码,记录被丢弃的切片、重命名的接缝、不同的机制、被打破的假设);移动文件(specs/<feature>/ → specs/done/<feature>/,使用 git mv;单文件规格 specs/<feature>.md → specs/done/<feature>.md);把 README 重写为记录而非计划,保留概述与目的(现在时)、理由(为何如此而非显而易见的替代方案)、原则与不变量、指向代码的指针(可 grep 的模块/类型/函数名、文件路径、固定行为的测试)、死胡同(尝试并拒绝的方案及原因)、视觉来源(作为基线、对比目标或灵感上传的图片,说明来源与驱动作用);删除逐切片构建顺序、“接下来将……”、脚手架说明、逐切片验证清单和复述代码的散文;折叠切片,保留图像;修复指向旧路径的引用;用未参与写作、不了解对话的子代理逐条对照代码与测试审计,按指针、不变量/原则、概述/理由、视觉来源给出判定,未验证的陈述视为缺陷,修复后重新审计。

使用方式:按上述工作流执行,命令保持原样,如 git mv。

适用场景:已完成交付、需要把构建计划转为长期理由记录的规格文档。

限制:资料未提供安装方式、平台、收费或价格信息;仅适用于已交付且门禁通过的规格,未验证切片完成前不应关闭。