| name | module-discovery |
| description | 排查问题、修复 BUG、定位代码、查找模块、功能开发前,必须先读取此 SKILL 并使用模块索引定位目标,不可跳过 |
模块发现(自动执行)
前置步骤(必须执行)
在开始任何开发任务前,必须先读取项目模块索引:
- 检查
tap-agents/prompts/module-map.md是否存在- 如果不存在:中断操作不继续往下, 询问用户是否需要生成,确认后使用 generate-module-map.md prompt 进行生成
- 如果存在:读取
tap-agents/prompts/module-map.md
- 理解项目模块划分和优先级
- 记住快速定位表中的关键词映射
路径约定:本文档中所有以 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 | 代码修改后同步更新模块文档和索引 |
注意事项
- 优先使用索引:在搜索代码前,先查阅 module-map.md 定位模块
- 信任索引:module-map.md 是项目模块的权威来源
- 发现过期:如发现索引与代码不一致,按 doc-auto-sync 规则更新