Back to skills
extension
Category: AI Agent CapabilitiesNo API key required

module-discovery

Before troubleshooting, fixing bugs, locating code, finding modules, and developing features, you must first read this SKILL and use the module index to locate the target. Skipping this step is not allowed.

personAuthor: jakexiaohubgithub

模块发现(自动执行)

前置步骤(必须执行)

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

  1. 检查 tap-agents/prompts/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 | 代码修改后同步更新模块文档和索引 |

注意事项

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