SuperAPI AI 工具集

code-concept-search-v2

通用与其它

查看项目

更新于 10-16 06:19

技能介绍

用途:在代码库中查找一个概念(模式、能力、组件、方法),即使代码命名与预期完全不同,也能定位并返回带来源的事实性结果,帮助调用方判断是否复用。

主要能力:V2 优先扫描 docs/domains/*/domain.md 的 § Concepts 表作为 Tier 0,实现近乎即时的发现;随后按层级回退到 FlowSpace 语义搜索、FlowSpace 文本与树搜索、无 FlowSpace 时的代码库人工式走查,最后才用定向 grep。结果带来源信息,可追溯创建计划、修改历史、存在原因、原始意图与当前消费者。

使用方式:命令为 /code-concept-search-v2 "<concept>"。必填位置参数为要查找的概念;可选参数包括 --scope <path> 限定路径、--exclude <pattern> 排除路径、--limit <N> 限制结果数(默认 5)、--provenance 包含完整计划来源(默认开启)、--no-provenance 跳过来源查询、--skip-domains 跳过 Tier 0 领域扫描。示例:/code-concept-search-v2 "rate limiter"、/code-concept-search-v2 "connectNode" --scope "src/graph/"。

适用场景:在编写新功能前做防重复检查,确认代码库中是否已有可复用实现;需要了解某段代码由哪个计划创建、为何存在、原始设计意图时;在命名不直观的代码库中定位概念。

限制:依赖代码库中是否存在 docs/domains 领域文档与 FlowSpace 工具,缺失时回退到人工式走查,速度较慢;语义搜索仅在 FlowSpace 语义模式可用时启用;结果默认上限 5 条;来源追溯依赖 docs/plans 执行日志与 git 历史,缺失时可能标记为 Unknown。未找到时会明确报告已尝试的层级、目录与 grep 模式,并给出可安全新建的评估。