| name | project-analysis |
| description | 对当前项目进行全面总结分析：审查代码质量、检查构建状态、分析完成度、更新项目文档。适用于用户说'总结分析本项目'、'分析项目当前状态'、'审查代码'等场景。 |
项目总结分析
对当前项目进行全面的健康检查和状态分析，输出结构化的项目分析报告。
触发条件
- 用户说"总结分析本项目"、"分析项目当前状态"
- 用户说"审查代码"、"评估可行性"
- 用户说"你觉得这个项目怎么样"
- 准备推进项目前的状态评估
工作流程
Phase 1：读取项目文档
按优先级读取以下文档（如果存在）：
README.md — 项目概述、技术栈ARCHITECTURE.md — 架构设计、模块结构PRD.md 或 PRODUCT_REQUIREMENTS.md — 产品需求ROADMAP.md — 开发路线图、进度追踪build.gradle.kts / package.json / go.mod — 依赖和构建配置.gitignore — 排除规则
Phase 2：代码结构探索
- 列出项目根目录结构
- 识别主要源码目录（
app/src/, src/, cmd/ 等）
- 统计代码文件数量和主要语言
- 识别核心模块和入口点
- 检查测试目录和测试覆盖
Phase 3：构建状态检查
根据项目类型执行构建检查：
- Android/Gradle：
./gradlew assembleDebug 2>&1 | tail -30
- Node.js：
npm run build 2>&1 | tail -30
- Go：
go build ./... 2>&1
- Rust：
cargo check 2>&1
- Python：
python -m py_compile 或 pytest --co
记录：
Phase 4：测试执行
运行项目的测试套件：
- Android：
./gradlew testDebugUnitTest 2>&1 | tail -20
- Node.js：
npm test 2>&1 | tail -20
- Go：
go test ./... 2>&1
- Python：
pytest 2>&1 | tail -20
记录：
Phase 5：完成度分析
对照 ROADMAP 或 PRD 分析：
- 已完成功能列表
- 未完成功能列表
- 已知问题和 Bug
- 技术债务
- 完成百分比估算
Phase 6：输出分析报告
生成或更新 PROJECT_ANALYSIS.md，包含以下章节：
# [项目名] - 项目总结与分析
> **最后更新**：YYYY-MM-DD
## 一、项目概述
（定位、目标、技术栈）
## 二、架构概览
（模块结构、关键设计决策）
## 三、当前进度
（已完成/进行中/未开始的功能）
## 四、代码质量
（构建状态、测试覆盖、代码规范）
## 五、已知问题
（Bug、技术债务、待优化项）
## 六、建议下一步
（优先级排序的待办事项）
## 七、代码统计
（文件数、代码行数、主要语言占比）
注意事项
- 如果项目已有
PROJECT_ANALYSIS.md，在原有基础上更新而非重写
- 保持中文输出
- 对于无法构建的项目（缺少环境/依赖），记录原因并跳过构建检查
- 不要修改源代码，仅读取和分析
- 如果 ROADMAP.md 存在，优先基于它分析完成度
