AI编程代理最常问的5个问题如何用ripwire一次调用找到正确代码【免费下载链接】ripwireThe ripgrep of AI context: a zero-dependency C23 CLI MCP server for coding agents. Find what you want without reading the repo, then check you built what you meant — blast radius, tests-to-run, quality deltas. Signatures at 74.7% fewer bytes than bodies; every guess labelled, every loss published. Paddle out with a map.项目地址: https://gitcode.com/gh_mirrors/ri/ripwireripwire是一款零依赖的 C23 CLI 工具与 MCP 服务器被称为AI 编程代理界的 ripgrep。它不依赖大模型、不需要 API key本地索引整个代码仓库后用一次调用回答代理最常问的 5 个问题这个项目是干嘛的、X 功能在哪实现、谁调用了这个函数、改它安全吗、该跑哪些测试——答案带符号级定位比整文件阅读省数倍到数百倍的 token。上图--html输出的一张调用关系图120 个符号、183 条调用边颜色代表复杂度——每个节点都是可以直接--expand的代码符号。为什么代理需要先拿地图再读代码 ️AI 编程代理面对陌生仓库时的默认动作是grep关键词 → 逐个打开文件 → 再 grep → 再读……每一轮都在烧 token而且grep分不清调用和注释里提了一嘴。ripwire 的目标叫terminality一次答全问一个问题答案就带齐所需的一切——符号定位、签名、影响范围不需要追问三次 grep。它的诚实原则同样出名数不出总数就标注下限0 表示没找到而不是不存在。支持语言Rust、C、Python、Go、Swift、TypeScript、JavaScript、Java、Ruby、PHP、Lua、Elixir、Kotlin、C#、Bash、GDScript、YAML、Markdown 等 20 种源码实现见 src/架构文档见 docs/ARCHITECTURE.md。一键安装3 行命令接入你的代理安装会同时给机器上的 Claude Code、Codex、Cursor、Gemini、opencode、aider 等代理装上技能教会它们何时调用 ripwiregit clone https://gitcode.com/gh_mirrors/ri/ripwire cd ripwire ./install.sh之后每个编码会话开头说一句Use ripwire on this repo即可。全部安装方式预构建二进制、源码编译、按代理装技能、可选 MCP 服务器见 INSTALL.md。问题 1这个仓库是干嘛的——用--for一句话获得任务地图代理冷启动时最贵的一步是理解整个仓库。普通做法是读 README 架构文档约 2 万 tokenripwire . --for你接下来要做的改动一次调用返回按任务相关度排序的符号地图Personalized PageRank 排名 签名而非函数体约 2K token省 7.7 倍到 37.7 倍--pack-task场景的实测数据见 docs/EVALS.md。问什么命令ripwire朴素阅读节省给我讲讲这个仓库ripwire .~5.6K tok~20K–25K tok3.6–4.5×我要做 X 改动先给我布局--pack-task…~2.1K tok~16K–80K tok7.7–37.7×我已知什么相关背景--recall…~15K tok~445K tok29.2×关键技巧签名比函数体便宜——ripwire 用签名代替函数体输出比正文少 74.7% 字节确认某符号真的相关时再用--expandSYM --top-k0取完整函数体比整文件阅读省 2.6–670 倍。问题 2X 功能在哪里处理——让--for直接给符号定位比讲仓库更进一步ripwire . --forMCP 索引什么时候判过期这类自然语言提问返回的是带排名和文件行号的符号例如某次实测中把真正的过期检查mcpStale排在第 5 位而不是几十行 grep 命中列表。实测省 2.3–9.3 倍 token。找不到的地方它会明说宽泛的常见词提问普通 grep 有时仍更快——这符合 ripwire 自己的指引它擅长具体的技术提问。能力边界完整写在 docs/LIMITS.md。问题 3谁调用了这个函数——--callers比 grep 准一个量级grep搜函数名命中的大多是注释和字符串ripwire . --callersSYM走的是解析出来的确定性调用图只报真实调用点。实测中--callers对某函数报出 ~580 token而 grep 加开文件核对要 40K–52K token省 69–89 倍。真实战例来自官方多代理现场报告一个任务本以为是启用某已在生产的引导行为--callers一次调用返回生产调用者为 0任务当场改道——真正缺的是数据提供端从未被接线。一次调用比整场会话其余工具加起来还值。上图实线是确认的调用边虚线是解析器无法二选一的猜测边——ripwire 是唯一会公开标注自己哪条箭头不确定的代码图工具。问题 4改它安全吗要跑哪些测试——--impact--situ一次答全改公共符号前代理要的是爆炸半径ripwire . --impactSYM配合--usesSYM给出调用方与使用点实测 ~1.3K token省 14.4 倍改完文件后ripwire . --situ直接回答这个 diff 的爆炸半径 该跑哪些测试~410 token省 7.3–324 倍——它能找到按文件名 greptest/目录都找不到的测试用例。写代码时还有两道闸门--edit-checkSYM改动公共符号前后比对契约实测曾抓出 6 个调用点中 5 个不兼容——全是文本搜索漏掉的--quality-delta只报告哪些质量指标变差了配合--test-gate判断必跑测试见 docs/EVALS.md 的验证方法。这些动词的完整定义都在自动生成的 docs/COMMANDS.md。问题 5我拿到一段调用栈先查哪里——--from-trace直接给内层帧粘贴调用栈文件ripwire . --from-traceFILE会把栈里 7 帧全部按名字解析到定义位置实测省 87–209 倍 token。上图一份多代理协作现场报告的核心数据——研究阶段 token 花费减半、两次任务改道、十几处真实质量缺陷在自认为完成时刻被拦截。上手清单与延伸阅读 ✅ripwire .—— 30 秒认识任何仓库ripwire . --for你的改动—— 任务布局这是最高频入口--callers/--impact—— 动手前查契约与爆炸半径--situ—— 改完即知该跑哪些测试--expandSYM—— 只在你确定要读函数体时才付这份钱。安装与代理接入INSTALL.md全部命令与输出样例docs/COMMANDS.md测量方法与诚实的反例清单docs/EVALS.md能力上限docs/LIMITS.md技能库教会代理何时调用skills/一句话总结给代理一张地图再出发比让它盲读整个仓库更快、更省、也更不容易猜错。【免费下载链接】ripwireThe ripgrep of AI context: a zero-dependency C23 CLI MCP server for coding agents. Find what you want without reading the repo, then check you built what you meant — blast radius, tests-to-run, quality deltas. Signatures at 74.7% fewer bytes than bodies; every guess labelled, every loss published. Paddle out with a map.项目地址: https://gitcode.com/gh_mirrors/ri/ripwire创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考