用途：对现有 Phaser 4 项目做全面分析，评估架构质量、识别性能风险、标记 API 正确性问题，并生成按优先级排序的改进路线图。
主要能力：按五个阶段依次执行，不跳过任何阶段。阶段一发现：读取 package.json 获取依赖与 Phaser 版本，扫描 src/ 下 .ts/.js 文件，读取 main.ts 的 GameConfig，用 grep 找出所有场景、场景图（this.scene.start/launch/stop）、自定义游戏对象，并统计文件数与代码行数。阶段二架构评估：检查场景数量与组织、状态管理方式（Registry/全局/模块状态）、资源加载策略、代码组织约定、跨场景耦合，并给出 A 至 F 评级。阶段三性能审计：检查对象池（缺少 maxSize 的物理组）、粒子发射器 maxParticles、静态组与动态组、update 循环负担、纹理图集使用、物理体数量。阶段四 API 正确性：扫描已移除的 v3 API、TypeScript 严格性、资源键一致性、场景键注册、物理体创建、DynamicTexture/RenderTexture 的 render 调用。阶段五最佳实践：生命周期纪律、关闭时清理、相机边界、键盘空值断言、物理调试标志、console 语句。
输出：结构化报告，含项目摘要、架构评分、按严重程度排序的性能风险、代码质量问题、改进路线图与快速见效项。
用法：先运行自动预扫描脚本 bash "${CLAUDE_PLUGIN_ROOT}/skills/phaser-analyze/scripts/analyze-project.sh" 获取基线指标，再阅读实际源码完成五阶段分析。相关技能：/phaser-migrate 修复 v3 API 问题，/phaser-physics 实现对象池与修复物理组，phaser-debugger 代理调查运行时性能问题。参考文件包括 references/analysis-checklist.md 与 references/performance-playbook.md。
限制：资料未提供具体收费、价格、平台支持范围或效果保证；分析结果依赖项目源码可读性与脚本可用性。