project-analysis

name	project-analysis
description	对当前项目进行全面总结分析：审查代码质量、检查构建状态、分析完成度、更新项目文档。适用于用户说'总结分析本项目'、'分析项目当前状态'、'审查代码'等场景。

项目总结分析

对当前项目进行全面的健康检查和状态分析，输出结构化的项目分析报告。

触发条件

• 用户说"总结分析本项目"、"分析项目当前状态"
• 用户说"审查代码"、"评估可行性"
• 用户说"你觉得这个项目怎么样"
• 准备推进项目前的状态评估

工作流程

Phase 1：读取项目文档

按优先级读取以下文档（如果存在）：

1. README.md — 项目概述、技术栈
2. ARCHITECTURE.md — 架构设计、模块结构
3. PRD.md 或 PRODUCT_REQUIREMENTS.md — 产品需求
4. ROADMAP.md — 开发路线图、进度追踪
5. build.gradle.kts / package.json / go.mod — 依赖和构建配置
6. .gitignore — 排除规则

Phase 2：代码结构探索

1. 列出项目根目录结构
2. 识别主要源码目录（app/src/, src/, cmd/ 等）
3. 统计代码文件数量和主要语言
4. 识别核心模块和入口点
5. 检查测试目录和测试覆盖

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 分析：

1. 已完成功能列表
2. 未完成功能列表
3. 已知问题和 Bug
4. 技术债务
5. 完成百分比估算

Phase 6：输出分析报告

生成或更新 PROJECT_ANALYSIS.md，包含以下章节：

# [项目名] - 项目总结与分析

> **最后更新**：YYYY-MM-DD

## 一、项目概述
（定位、目标、技术栈）

## 二、架构概览
（模块结构、关键设计决策）

## 三、当前进度
（已完成/进行中/未开始的功能）

## 四、代码质量
（构建状态、测试覆盖、代码规范）

## 五、已知问题
（Bug、技术债务、待优化项）

## 六、建议下一步
（优先级排序的待办事项）

## 七、代码统计
（文件数、代码行数、主要语言占比）

注意事项

• 如果项目已有 PROJECT_ANALYSIS.md，在原有基础上更新而非重写
• 保持中文输出
• 对于无法构建的项目（缺少环境/依赖），记录原因并跳过构建检查
• 不要修改源代码，仅读取和分析
• 如果 ROADMAP.md 存在，优先基于它分析完成度