codemap
为AI提供项目代码架构的即时上下文，节省Token消耗。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：codemap。 它的用途是：为AI提供项目代码架构的即时上下文，节省Token消耗。 完整的 Skill 内容见：https://321skill.com/skills/codemap/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我分析一下 `src/api/` 目录下新增的认证模块如何集成到现有的用户服务中？” 由于AI会话已通过codemap自动加载了项目结构上下文，它能立即理解模块位置和依赖关系，给出更精准的集成方案。或者，在代码评审前，运行 `codemap --diff main` 将变更摘要提供给AI，让它帮你审查PR影响范围。
介绍
codemap 是一款为大型语言模型（LLM）提供即时项目架构上下文的工具。它解决了开发者在向AI助手（如Claude）提问时，需要反复粘贴代码片段或解释项目结构，导致对话冗长、Token消耗巨大的痛点。
通过简单的命令行操作，如 codemap . 或 codemap --diff，它能快速生成项目的目录树、文件摘要或变更差异，并自动集成到Claude等AI助手的会话上下文中。用户只需运行 codemap setup 进行初始配置，后续在AI会话开始时，项目背景信息就会自动加载。
它非常适合需要频繁与AI讨论复杂代码库的开发者，如全栈开发、后端开发或智能体开发者。无论是审查代码设计、梳理业务流程，还是排查Bug根因，codemap都能让AI更准确地理解项目全貌。
使用建议：首次使用时，在项目根目录运行 codemap setup 以配置Claude本地钩子。注意，对于CI/CD环境，建议使用包含 ast-grep 的完整发布包（codemap-full），以确保依赖分析功能正常工作。
核心特点
与同类工具相比，codemap的核心优势在于其与AI助手（特别是Claude）的深度、自动化集成。它通过安装本地钩子，能在AI会话启动时自动注入项目上下文，无需手动复制粘贴，实现了真正的“零手动”架构感知。此外，其 `--deps` 选项利用 `ast-grep` 进行依赖流分析，提供了超越简单文件列表的深层代码关系洞察。
注意事项
不适合用于分析单个独立脚本或非代码类文本项目，其价值在大型、结构化的代码仓库中更为显著。
常见问题
codemap 如何节省AI对话的Token？
它通过自动为AI会话提供结构化的项目概览（如目录树、变更摘要），替代了用户手动描述项目或粘贴大量代码，从而减少了上下文中的冗余信息，优化了Token消耗。
在CI/CD流水线中如何使用codemap？
推荐下载 `codemap-full` 发布包，它包含了 `codemap`、`ast-grep` 和 `sg`，解压后即可使用 `--deps` 等完整功能，无需额外安装依赖。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/codemap/raw/index.md 读取 codemap 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/codemap/raw/index.md（查看排版版本）