project-advance

name	project-advance
description	准备并推进项目开发：读取 ROADMAP 识别下一批任务，批量实现（3个一组），构建测试，更新进度，提交推送。适用于用户说'准备推进项目'、'准备推进工作'等场景。

准备推进项目

从 ROADMAP 中识别下一批待实现任务，按批次高效推进开发。

触发条件

• 用户说"准备推进项目"、"准备推进工作"
• 用户说"继续推进项目"
• 用户说"阅读文档，准备推进项目"

工作流程

Phase 1：项目状态评估

1. 读取 ROADMAP.md — 获取当前进度和待办任务
2. 读取 PROJECT_ANALYSIS.md（如存在）— 了解上次分析结论
3. 检查 git log --oneline -5 — 了解最近的提交
4. 检查 git status — 确认工作区干净

Phase 2：识别下一批任务

从 ROADMAP 中提取待完成任务，按优先级排序：

1. 阻塞性问题（C1-C7 类严重 Bug）→ 最高优先级
2. 技术债务（m1-m11 类修复）→ 高优先级
3. 功能实现（按 ROADMAP Phase 顺序）→ 正常优先级
4. UI/UX 改进 → 可选

批量策略：每次选取 3 个相关任务 作为一批，使用 TodoWrite 追踪：

TodoWrite: [
  { content: "任务1", status: "in_progress" },
  { content: "任务2", status: "pending" },
  { content: "任务3", status: "pending" }
]

Phase 3：批量实现

对每个批次：

1. 标记开始：将当前任务设为 in_progress
2. 实现：编写代码、创建文件、修改现有文件
3. 标记完成：将任务设为 completed
4. 更新进度：编辑 ROADMAP.md 将对应项标记为 ✅
5. 进入下一个任务

Phase 4：构建验证

每完成一个批次后：

1. 执行构建命令（根据项目类型）
2. 如果构建失败：
   • 读取错误信息
   • 修复编译错误
   • 重新构建直到成功
3. 运行测试（如果测试套件存在）

Phase 5：文档更新

更新以下文档（如果存在）：

1. ROADMAP.md — 标记已完成的任务，更新进度摘要
2. PROJECT_ANALYSIS.md — 更新完成度百分比
3. ARCHITECTURE.md — 如果新增了模块或改变了结构

Phase 6：提交推送

1. git add 相关文件
2. 编写语义化的 commit message：
   • feat: 新功能
   • fix: Bug 修复
   • refactor: 重构
   • chore: 构建/配置变更
3. 提交并推送

批量任务管理规范

TodoWrite 格式

{
  "todos": [
    { "content": "模块名: 具体任务描述", "status": "in_progress|completed|pending", "activeForm": "简短动作描述" }
  ]
}

任务命名规范

• 功能任务：Phase X: 功能名 或 Task X.Y: 功能名
• Bug 修复：C1: 问题描述 或 m1: 问题描述
• UI 改进：U1: 改进描述

进度追踪

在 ROADMAP.md 中使用以下标记：

• ✅ 已完成
• 🔶 进行中
• ❌ 未开始
• ⚠️ 有问题

注意事项

• 每批最多 3 个任务，避免上下文过载
• 相关任务放同一批（如：数据层 + UI层 + 集成）
• 构建失败时优先修复，不要跳过
• 保持中文 commit message（与项目惯例一致）
• 如果项目没有 ROADMAP.md，先创建一个再推进