用途:定位 specs 及外部请求头部,提取需求 ID 与标题,并返回可追溯元数据,供下游智能体使用。
主要能力:遍历 ROOT 与 EXTRA_REPOS 中的 specs/ 与 specs/external-requests/(跳过 specs/templates/);用正则 ^#+\s*(REQ-[A-Za-z0-9_-]+)\s*:?\s*(.*)$ 匹配标题;规范化路径为仓库根相对路径,由 ID 加标题生成锚点;对文件内容计算 SHA-256;记录 source_repo、path、hash;按仓库→路径→ID 排序输出 JSON 或 TOON 清单。
变量:ROOT 默认 .;EXTRA_REPOS 默认 [];INCLUDE_EXTERNAL_REQUESTS 默认 true;OUTPUT_FORMAT 默认 json,可选 toon。
使用方式:当其他命令请求 /ai-dev-kit:specs-find 或规范可追溯性时使用;机器流程优先 JSON,需嵌入提示词时用 TOON;保留 ID/标题大小写,锚点小写并连字符。输出结构为 format: spec-manifest/v1,含 generated_at、sources 与 specs 数组。
限制:spec 文件未检测到 ID 时需先确认标题格式再跳过;跨仓库重复 ID 需在 manifest 的 notes 字段标记;缺少 specs/ 目录时报告空结果而非失败。具体实现代码、安装方式及费用暂未提供。