# Module Discovery

> 排查问题、修复 BUG、定位代码、查找模块、功能开发前，必须先读取此 SKILL 并使用模块索引定位目标，不可跳过

- Skill: `majiayu000/module-discovery` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/module-discovery`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/module-discovery/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/module-discovery

---


# 模块发现（自动执行）

## 前置步骤（必须执行）

在开始任何开发任务前，必须先读取项目模块索引：

1. 检查 `tap-agents/prompts/module-map.md` 是否存在
   - **如果不存在**：中断操作不继续往下, 询问用户是否需要生成，确认后使用 [generate-module-map.md](generate-module-map.md) prompt 进行生成
   - **如果存在**：读取 `tap-agents/prompts/module-map.md`
2. 理解项目模块划分和优先级
3. 记住快速定位表中的关键词映射

**路径约定**：本文档中所有以 `tap-agents/` 开头的路径均指项目根目录下的对应路径。

## module-map.md 包含的信息

### 模块列表

按优先级分为三类：

| 优先级 | 说明 | 示例 |
|-------|------|------|
| P0 核心 | 核心业务流程必经的模块 | Account、Home |
| P1 常用 | 常用但非核心的功能模块 | Settings、Profile |
| P2 工具 | 工具类、基础组件 | Utils、Components |

每个模块记录了：
- 模块名称
- 代码路径
- 一句话功能描述
- 文档状态（✅ 已创建 | ⏳ 待创建 | 🔄 需更新）

### 快速定位表

关键词到模块的映射表，覆盖常见的口语化表达：

| 关键词 | 相关模块 | 说明 |
|-------|---------|------|
| 登录、注册、账号 | Account, Login | 用户认证相关 |
| 首页、推荐 | Home, Recommend | 首页展示 |
| ... | ... | ... |

## 如何使用已加载的信息

### 场景1：收到开发需求

当用户描述需求时，利用快速定位表中的关键词映射，快速定位到相关模块：

```
用户：修改评分显示样式

AI思路：
1. 关键词"评分" → 查快速定位表 → 找到相关模块
2. 定位到具体模块路径
3. 开始修改代码
```

### 场景2：需要了解模块详情

当需要更详细的模块信息时，读取对应的模块文档：

```
读取 tap-agents/prompts/modules/[模块名].md
```

模块文档包含：
- 模块简介
- 核心功能列表
- 主要类/文件表
- 常用叫法映射

### 场景3：新增或修改模块代码

修改代码后，需配合 [doc-auto-sync](../doc-auto-sync/SKILL.md) 技能同步更新文档。

## 与其他技能的配合

| 技能 | 配合方式 |
|-----|---------|
| doc-auto-sync | 代码修改后同步更新模块文档和索引 |

## 注意事项

1. **优先使用索引**：在搜索代码前，先查阅 module-map.md 定位模块
2. **信任索引**：module-map.md 是项目模块的权威来源
3. **发现过期**：如发现索引与代码不一致，按 doc-auto-sync 规则更新