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, 云资产清单, 代码分析, 凭证管理, 可视化界面, 开发工具, 开源项目, 网络流量审计, 逆向工程, 通知系统, 防御加固