gjczone/repo-inspect
GitHub: gjczone/repo-inspect
一款让 AI agent 精准检索和理解代码库的工具,通过结构化解析按需返回相关代码,避免将整个仓库塞入上下文。
Stars: 2 | Forks: 0
# repo-inspect
一个用于逆向工程和研究开源项目的 AI agent 技能。只需提问“X 是如何实现的?”,即可获得紧凑、结构化的输出——无需将整个代码库转储到上下文中。
## 安装
```
npx skills add https://github.com/gjczone/repo-inspect --skill repo-inspect
```
也可以通过 Cargo 获取该二进制文件:
```
cargo install repo-inspect
```
## 功能简介
repo-inspect 是一项**技能**,可赋予 AI agent 对任意代码库进行精准访问的能力。无需阅读数千行无关代码,agent 只需提出针对性问题,即可获得完全相关的代码——按相关性排序,并附带行号和上下文。
| 命令 | 何时使用 | 功能描述 |
|---------|-------------|--------------|
| `overview` | 首次打开 repo 时 | 单页项目骨架:语言、结构、关键模块、入口点 |
| `find-how` | “X 是如何实现的?” | 搜索代码库,返回排序后的文件,包含匹配行及 ± 上下文 |
| `trace` | “什么调用了这个函数?” | 追踪调用链——某个符号的调用者和被调用者 |
| `entries` | “执行从哪里开始?” | 检测入口点:CLI 命令、HTTP 路由、事件处理器 |
| `patterns` | “使用了哪些设计模式?” | 启发式检测常见模式 |
| `data` | “存在哪些数据结构?” | 提取类型定义、struct、interface、enum |
| `hotspots` | “哪些文件最常变动?” | 按 git 变更频率对文件进行排序 |
所有输出都会存放在 `.inspect/` 目录下——格式为紧凑的 Markdown(默认)或 JSON。
## 快速示例
```
# 逆向工程分析任何 repo 中的 auth 机制
repo-inspect --repo ./some-project find-how "authentication"
# 无需 cloning 即可研究远程 repo
repo-inspect --repo gjczone/repo-inspect overview
# 追踪函数的 call chain
repo-inspect --repo . trace "handle_request" --depth 3
```
## 远程模式
无需 clone 即可检查任何公开的 GitHub 仓库——只需使用 `owner/repo`:
```
repo-inspect --repo rust-lang/rust find-how "async"
```
通过 GitHub API 获取文件树和原始文件。设置 `GITHUB_TOKEN` 以避免触发速率限制。结果将在本地缓存 24 小时。
## 支持的语言
Rust、Python、TypeScript、Go——通过 tree-sitter 进行结构化解析。所有其他语言通过文本级别的搜索进行工作。
## 致谢
使用 [tree-sitter](https://tree-sitter.github.io/) 构建结构化代码解析。
## 许可证
[MIT](LICENSE)
标签:AI智能体, DNS解析, Homebrew安装, Rust, SOC Prime, 云资产清单, 代码分析, 凭证管理, 可视化界面, 开发工具, 开源项目, 网络流量审计, 逆向工程, 通知系统, 防御加固