gh-excavate：用 GitHub Copilot 挖掘代码
Source: Dev.to
我构建的
在凌晨 2 点卡在一个未知的仓库里？
不小心删除了生产代码，想弄清它到底做了什么？
继承了一个没有任何文档的代码库？
我们都经历过。
我构建了 gh‑excavate —— 一个基于 AI 的 GitHub CLI 扩展，专为代码考古设计。它是一个 终端原生助手，帮助你理解代码的功能以及它存在的原因。
与其手动浏览提交、扫描文件并拼凑上下文，你只需运行一个命令，gh‑excavate 就会为你挖掘整个仓库。
功能
- 分析仓库或文件夹，解释其目的、架构和风险
- 追踪文件从创建到删除的整个生命周期
- 检测可能的死代码或被遗忘的代码
- 帮助调查“这段代码为什么会存在？”的时刻
- 支持本地路径和远程 GitHub 仓库
CLI 负责结构，Git 负责历史，GitHub Copilot 是整个操作的大脑和灵魂——它是推理引擎，能够综合上下文、解释意图，并将原始代码和 Git 历史转化为 直接在终端中的人类水平解释。
gh‑excavate 不仅仅是读取代码，它在解释代码。
演示
Repository: gh‑excavate
gh‑excavate 是一个 GitHub CLI 扩展。安装后，它直接在终端中运行。
安装
验证
命令
示例运行
My Experience with GitHub Copilot CLI
GitHub Copilot CLI 从根本上改变了我构建此项目的方式。与仅依赖脆弱的启发式规则和繁重的解析逻辑不同，我专注于设计有意义的提示、从 Git 历史中提取正确的上下文，并智能地组织 CLI —— 而 Copilot 负责更深层的推理。
Copilot 成为了：
- 解释引擎
- 架构分析师
- 技术史官
- 上下文合成器
gh‑excavate gathers the evidence — 提交日志、文件历史、结构化上下文。Copilot CLI connects the dots。
在开发过程中最重要的领悟是：真正的问题不是获取代码，而是理解意图。Git 告诉你改了什么，Copilot 帮助推理为什么。
在终端中直接使用 Copilot 的体验自然且贴合开发者。我可以验证 Git 命令、推理文件删除等边缘情况，并在不离开 CLI 的情况下优化工作流。
这个项目不仅仅是自动化，更是对开发者认知的增强。当你在代码库中迷失时，你需要的不是自动补全，而是理解。代码会老化，上下文会消逝。gh‑excavate helps bring it back。
当 git log 变得晦涩，生产环境燃起火焰时——进行挖掘。因为“谁写的？”并不是一种策略。