SuperAPI AI 工具集

feature-discovery

编程与开发

查看项目

更新于 10-15 21:08

技能介绍

用途:追踪现有功能、模块或行为的工作方式,并在对话中输出带证据引用的报告,让另一位工程师了解它是什么、如何工作、在哪里被使用、还有哪些不确定之处。输入可为结构化(Projects Affected 加 What 块)或自由文本,仅在有阻塞性疑问时提问;用户不在时说明假设并尽力继续。

主要能力:解析并定位项目与 git 根;追踪当前代码(先精确词,再别名、路由、组件、配置键、环境变量、表、任务、标志和测试,优先 rg);读取相关 ADR 并记录状态;按需有界读取 issue;跟踪候选术语并与 GLOSSARY.md 比对;双重验证(交叉核对代码、测试、配置,并用别名和反向查找寻找矛盾路径);最后按编号结构输出报告并停止。

使用方式:默认静态检查,只读、仅对话。不编辑代码、配置、文档、原生记忆、ADR、提示、issue 或生成产物;不创建 docs/discovery/ 文件;不执行 git fetch、git pull、安装、迁移或破坏性命令。仅在确认不会改变文件或本地/外部状态后才执行项目或测试命令,否则报告未运行的检查而非通过。git 历史默认不读,仅在报告第 8 节提出扫描建议、用户明确同意后才只读扫描。

适用场景:需要理解既有功能实现、跨项目追踪调用方与下游影响、核对代码与 ADR 是否一致、识别证据缺口时。

限制:当前代码是事实来源,证据顺序为当前代码、测试、配置,再到 ADR;mock、fixture 或桩数据路径不算已实现行为;需区分证据与推断,不编造理由。范围保持精简,过宽输入要拆分。报告后停止,不自动调用下一技能或开始实现。输出用 file:line 或文件加符号引用,跨项目报告需用项目代码限定路径。

分类:该技能用于代码库功能追踪与理解,属于编程与开发。