Ds Mapper

When you clone an unfamiliar repo and need to understand its layout fast, this skill generates an annotated directory tree with emoji markers and Chinese explanations for each folder's purpose. It reads package managers like package.json or Cargo.toml to identify the stack, then outputs a three-level ASCII tree that skips noise folders like node_modules. You also get a table mapping directories to their responsibilities and suggested entry points for diving in. It's designed for the "show me around this codebase" moment when you'd otherwise be clicking through folders blind or running tree commands without context.

GitHub stars: 328
last updated: May 13, 2026

View on GitHub

Install

$ npx -y skills add laolaoshiren/claude-code-skills-zh --skill ds-mapper --agent claude-code

Installs into .claude/skills of the current project.

Files

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

触发条件

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

工作流程

扫描根目录 — 使用 Bash find 和 ls 获取顶层结构
分析关键目录 — 读取关键文件（package.json, Cargo.toml, pyproject.toml, go.mod 等）获取项目元信息
递归扫描 — 深入扫描主要目录，理解各模块职责
生成结构图 — 输出 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`

SKILL.md on GitHub