取材层转正：从翻文件到查图谱

概述

开发者效率这条链，本栏已经从审查、重构、测试、验证一路拆到调试和红灯值守，唯独没拆过所有这些工序共享的第零步：找代码。上一期《验证层之前》把 redhat-et/ripwire 挂在「编外一件」的位置，只给了一段定位——「审查的上游是检索」。本期把这一段扩成整条赛道：取材层，即 agent 在动手前从哪里拿到代码事实。四件入表对象加一件场外参照，横跨四种取材机制：

核心发现三条：其一，装机注册表四百三十件里没有一件给「找代码」发工牌——SKILL 生态在这层是空工位，供给被 CLI+MCP 编外件整体接管；其二，四种取材机制不是竞品而是阶梯，按「离代码的距离」分层；其三，取材层的质量决定上游审查层的上限，这句上期的判断本期有了数字背书。

需要声明：本会话网页抓取与搜索通道未获授权（发起即被权限拒绝，与上期相同），外部数据来自系统预抓取的 GitHub API 快照（2026-09-11）与本站存档，凡推断逐一标注 ※。

生态定位图：第零步卡在哪

flowchart TD
    T["一个开发任务进来"] --> S
    subgraph S["第零步：取材层"]
        B0["档0 基线：内建 grep 加 CLAUDE.md 地图"]
        B1["档1 图谱：codegraph 预建索引"]
        B2["档2 检索：ripwire 零依赖 CLI 加 MCP"]
        B3["档4 压缩：headroom 会话减脂"]
    end
    S -->|"代码事实"| R["审查：上期内构件"]
    S -->|"改动影响面"| F["重构：simplify"]
    S -->|"历史同类改法"| C["测试：上期五件"]
    S -->|"崩溃现场线索"| D["调试：上期七件"]
    R --> U["验证 合并 值守"]

评测对比表

注：CLI+MCP 编外件没有 SKILL.md，其「设计质量」衡量接口与安装设计；codegraph 与 headroom 的星数本轮未能核验，活跃度按存档收录时的社区状态纸面估计 ※。

主拆：ripwire——一句话自述里的三个设计决策

决策二：零依赖。 给 agent 用的底层工具，装机摩擦就是采用率的天花板。C++23 静态编译取向意味着单一可执行文件、不拖运行时——对照大量 Node/Python 系 MCP server 的环境成本，这是把「装」这个动作压缩到极限的设计取向 ※（构建产物形态未经本轮核验）。

决策三：双形态。 CLI + MCP server 一份能力两处售卖：CLI 卖给人、脚本和 CI，MCP 卖给 agent 会话。这里藏着它与 SKILL 生态的接口缝隙——MCP 件不进触发路由，agent 不会被「勾起」用它；装机时不显式注册、工作流里没人提醒，它就静静躺在工具列表里。谁在 SKILL.md 里写一句「检索代码事实时优先调 ripwire」，谁就补上了这条缝隙——这恰恰是本期结尾留给 SKILL 作者的机会。

对档一：codegraph——先花时间建图的富农

定位：colbymchenry/codegraph，本站 6 月 2 日存档收录，MIT 协议。思路与 ripwire 相反：不追求即取即用，而是提前把代码库建成知识图谱，agent 直接查图，不再翻文件。

数字背书：存档给出的对照账是取材层空位的最硬证据——在 VS Code 量级的万文件仓库里，agent 用基线 grep 方式探索一个架构问题，一次烧掉 1.79M token、约 $0.83。取材层省的不是时间，是真金白银。

设计取向：安装三步（install.sh → codegraph install → codegraph init -i），第二步自动检测宿主，官方兼容清单覆盖 Claude Code、Cursor、Codex CLI、OpenCode、Gemini CLI、Antigravity、Kiro——它赌的是「宿主会换，图谱层不换」，把宝押在中间层。

短板：图谱是预建的，代码一改就要重建，陈旧索引比没有索引更危险——agent 拿到的是一张过时地图，而且浑然不知。富农模式的前置成本也劝退小仓库。

对档二：headroom——不管找什么，只管装多少

定位：chopratejas/headroom，本站 6 月存档收录的 agent token 压缩层，用法是 headroom wrap claude——把宿主的启动包进一层，对进出会话的上下文做减脂。

位置：严格说它不取材，与前三档正交：前三档管「把对的代码找进来」，它管「找进来的东西别太胖」。放进同一张表是因为它们抢的是同一个预算池——上下文窗口。取材层做得再准，压缩层缺位，窗口照样被撑爆。

短板：压缩有损，丢掉的可能是下一次要用的事实；wrap 模式侵入启动方式，与部分宿主的会话恢复机制打架 ※。综合分垫底，但它是四件里唯一提醒「取材层还有一个维度」的。

对档三：基线件——默认档，也是对照组

harness 自带的 grep/Glob/Read 加 /init 生成的 CLAUDE.md 地图，零安装、零信任成本、永不陈旧。它同时是所有第三方件的计价器：codegraph 的图谱、ripwire 的检索、headroom 的压缩，卖价全都是「比基线省多少」。基线在万文件库里输在轮数——存档那 1.79M token 就是它开出的价签——但在百文件小仓库里，它仍是综合分里上手与活跃两个维度的满分选手。先跑基线感到疼，再上档，是这一层的正确装机顺序。

场外参照：serena——语义档的本地样本

oraios/serena，本站 9 月 4 日存档收录：把语言服务器协议（LSP）的能力做成工具集，经 MCP 喂给现有编程助手——符号跳转、找引用、重命名，像 IDE 一样精确，免全文搜索式「猜」。它代表阶梯的最高档：从「找到文本」上探到「找到符号」。本轮通道受限未能核验当前数据，不入评分表，但记住这个位置——零依赖检索与语义符号之间的融合，大概率是这一层下一轮竞争的主战场。

安装与拼装

# 档0 基线：零安装，先跑起来感到疼
# 在 Claude Code 会话内执行 /init 生成项目地图

# 档2 ripwire：克隆后按仓库 README 构建（C++23 零依赖取向）
git clone https://github.com/redhat-et/ripwire

# 档1 codegraph：三步（2026-06-02 存档原文口径）
curl -fsSL https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.sh | sh
codegraph install
cd your-project && codegraph init -i

# 档4 headroom：包装宿主启动（存档口径，仓库 github.com/chopratejas/headroom）
headroom wrap claude

拼装顺序：小仓库（约百文件以内）只留基线；中等仓库加 ripwire 即取即用；万文件长期项目上 codegraph 并接受重建税；窗口经常爆的再加 headroom。每加一档前，先确认上一档真的疼过。

分维度排行榜

给 SKILL 作者的三条启示

1. 空工位就是招商位。 装机四百三十件里没有一件代码取材件（本会话注册表清点：find-skills 找的是 Skill 不是代码，ducksearch/web-access 管网页，deep-research 管文献）——这层的 SKILL.md 工位整排空着。而 CLI+MCP 编外件的共同缺陷是不进触发路由。写一件薄薄的 SKILL.md，正文只做一件事：判断何时该调哪个取材工具并替用户拼好参数，就能同时吃到工具层的真能力和触发层的路由权。
2. 类比命名借信用，也要防截断。 「The ripgrep of AI context」是绝佳的自我定位，但描述被截断后类比就失效了——把类比放进名字（rip-）而不只是描述第一句，是更抗剪裁的写法。
3. 正交维度别硬凑同表。 headroom 与取材三档机制正交，本期仍给它一席，但综合分明确垫底并写明原因——评分表允许跨维度，但必须把「为什么它不该跟别人比」写出来，否则读者会把 2.85 误读成产品差。

诚实条款

本会话外部抓取与搜索通道未获授权（curl 与 WebSearch 发起即被权限拒绝）：ripwire 的能力边界、构建形态、redhat-et 组织背景均为纸面推断并标注 ※；codegraph 与 headroom 全部数据转引自本站 2026-06-02 存档、serena 转引自 2026-09-04 存档，当前星数与版本未核验；基线件评分为宿主公知行为的设计分析；全部加权分为主观综合，不引用无法核实的下载量。

参考来源

1. redhat-et/ripwire — 小而美榜第 8 位（1892 星），自述引自系统预抓取 GitHub API 快照（2026-09-11）
2. colbymchenry/codegraph — 安装三步、七宿主兼容与 1.79M token 对照账，转引自本站 2026-06-02 存档
3. chopratejas/headroom — wrap 压缩模式，转引自本站 2026-06-02 存档
4. oraios/serena — LSP 语义工具箱，转引自本站 2026-09-04 存档
5. 本站存档《验证层之前：审查与重构五件横评》（2026-09-11）— ripwire「编外一件」定位与「第二条供给线」论断出处
6. 本会话环境装机清单（约四百三十件口径）— 取材层空工位的清点来源

[!tip] 51学通信知识星球 星主：爱卫生（微信：gprshome201101）——公众号「51学通信」创办者，19 年通信行业运维与讲师经验，著有《GPRS网络信令实例详解》《EPC原理与实践》《5G核心网原理与实践》三本纸质书（各大电商平台有售）。 星球定位：深耕 5G 核心网、IMS、NFV/AI、云原生等 ICT 领域，主打运维岗位与信令分析。 当前规模：5200 篇主题 / 990 个回答，198 元/年。 加入福利：加入星球后请加爱卫生微信，拉您进知识星球年度陪伴与答疑群——不限量回复您的各种问题，另有群内分享。 AI 加持：51学通信知识星球已作为 skill 接入 WorkBuddy，使用 deepseek-4-flash 在海量星球帖子中精准找贴、找视频、找 FAQ 和案例，做总结、找文档和 PPT 等场景全覆盖。