mcpField
E
explore-repo

explore-repo

github.com/sjunepark开发162 次安装4 周前更新
代码仓库

关于 explore-repo

explore-repo 是用于按需检查外部 Git 仓库的技能,面向需要实现细节、特定版本行为或历史信息的开发任务。它强调缓存仓库的安全复用、精确版本检查和基于证据的报告。

主要功能

  1. 01在指定缓存路径复用或克隆仓库
  2. 02检查仓库状态与远程地址
  3. 03按需获取分支、标签或提交
  4. 04使用独立工作树进行实验
  5. 05报告版本、路径与代码证据

适用场景

  1. 01查阅依赖的特定版本实现
  2. 02调查仓库历史或版本差异
  3. 03在隔离工作树中构建或测试

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/sjunepark/agent-scripts --skill explore-repo

安装后在 Claude Code 中输入/explore-repo确认已加载。

附带文件agents/openai.yaml

详细介绍

探索代码仓库

需要了解实现细节、特定版本的行为或历史记录时,请使用外部源码;如果已安装的源码或一手文档能够回答问题,则优先使用它们。需要 Git 和对目标代码仓库的访问权限。

缓存与引用

使用 ~/.repos/<host>/<owner-or-group>/<repo>,并去掉末尾的 .git。 除非用户要求,否则不要克隆到当前项目、受版本控制的工作树或 .tmp/。不要添加忽略规则来隐藏外部克隆,也不要将缓存的代码仓库作为依赖接入项目。

重新使用克隆前,请检查其状态和远程身份:

git -C <cache-path> status --short --branch
git -C <cache-path> remote -v

如果克隆中有未提交的更改,请只读检查,或使用隔离的工作树;未经明确授权,不要重置、清理、拉取、切换分支或覆盖它。需要获取最新引用时,请使用 git -C <cache-path> fetch --prune --tags 更新干净的克隆。新克隆时,优先使用 git clone --filter=blob:none <url> <cache-path>。只有在不需要历史记录和较早引用时才使用 --depth=1。

获取并检查指定的分支、标签、提交、发行版或依赖版本。必要时,根据本地证据解析出更精确的引用,并使用 git -C <cache-path> rev-parse HEAD 记录实际提交。

检查与实验

有针对性地搜索并读取文件和历史记录。适合时,可委派独立探索;常规扫描应选择快速、低推理配置,复杂逻辑或架构则选择能力更强的配置。要求提供简洁的发现,包括路径、引用和支持证据。

默认情况下,缓存的克隆应保持只读。对于构建、编辑、生成文件或有风险的检出操作,请在 ~/.repos/.worktrees/ 下创建隔离的工作树:

git -C <cache-path> worktree add --detach <worktree-path> <ref>

仅移除为本任务创建且已不再需要的工作树。保留缓存的克隆;只有在用户要求清理时才删除它们,并且应先检查具体候选项及其状态、大小和存放时长。

回答时请报告远程 URL、缓存路径、检查的提交,以及相关文件或符号。区分直接观察到的源码内容与推断。

评论

支持 Markdown