代码上下文优化
在已建好 graft 索引的仓库里,用一条命令按 file:line 定位代码、看清调用关系和改动影响,避免反复读整个源文件。
功能与用途
在大仓库里让 AI 改代码,它往往会反复打开一堆源文件,token 烧得快还容易看漏调用边。graft 把仓库预先编成一张图,每个模块是一张说明性 markdown 卡片并标明覆盖的 file:line,另有一张谁调用谁的连线图。你问「鉴权怎么走的」它会直接给命中位置和那几行关键代码;要重命名或重构就用 callers 看完整影响范围,比通读源码省得多。前提是这个仓库已经建过 graft 索引。
适用场景
- 刚接手一个几十万行的仓库,需要先弄清整体架构和每个目录里的入:刚接手一个几十万行的仓库,需要先弄清整体架构和每个目录里的入口在哪,再动手改任何东西
- 想把一个用了很多年的函数改名,但不确定有哪些地方在调它,怕漏:想把一个用了很多年的函数改名,但不确定有哪些地方在调它,怕漏改出事
- 线上某处报错,只知道症状关键词,需要快速定位到负责逻辑的 f:线上某处报错,只知道症状关键词,需要快速定位到负责逻辑的 file:line 而不是整个仓库翻一遍
适用人群
- 在大型或单仓多项目仓库里改代码的后端工程师
- 要接手陌生代码库的新成员
- 用 AI 编码代理、在意上下文成本的技术负责人
使用步骤
- 确认这个仓库已经建好 graft 索引,命令行里能直接跑 graft 命令
- 要理解某个概念或找某段逻辑在哪,直接问 graft ask,加 --source 会把命中处的关键代码内联出来,多数任务一次就够
- 已经知道符号名要找全量出现位置,用 graft grep,结果会按所属符号分组;匹配太少就把正则放松只留裸名字重试
- 要改签名、重命名或重构,先跑 graft callers 看 --direction in 的调用方,用 --depth 2 或 --depth all 展开影响范围再动手
- 落地陌生仓库先跑 graft map 看目录簇和热点导读,然后只读它点名的 hub 卡片;CI 里用 graft check 卡住索引过期
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- 编程
- 适用工具
- Codex、Claude Code、OpenClaw、Hermes、国内 Agent
- 使用难度
- 进阶
- 版本
- main
- 最近更新
- 2026-09-15
- 文件数
- 3
- 安装包大小
- 自动生成 ZIP
- 安全检查
- 基础检查通过
This repo is indexed by graft/. For ANY task here, whether
使用前准备
- 需要仓库已建立 graft 索引并具备命令行环境(graft 命令免 API Key)
依赖与权限
- 读取用户主动提供的内容