# Repo Map

> 代码库结构映射 - AST级符号索引、全局代码感知、依赖可视化

- Skill: `chainlesschain/repo-map` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add chainlesschain/repo-map`
- Raw SKILL.md: https://api.skillmd.com/api/skills/chainlesschain/repo-map/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: chainlesschain (https://skillmd.com/u/chainlesschain)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/chainlesschain/repo-map

---


# 代码库结构映射技能

## 描述

创建代码库的 AST 级结构映射，提取所有文件的类、函数、导出、导入符号，生成压缩的全局代码感知索引。让 AI 在不加载完整文件内容的情况下了解整个项目结构，实现跨文件推理。

## 使用方法

```
/repo-map [目录路径] [选项]
```

## 选项

- `--depth <n>` - 扫描深度层级 (默认: 全部)
- `--exports` - 仅显示导出符号
- `--imports` - 显示导入依赖关系图
- `--find <symbol>` - 查找特定符号的定义和引用位置
- `--format <type>` - 输出格式: tree, flat, mermaid (默认: tree)
- `--filter <pattern>` - 文件过滤模式 (如 `*.ts`)

## 执行步骤

1. **扫描目录**: 递归遍历指定目录，按语言分类文件
2. **AST 解析**: 解析每个文件的语法树，提取符号（类、函数、变量、导出、导入）
3. **构建索引**: 建立符号 → 文件位置的映射表
4. **依赖分析**: 追踪 import/require 关系，构建模块依赖图
5. **压缩输出**: 生成紧凑的符号摘要，控制 token 开销

## 输出格式

```
src/main/
├── database.js
│   ├── class DatabaseManager
│   │   ├── initialize()
│   │   ├── query(sql, params)
│   │   └── migrate()
│   └── exports: { DatabaseManager }
├── llm/
│   ├── session-manager.js
│   │   ├── class SessionManager
│   │   │   ├── createSession(options)
│   │   │   ├── compressContext(session)
│   │   │   └── exportSession(id)
│   │   └── exports: { SessionManager }
```

## 支持的语言

| 语言        | 文件类型        | 符号提取                             |
| ----------- | --------------- | ------------------------------------ |
| JavaScript  | .js, .jsx, .mjs | 函数、类、const/let 导出、CommonJS   |
| TypeScript  | .ts, .tsx       | 接口、类型别名、枚举、泛型           |
| Python      | .py             | 类、函数、装饰器                     |
| Java/Kotlin | .java, .kt      | 类、接口、方法、注解                 |
| Vue         | .vue            | setup 函数、composables、defineEmits |
| Go          | .go             | 结构体、函数、接口                   |
| Rust        | .rs             | struct、impl、trait、fn              |
| Swift       | .swift          | class、struct、protocol、func        |

## 示例

扫描主进程代码:

```
/repo-map src/main/
```

查找特定函数:

```
/repo-map --find buildOptimizedPrompt
```

生成 Mermaid 依赖图:

```
/repo-map src/main/llm/ --imports --format mermaid
```