tomevault-io 模块发现（按需执行）
适用范围（必须先判断）
仅在同时满足以下条件时使用本 skill：
- 项目已维护
tap-agents/prompts/module-map.md和相关模块文档，或用户明确要求启用这套模块索引体系 - 当前任务需要按模块索引定位代码、查看模块结构，或修改模块代码并同步文档
- 仓库或团队已明确将
module-map.md作为模块定位和协作入口
如果不满足以上条件：
- 不要触发此 skill
- 不要因为缺少
module-map.md打断当前任务 - 不要在未采用该协作机制的仓库或通用问答中要求生成模块索引
前置步骤（必须执行）
在确认适用后，再读取项目模块索引：
- 检查
tap-agents/prompts/module-map.md是否存在- 如果不存在且用户明确要求启用模块索引体系：询问用户是否需要生成，确认后使用 generate-module-map.md prompt 进行生成
- 如果不存在但当前任务不依赖模块索引：直接退出此 skill，不中断当前任务
- 如果存在：读取
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 规则更新
Converted and distributed by TomeVault — claim your Tome and manage your conversions.