cartographer
用于代码库分析与导航的智能图谱工具
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：cartographer。 它的用途是：用于代码库分析与导航的智能图谱工具 完整的 Skill 内容见：https://321skill.com/skills/cartographer/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“请帮我分析一下 `src/auth` 目录的代码结构和依赖。” 它会引导你运行 `bun run cartographer:brief -- --out .cartographer --path src/auth --mode overview` 来获取该目录的概要图谱。或者，在智能体开发中，你可以配置它在修改代码前自动调用 `cartographer:brief` 来获取精准的上下文，确保修改基于对代码库的充分理解。
介绍
Cartographer 是一款专为智能编码代理设计的代码库分析与导航工具。它解决了开发者在面对大型、陌生或复杂代码库时难以快速理解其结构和依赖关系的痛点，通过构建代码图谱来提供智能化的上下文支持。
该工具通过 CLI 命令或 MCP 协议集成到工作流中。核心流程是使用 index 命令将代码库索引到一个本地的 SQLite 图谱中，生成包含文件、符号、依赖关系的结构化数据。之后，开发者或 AI 代理可以使用 brief 命令获取围绕特定文件或符号的上下文摘要，使用 audit 命令进行代码移除或完整性审计，并通过 notes 命令管理基于证据的语义笔记。
它非常适合需要深度理解代码库的开发者、智能体开发者和技术负责人。无论是接手遗留项目、进行大规模重构、审计代码安全，还是为 AI 编码助手提供精准的上下文，Cartographer 都能显著提升效率和代码理解深度。
使用建议是，对于日常开发，可以将其集成到 CI/CD 流程中，确保代码图谱的实时性。对于 AI 代理协作，重点利用 brief 和 context 命令来提供有界的、高相关性的代码上下文，避免向 AI 模型灌输无关信息。注意，它主要服务于分析和理解阶段，不直接参与代码编写或构建。
核心特点
与同类代码分析工具相比，Cartographer 的核心区别在于其专为 AI 智能体工作流设计，提供了 `brief` 等命令来生成有界、任务相关的代码上下文摘要，并能通过 `adoption` 命令量化评估 AI 代理是否有效利用了图谱上下文，实现了从静态分析到智能体协同的跨越。
注意事项
该工具不适合直接用于编写业务代码或执行构建、部署等开发流水线任务，其主要定位是代码理解、审计和上下文管理。
常见问题
Cartographer 和 Claude Code 插件是什么关系？
Claude Code 插件是旧版工作流，用于生成代码库地图文档；Cartographer v2 是独立的 CLI 和图谱工具，功能更强大，建议新项目使用 v2。
如何为 AI 编码助手提供代码上下文？
使用 `cartographer:brief` 命令，指定目标路径和模式（如 implementation），可以生成一份精炼、有边界的上下文摘要供 AI 使用。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/cartographer/raw/index.md 读取 cartographer 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/cartographer/raw/index.md（查看排版版本）