# Module Discovery > 仅适用于已维护 tap-agents/prompts/module-map.md 且明确采用模块索引协作机制的仓库；当用户明确要求按模块索引定位代码、查看模块结构或修改模块代码时使用。不满足这些条件时不要触发。 Use when this capability is needed. - Skill: `tomevault-io/module-discovery` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/module-discovery` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/module-discovery/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Product & Planning - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/module-discovery --- # 模块发现（按需执行） ## 适用范围（必须先判断） 仅在同时满足以下条件时使用本 skill： 1. 项目已维护 `tap-agents/prompts/module-map.md` 和相关模块文档，或用户明确要求启用这套模块索引体系 2. 当前任务需要按模块索引定位代码、查看模块结构，或修改模块代码并同步文档 3. 仓库或团队已明确将 `module-map.md` 作为模块定位和协作入口 如果不满足以上条件： - 不要触发此 skill - 不要因为缺少 `module-map.md` 打断当前任务 - 不要在未采用该协作机制的仓库或通用问答中要求生成模块索引 ## 前置步骤（必须执行） 在确认适用后，再读取项目模块索引： 1. 检查 `tap-agents/prompts/module-map.md` 是否存在 - **如果不存在且用户明确要求启用模块索引体系**：询问用户是否需要生成，确认后使用 [generate-module-map.md](generate-module-map.md) prompt 进行生成 - **如果不存在但当前任务不依赖模块索引**：直接退出此 skill，不中断当前任务 - **如果存在**：读取 `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 规则更新 --- > Converted and distributed by [TomeVault](https://tomevault.io/claim/taptap) — claim your Tome and manage your conversions.