| name | project-advance |
| description | 准备并推进项目开发：读取 ROADMAP 识别下一批任务，批量实现（3个一组），构建测试，更新进度，提交推送。适用于用户说'准备推进项目'、'准备推进工作'等场景。 |
准备推进项目
从 ROADMAP 中识别下一批待实现任务，按批次高效推进开发。
触发条件
- 用户说"准备推进项目"、"准备推进工作"
- 用户说"继续推进项目"
- 用户说"阅读文档，准备推进项目"
工作流程
Phase 1：项目状态评估
- 读取
ROADMAP.md — 获取当前进度和待办任务
- 读取
PROJECT_ANALYSIS.md（如存在）— 了解上次分析结论
- 检查
git log --oneline -5 — 了解最近的提交
- 检查
git status — 确认工作区干净
Phase 2：识别下一批任务
从 ROADMAP 中提取待完成任务，按优先级排序：
- 阻塞性问题（C1-C7 类严重 Bug）→ 最高优先级
- 技术债务（m1-m11 类修复）→ 高优先级
- 功能实现（按 ROADMAP Phase 顺序）→ 正常优先级
- UI/UX 改进 → 可选
批量策略：每次选取 3 个相关任务 作为一批，使用 TodoWrite 追踪：
TodoWrite: [
{ content: "任务1", status: "in_progress" },
{ content: "任务2", status: "pending" },
{ content: "任务3", status: "pending" }
]
Phase 3：批量实现
对每个批次：
- 标记开始：将当前任务设为
in_progress
- 实现：编写代码、创建文件、修改现有文件
- 标记完成：将任务设为
completed
- 更新进度：编辑 ROADMAP.md 将对应项标记为 ✅
- 进入下一个任务
Phase 4：构建验证
每完成一个批次后：
- 执行构建命令（根据项目类型）
- 如果构建失败：
- 运行测试（如果测试套件存在）
Phase 5：文档更新
更新以下文档（如果存在）：
ROADMAP.md — 标记已完成的任务，更新进度摘要PROJECT_ANALYSIS.md — 更新完成度百分比ARCHITECTURE.md — 如果新增了模块或改变了结构
Phase 6：提交推送
git add 相关文件- 编写语义化的 commit message：
feat: 新功能fix: Bug 修复refactor: 重构chore: 构建/配置变更
- 提交并推送
批量任务管理规范
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，先创建一个再推进
