SuperAPI AI 工具集

repo-explorer

智能体与模型

查看项目

更新于 10-15 19:50

技能介绍

用途:Repo Explorer 用于探索和分析任意代码仓库,既支持本地路径(如 ~/projects/foo、. 或省略表示当前目录),也支持远程 GitHub/GitLab URL 或 owner/repo 简写。它通过启动独立的 Claude Code CLI 进程(claude -p)以只读工具回答关于仓库的问题。

主要能力:从用户消息中提取仓库来源、问题与模型;远程仓库先克隆到临时目录再分析;使用只读工具(Read、Grep、Glob 及受限 Bash 命令如 find、ls、wc、git log/show/diff/branch、head、tail)探索结构、查找定义与路由、阅读关键文件,并始终引用文件路径和行号,给出基于代码事实的结构化回答。

模型选择:机械式查找(如列出端点、某定义位置、结构清单)用 haiku;需要判断的分析工作(如可借鉴之处、适用性评估、架构评审、方案对比、安全分析)用 sonnet。用户显式指定模型时优先。

使用方式:远程仓库先执行 REPO_DIR=$(mktemp -d) && git clone --depth 1 <url> "$REPO_DIR",指定分支时加 --branch <ref>;随后 cd 到仓库目录运行 CLAUDECODE= claude -p "<question>" --model <haiku|sonnet> --output-format text --max-turns 15 --allowedTools ... --append-system-prompt "..."。CLAUDECODE= 前缀必须紧邻 claude -p,用于允许以子进程方式启动 Claude Code,否则嵌套会话会被阻止。大型仓库或分析型运行可将 --max-turns 提高到 25。远程仓库分析完成后用 rm -rf "$REPO_DIR" 清理临时目录。

适用场景:快速了解陌生仓库结构、定位代码定义、盘点接口与迁移、评估可借鉴的设计与架构、安全分析等。

限制:仅使用只读工具,不修改仓库;远程仓库为浅克隆(--depth 1),仅含最新提交;大型仓库探索可能耗时数分钟,需设置较长超时(如 600000 毫秒);问题中的双引号需转义,含空格的路径需加引号;若输出为空或报错,应报告问题并建议用更具体的问题重试。官方文本未提供,以上依据技能资料整理。