SuperAPI AI 工具集

speckit-opsmill-extract

写作与研究

查看项目

更新于 10-16 03:11

技能介绍

用途:该命令分析一个或多个已完成的 spec 目录,将持久知识提取到项目文档系统(dev/knowledge/、dev/guidelines/、dev/adr/),并把每个 spec 标记为已提取。它把文档生命周期落实为 specs/ → knowledge/ 或 guidelines/。

主要能力:接受空格分隔的多个 spec 标识并顺序处理;解析 spec 目录(支持 specs/NNN-、NNN- 或裸名称匹配);校验 spec.md 是否存在、research.md 是否缺失;检查是否已提取(存在 EXTRACTED.md 或位于 specs/archive/)。随后从 research.md 提取 ADR 候选,从 data-model.md、contracts/、research.md、spec.md 提取知识候选,从实现模式中提取规范性的指南候选,并标注跳过内容及原因。

使用方式:以 $ARGUMENTS 传入 spec 标识;无参数时列出可用 spec 让用户选择。Phase 2 会以表格形式给出提取计划(ADR、知识更新、指南更新、跳过项),等待用户指令:approve all、approve spec <name>、approve adrs/knowledge/guidelines、skip N、edit N、group N,M,未获批准前不写入任何文件。Phase 3 写入 ADR(MADR 命名 nnnn-kebab-case-short-title.md)、更新知识/指南文件并添加来源标记;Phase 4 生成 EXTRACTED.md、将 spec.md 状态设为 Extracted、把 spec 目录移入 specs/archive/,并更新 dev/README.md,最后输出汇总报告。

限制:不批准不写文件;分析无内容时报告 "No extractable content found in this spec.";已有相似内容应提示用户而非重复;不重构知识/指南现有内容;ADR 编号在所有 spec 间顺序递增,文件名四位补零,标题不补零;ADR 来源路径须指向归档位置。分类属性、收费与平台信息暂未提供。