mcpField
D
ds-mapper

ds-mapper

github.com/laolaoshiren开发90084 次安装2 天前更新
代码仓库

关于 ds-mapper

项目目录结构地图技能扫描仓库目录和关键配置文件，生成带中文说明的目录树与模块概览。适用于希望快速了解代码库组织方式的开发者，并限制扫描深度以控制输出长度。

主要功能

  1. 01扫描顶层与主要目录
  2. 02读取关键配置文件
  3. 03生成带注释的 ASCII 目录树
  4. 04总结模块职责与项目信息
  5. 05跳过常见忽略目录并限制深度

适用场景

  1. 01初次了解陌生代码仓库
  2. 02查看 monorepo 中各 package 的组织
  3. 03定位源码、测试和配置所在目录

安装

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

$npx skills add https://github.com/laolaoshiren/claude-code-skills-zh --skill ds-mapper

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

详细介绍

来自项目 README

项目目录结构地图（Directory Structure Mapper）

触发条件

当用户说「带我看看项目结构」「这个仓库怎么组织的」「目录树」「帮我理解这个代码库」或类似需求时激活此技能。

工作流程

  1. 扫描根目录 — 使用 Bash find 和 ls 获取顶层结构
  2. 分析关键目录 — 读取关键文件（package.json, Cargo.toml, pyproject.toml, go.mod 等）获取项目元信息
  3. 递归扫描 — 深入扫描主要目录，理解各模块职责
  4. 生成结构图 — 输出 ASCII 目录树 + 中文注释说明

输出格式

## 📂 项目结构地图

### 🔧 项目信息
- 语言：TypeScript / Python / Go / ...
- 框架：Next.js / FastAPI / Gin / ...
- 包管理：pnpm / pip / go mod

### 🌳 目录树

project-root/ ├── src/ # 📦 核心源码 │ ├── components/ # 🧩 UI 组件 │ ├── services/ # 🔌 业务逻辑层 │ ├── utils/ # 🔧 工具函数 │ └── index.ts # 🚀 入口文件 ├── tests/ # 🧪 测试文件 ├── docs/ # 📖 文档 ├── .github/ # 🔄 CI/CD 配置 ├── package.json # 📋 依赖管理 └── README.md # 📝 项目说明


### 🗺️ 模块说明

| 目录 | 职责 | 关键文件 |
|------|------|----------|
| `src/` | 核心源码 | index.ts, app.ts |
| `src/components/` | UI 组件 | Button.tsx, Modal.tsx |

### 💡 入口建议
- 🚀 启动入口：`src/index.ts`
- 📖 入门文档：`README.md`
- ⚙️ 配置文件：`config.yaml`

注意事项

  • 跳过 node_modules, .git, vendor, pycache 等常见忽略目录
  • 对每个关键目录给出一行中文说明
  • 如果项目有 monorepo 结构，分别列出各 packages
  • 最多展示 3 层深度，避免输出过长

评论

支持 Markdown