关于 explore-repo
explore-repo 是用于按需检查外部 Git 仓库的技能,面向需要实现细节、特定版本行为或历史信息的开发任务。它强调缓存仓库的安全复用、精确版本检查和基于证据的报告。
主要功能
- 01在指定缓存路径复用或克隆仓库
- 02检查仓库状态与远程地址
- 03按需获取分支、标签或提交
- 04使用独立工作树进行实验
- 05报告版本、路径与代码证据
适用场景
- 01查阅依赖的特定版本实现
- 02调查仓库历史或版本差异
- 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、缓存路径、检查的提交,以及相关文件或符号。区分直接观察到的源码内容与推断。