SuperAPI AI 工具集

explore-codebase

通用与其它

查看项目

更新于 10-15 21:12

技能介绍

用途:explore-codebase 是一个代码库探索技能,接收用户查询($ARGUMENTS),在代码库中找出与查询相关的文件,输出概览和按优先级排列的文件清单(含行号范围),使后续工作无需再次搜索即可掌握该主题。

主要能力:先判定彻底程度(quick、medium、thorough、very-thorough),依据自然语言触发词或查询范围自动选择;冲突时取最高级别。quick 不建研究文件、不做待办,仅 1-2 次 Glob/Grep 搜索;medium 建研究文件、3-5 项待办,覆盖核心实现、一级导入导出及最多 3 个调用方;thorough 追踪全部导入、直接调用方、测试与配置;very-thorough 无界探索最多 100 个文件,超出时按依赖中心性排序并注明剩余数量。支持作用域边界:若提示含“YOUR ASSIGNED SCOPE:”与“DO NOT EXPLORE:”,则限定在指定范围内,越界发现记录为 Out-of-scope discoveries。

使用方式:按“判定彻底程度 → 搜索 → 扩展待办 → 写入发现 → 重复 → 压缩输出”的循环执行。研究文件路径为 /tmp/explore-{topic-kebab-case}-{YYYYMMDD-HHMMSS}.md,若 /tmp 写入失败则改用当前工作目录,重名时追加 -2、-3。时间戳通过 Bash 的 date +%Y%m%d-%H%M%S 获取。最终输出包含 OVERVIEW、FILES TO READ(MUST READ、SHOULD READ、REFERENCE)以及可选的 OUT OF SCOPE。生成输出前必须完整读取研究文件以刷新上下文。

适用场景:单实体查找、单一子系统问题、跨子系统交互查询、架构梳理、安全审计、新人上手等。

限制:只做探索与结构化描述,不输出诊断、建议、评价或修复方案;仅覆盖与查询相关的文件,不做全库导览;quick 模式不建研究文件与待办;medium 不包含测试与配置;very-thorough 上限 100 个文件。资料未提供收费、价格、平台支持等信息。