mcpField
M
map

map

github.com/htlin222开发7837 次安装3 周前更新
代码仓库

关于 map

map 是面向代码开发者的代码库符号映射生成器，适用于了解项目结构或进行重构。它可检测支持的语言，并记录导出符号的文件与行号。

主要功能

  1. 01检测 TypeScript、JavaScript、Python、Rust 和 Go
  2. 02提取导出符号
  3. 03记录文件与行号
  4. 04生成 Markdown 符号映射

适用场景

  1. 01了解陌生代码库
  2. 02重构前定位符号

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/htlin222/dotfiles --skill map

安装后在 Claude Code 中输入/map确认已加载。

附带文件scripts/symbol_map.py

详细介绍

代码库符号映射生成器

生成语义符号映射，显示所有导出项、类、函数和接口的定义位置。无需再用 rg 猜测，直接提供精确的 file:line 位置。

适用场景

  • 开始处理不熟悉的代码库时
  • 大规模重构前
  • 需要了解代码结构时
  • 避免 rg 文本匹配造成混淆（注释或字符串中可能出现同名内容）

执行

运行生成器脚本：

python3 ~/.claude/skills/map/scripts/symbol_map.py

脚本将：

  1. 检测项目语言（TypeScript/JavaScript/Python/Rust/Go）
  2. 提取所有导出符号及其位置
  3. 在 ~/.claude/codebase-maps/{project}_symbols.md 生成 Markdown 映射

输出格式

## Symbol Index by Type

### Classes

| Symbol         | Location                  |
| -------------- | ------------------------- |
| `AuthProvider` | `src/auth/provider.ts:15` |

### Functions

| Symbol       | Location               |
| ------------ | ---------------------- |
| `formatDate` | `src/utils/date.ts:42` |

生成后的用法

运行 /map 后，直接使用符号位置：

  • “阅读 src/auth/provider.ts:15，检查 AuthProvider”
  • “src/utils/date.ts:42 处的 formatDate 函数需要修改”

不必再搜索和猜测。

评论

支持 Markdown