full-scan

执行项目整体代码扫描，识别模块分布并生成项目结构文档。

定位：宏观概览。 关注"有哪些模块、它们属于哪一层"，不深入分析模块内部的类关系和依赖细节。 如需深入分析某个模块的内部结构、依赖和流程，请使用 module-analyzer。

输入参数

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

参数	类型	必填	说明
scope	string	是	扫描路径，通常为 . 表示项目根目录
output_file	string	是	输出文件路径，由调用方指定

工作流程

1. 开始执行

   • 输出：[full-scan] 开始执行整体扫描，scope=${scope}, output=${output_file}

2. 扫描项目结构

   • 用 Glob 遍历目录树（遵循 .claudeignore 忽略规则）
   • 识别目录类型（第三方/底层/业务）
   • 用 Bash(wc -l ...) 统计代码量，用 Glob 统计语言分布

3. 加载领域知识

   • 读取 ${CLAUDE_PLUGIN_ROOT}/docs/game-glossary.md，用于第三方库识别和模块功能分类

4. 模块识别与分类

   第三方库识别：

   • 扫描 third_party/、external/、libs/、vendor/ 等目录
   • 识别开源许可证文件（LICENSE、COPYING）
   • 参照 game-glossary.md 中间件列表，将 Wwise、FMOD、Spine 等识别为对应类别

   底层模块识别：

   • 被业务模块依赖但很少依赖业务模块
   • 提供通用能力（渲染、网络、音频、资源管理等）
   • 目录内语言一致、功能内聚

   业务模块识别：

   • 参照 game-glossary.md 目录命名映射表，将目录名映射到功能分类
   • 场景内业务：战斗、探索等（与场景绑定）
   • 场景无关业务：背包、强化等（UI交互）

5. 引擎级关键流程概览（如能识别）

   • 用 Grep 搜索程序入口（main 函数、入口注解等），梳理初始化顺序
   • 识别主循环/帧更新结构（Update、Tick 等），概述每帧执行阶段
   • 不做深入调用链追踪，仅展示宏观执行框架

6. 汇总架构健康度评估

   • 基于前述分析结果，评估各健康度维度
   • 识别循环依赖、过度耦合、God Class 等问题
   • 使用 🟢🟡🔴 统计问题严重程度
   • 准备架构健康度快照

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

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

   要求：

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

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

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