hologram-map Skill 技能

📌 技能简介

hologram-map 是一个轻量级 Python 工具，读取代码库后输出一张紧凑的「代码地图」——包含公开可调用接口、类型字段名、模块调用关系、私有标识符及测试覆盖信息——直接嵌入 AI Coding Agent 的上下文文件。这张地图在第一轮对话就可用，无需任何代码探索。

🔧 解决什么问题

AI Coding Agent 在处理大型代码库时，通常需要消耗大量 Token 进行代码探索才知道「项目里有什么、模块间什么关系」。hologram-map 在每次 git commit 后自动更新这张地图，Agent 从第一轮对话就知道：

• 目标功能应该放在哪个模块
• 哪个家族的类型需要扩展
• 项目里已有的辅助函数，避免重复造轮子

💡 核心功能

1. 代码库压缩：将整个项目压缩为一张可读的树状地图，包含模块结构、类型关系、调用链
2. 零 LLM 干预：地图生成完全确定性，相同代码永远生成相同地图，地图 diff 即代码变更
3. 自动同步：git hooks 在每次 commit 后自动更新地图，始终保持最新
4. 多场景覆盖：功能规划、代码实现、Code Review、重构、调试、新人 onboarding

📊 输出示例

输出格式类似：模块名 + 公开方法 + 项目内部调用 + 私有标识 + 测试覆盖 + 方法行数。例：App(C) ×0 > PricingEngine,evaluate 表示 App 类无静态引用、调用了 PricingEngine 的 evaluate 方法。详细符号含义在输出第二行有完整图例。

🎯 适用人群

• 频繁使用 Claude Code / Cursor / Copilot 等 AI 编程工具的开发者
• 需要在大型代码库里做重构或新增功能的工程师
• 希望 AI 生成代码更精准、减少幻觉的项目团队
• 需要 Code Review 或代码审查的场景

🚀 快速上手

pip install hologram-map
hologram . > context/code-map.md

首次运行会自动安装所需的解析器（基于 tree-sitter），之后每次 git commit 触发自动更新。

⭐ 亮点

• 单文件实现，零额外依赖
• 确定性输出，Token 成本可预测
• 支持 Python、Java、JavaScript、TypeScript 等多语言
• 与任何 AI Coding Agent 兼容（Claude Code、Cursor、Copilot、Codex 等）