SuperAPI AI 工具集

spec-discovery

通用与其它

查看项目

更新于 10-15 21:35

技能介绍

用途:在从想法/需求/头脑风暴产出编写新 Feature Spec 之前,先做预规格全景调研,判断该想法是否真的需要新建独立规格,还是应扩展现有规格。

主要能力:扫描 docs/specs/** 下的候选规格,只读 §1 概览、§4 业务规则头、§5 领域模型、§8 测试用例摘要,将每个规格分类为 EXTENDS、OVERLAPS、DEPENDS-ON、AFFECTED 或 UNRELATED;通过 $scout 与代码图发现相关代码逻辑,并用 §8 [Source:] 锚点把代码桥接到规格;分析缺失功能、缺失测试用例/用户故事、系统未知项,以及新规格必须遵守的 [HARD] 规则与 §5 不变量;增量写入 plans/{plan-dir}/research/spec-discovery-{slug}.md;最后在阻塞式用户确认门中推荐 NEW / EXTEND X / SPLIT,并交接给 domain-analysis 与 spec [mode=draft]。

使用方式:按步骤 0→6 顺序执行,先框定关键词、实体与目标规格桶;声明并行发现波次;规格扫描与代码发现可并行,但代码图扩展、缺口与不变量汇总、范围决策门、交接必须串行。存在 .code-graph/graph.db 时必须运行代码图命令,例如 python .claude/scripts/code_graph trace <key-entity-or-command> --direction both --json 与 python .claude/scripts/code_graph connections <key-file> --json。

适用场景:准备编写新规格前、需要判断是否与现有规格重复、需要了解不变量约束时。不适用于编写规格本身、深度根因分析、生成测试用例或重建规格索引。

限制:该技能在主代理内联执行,范围决策门必须直接询问用户,不能自动选择 NEW;不得跳过、重排或合并步骤;若环境缺少必要工具或步骤无法运行,应停止并询问用户;资料未提供具体收费、平台与效果信息。