模块发现(自动执行)
前置步骤(必须执行)
在开始任何开发任务前,必须先读取项目模块索引:
- •检查
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:收到开发需求
当用户描述需求时,利用快速定位表中的关键词映射,快速定位到相关模块:
code
用户:修改评分显示样式 AI思路: 1. 关键词"评分" → 查快速定位表 → 找到相关模块 2. 定位到具体模块路径 3. 开始修改代码
场景2:需要了解模块详情
当需要更详细的模块信息时,读取对应的模块文档:
code
读取 tap-agents/prompts/modules/[模块名].md
模块文档包含:
- •模块简介
- •核心功能列表
- •主要类/文件表
- •常用叫法映射
场景3:新增或修改模块代码
修改代码后,需配合 doc-auto-sync 技能同步更新文档。
与其他技能的配合
| 技能 | 配合方式 |
|---|---|
| doc-auto-sync | 代码修改后同步更新模块文档和索引 |
注意事项
- •优先使用索引:在搜索代码前,先查阅 module-map.md 定位模块
- •信任索引:module-map.md 是项目模块的权威来源
- •发现过期:如发现索引与代码不一致,按 doc-auto-sync 规则更新