ds-mapper
Skill907 starsChanged 4 months agoMITView on GitHub
项目目录结构地图 - 生成带说明的可视化目录树,快速理解任意代码库
In this repository20 other files it gives its agents.
- docs/llms.txtllms.txt
- api-testerSkill
- changelog-genSkill
- db-migratorSkill
- dep-auditorSkill
- env-managerSkill
- error-translatorSkill
- eslint-fixSkill
- github-actions-genSkill
- git-workflowSkill
- i18n-helperSkill
- log-analyzerSkill
- perf-profilerSkill
- refactor-advisorSkill
- security-auditSkill
- skill-curatorSkill
- test-generatorSkill
- zh-code-reviewerSkill
- zh-docgenSkill
- zh-readmeSkill
The file
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`注意事项
- 跳过 node_modules, .git, vendor, pycache 等常见忽略目录
- 对每个关键目录给出一行中文说明
- 如果项目有 monorepo 结构,分别列出各 packages
- 最多展示 3 层深度,避免输出过长
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

