chainlesschain 代码库结构映射技能
描述
创建代码库的 AST 级结构映射，提取所有文件的类、函数、导出、导入符号，生成压缩的全局代码感知索引。让 AI 在不加载完整文件内容的情况下了解整个项目结构，实现跨文件推理。
使用方法
/repo-map [目录路径] [选项]
选项
--depth <n>- 扫描深度层级 (默认: 全部)--exports- 仅显示导出符号--imports- 显示导入依赖关系图--find <symbol>- 查找特定符号的定义和引用位置--format <type>- 输出格式: tree, flat, mermaid (默认: tree)--filter <pattern>- 文件过滤模式 (如*.ts)
执行步骤
- 扫描目录: 递归遍历指定目录，按语言分类文件
- AST 解析: 解析每个文件的语法树，提取符号（类、函数、变量、导出、导入）
- 构建索引: 建立符号 → 文件位置的映射表
- 依赖分析: 追踪 import/require 关系，构建模块依赖图
- 压缩输出: 生成紧凑的符号摘要，控制 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