codemap
为LLM探索代码提供轻量级索引，大幅降低Token消耗。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：codemap。 它的用途是：为LLM探索代码提供轻量级索引，大幅降低Token消耗。 完整的 Skill 内容见：https://321skill.com/skills/codemap-azidan/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“请帮我分析这个项目中所有与‘用户认证’相关的类。” AI可以首先调用CodeMap查询“UserAuth”、“Login”等关键词，获取相关类的精确文件路径和行号，然后只读取这些特定代码片段进行分析，而不是加载整个项目文件，从而极大节省上下文Token。
介绍
CodeMap 解决的核心问题是LLM在迭代探索代码库时因反复读取完整文件而导致的高昂Token消耗。它通过构建一个轻量级的符号索引（如类、函数的位置和行号），让LLM能够精准定位并只读取代码片段，从而将每次“读取”的成本降至最低。
使用方式非常简单：安装后，在项目根目录运行 codemap init . 初始化索引，并通过 codemap watch . 后台保持索引更新。之后，LLM（或开发者）就可以通过查询命令（如 codemap find "ClassName"）快速获取目标代码的精确位置，无需加载整个文件。
这个工具非常适合任何需要借助LLM进行代码分析、重构或理解大型项目的开发者，特别是后端开发、全栈开发和智能体开发者。它不替代LLM的推理能力，而是作为其高效“导航仪”。
建议在开始任何需要LLM深度介入的编码会话前初始化CodeMap。请注意，它仅提供结构索引，不进行语义理解，因此最适合与具备代码推理能力的LLM（如Claude Code）配合使用，以实现成本与效率的最佳平衡。
核心特点
CodeMap的核心定位是“降低I/O成本”，而非“增强智能”。它不试图理解代码语义或架构，只专注于提供最精确的符号位置索引，让LLM的每次代码读取都变得小而准，这与那些试图分析代码逻辑或推荐重构方案的“智能”工具形成鲜明对比。
注意事项
不适合需要深度语义理解或架构分析的场景，仅提供代码位置索引。
常见问题
CodeMap能理解我的代码逻辑吗？
不能。CodeMap只索引符号（如类、函数）的位置和范围，不进行任何语义分析。理解代码是LLM的工作。
使用CodeMap能节省多少Token？
根据官方测试，在多次查找和迭代的编码会话中，通常可节省70%以上的Token消耗。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/codemap-azidan/raw/index.md 读取 codemap 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/codemap-azidan/raw/index.md（查看排版版本）