⚡

代码符号映射Skill map

这个技能用于生成代码库的语义化符号映射，提供精确的类、函数、接口定义位置，帮助开发者在处理不熟悉代码、重构前快速理解代码结构，避免文本匹配混淆，提高开发效率。关键词：代码分析、符号映射、代码导航、重构工具、软件开发。

架构设计 0 次安装 0 次浏览 更新于 3/12/2026

name: 映射 description: 生成语义化代码库符号映射以进行精确的代码导航。当开始处理不熟悉的代码库时使用，重构前，或当您需要了解类/函数/接口的定义位置而不是使用rg文本匹配时。

代码库符号映射生成器

生成一个语义化符号映射，显示所有导出、类、函数和接口的定义位置。通过提供精确的文件:行位置，消除使用rg时的猜测。

何时使用

  • 开始处理不熟悉的代码库
  • 大规模重构前
  • 当需要理解代码结构时
  • 避免rg文本匹配混淆（相同名称在注释/字符串中）

执行

运行生成器脚本：

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

该脚本将：

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

输出格式

## 符号索引按类型

### 类

| 符号         | 位置                  |
| -------------- | ------------------------- |
| `AuthProvider` | `src/auth/provider.ts:15` |

### 函数

| 符号       | 位置               |
| ------------ | ---------------------- |
| `formatDate` | `src/utils/date.ts:42` |

生成后使用

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

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

不再需要grep和猜测。