hproof/module-analyzer

对指定模块执行结构 + 流程的综合深度分析，一次输出完整的模块画像。

定位：模块级深度分析。 深入模块内部，识别子模块边界、类关系、依赖网络和关键业务流程。 与 full-scan 的区别：full-scan 是项目级宏观概览（模块分布和层级），本 Skill 深入单个模块内部做详细分析。

输入参数

本 Skill 接收以下参数（由 analyst agent 传递）：

| 参数 | 类型 | 必填 | 说明 | |------|------|------|------| | scope | string | 是 | 要分析的模块路径（如 ./src/battle） | | output_file | string | 是 | 输出文件路径，由调用方指定 | | focus | string | 否 | 用户指定的重点关注事项 |

工作流程

1. 开始执行

   • 输出：[module-analyzer] 开始执行模块分析，scope=${scope}, output=${output_file}

2. 加载领域知识

   • 读取 ${CLAUDE_PLUGIN_ROOT}/docs/game-glossary.md，辅助理解目录命名、中间件识别和模块功能分类

3. 目录结构分析

   • 用 Glob 扫描目录层级（遵循 .claudeignore 忽略规则）
   • 用 Glob 识别代码文件分布
   • 参照 game-glossary.md 命名映射表理解目录职责
   • 分析命名规范和目录组织

4. 子模块/功能块识别

   • 按目录或命名空间划分子模块，每个子模块明确：名称、路径、职责、包含的核心文件
   • 参照 game-glossary.md 目录命名映射确定功能分类
   • 无子目录的扁平模块：按文件命名前缀或类职责聚合为功能块
   • 输出子模块列表和职责摘要

5. 类/接口关系分析

   • 识别主要类和接口
   • 分析继承关系，用 classDiagram 图呈现
   • 分析组合/聚合关系，用 classDiagram 图呈现

6. 子模块依赖分析

   • 用 Grep 分析文件间的 include/import 关系
   • 将文件级依赖归集到子模块粒度，生成子模块间依赖图（graph LR）
   • 识别循环依赖、过度耦合
   • 评估各子模块的内聚性和耦合度

7. 外部模块关系分析

   • 用 Grep 在当前分析范围之外搜索对本模块的 include/import 引用，确定哪些外部模块依赖本模块
   • 分析本模块代码中引用的外部模块（scope 之外的路径）
   • 如有 full-scan 文档，参照其模块分布表将路径映射为模块名
   • 生成本模块的外部关系图（graph LR），展示上下游依赖

8. 关键流程分析

   • 根据模块类型（参照 game-glossary.md 判断），选择合适的分析重点：
     • 引擎/底层模块：初始化链、更新循环、资源生命周期
     • 网络模块：发包/收包流程、状态同步机制
     • 业务模块：业务入口、核心业务流程、与底层模块的交互
   • 用 Grep 识别入口函数，用 Read + Grep 追踪调用链
   • 用 graph TD 呈现关键流程

9. 汇总架构健康度评估

   • 汇总第1-7章的分析结果
   • 按照以下维度评估模块质量：目录组织、子模块划分、类设计、依赖管理、流程清晰度、健壮性
   • 使用 🟢🟡🔴 统计各维度问题严重程度（高/中/低）
   • 准备架构健康度快照

10. 生成分析报告（强制执行）

警告：必须严格遵循以下模板结构，不得自由发挥。任何偏离模板的行为都是错误的。

要求：

• 必须使用 Write 工具将完整文档写入 output_file
• 必须包含完整的 frontmatter（YAML 头部）
• 必须包含导航表格和章节间导航链接
• 必须严格按照模板的 7 个章节顺序输出
• 代码链接必须使用 [📄 描述](路径#L行号) 格式
• 状态指示必须使用 🟢🟡🔴

模板文件：${CLAUDE_PLUGIN_ROOT}/docs/templates/module-analyzer-template.md

• 使用 Read 读取模板文件，复制其内容，填充变量后使用 Write 工具写入 output_file