- 两阶段分离:设计阶段人工确认,执行阶段全自动化 - 子代理驱动:Implementer → Spec Reviewer → Quality Reviewer - 原生 Task 系统:使用 Claude Code Task 替代自定义状态管理 - 跨 Compact 恢复:PreCompact + SessionStart Hook(内联命令实现) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2.0 KiB
2.0 KiB
VibeEngineering V2 项目说明
Task 执行规范
大部分 Task 应当遵照 subagent-driven-development skill 的流程执行(协调者循环):
- 派发 Implementer 子代理实现功能
- 派发 Spec Reviewer 子代理审查规格符合性
- 派发 Code Quality Reviewer 子代理审查代码质量
- 主窗口标记 Task completed
过于简单的 Task(如单文件小改动)主代理可以自行完成,无需派发子代理,但同样需要更新 metadata。
Task metadata 规范
无论主代理自己实现还是派发子代理,都必须更新 Task metadata:
started_at: 任务开始时间completed_at: 任务完成时间files_modified: 修改的文件列表git_commit: 提交的 commit hashcommit_message: 提交信息errors_encountered: 遇到的错误及解决方案(必须如实记录)test_results: 测试结果
用途:
- 跨 Compact 恢复时,读取 metadata 了解已完成任务的执行细节
- 校验 Task 读取所有 metadata,检测是否有降级实现
- 生成 Task 快照时,保存完整的执行历史
按需读取:恢复后可按需读取各 Task 的 metadata,无需全部加载到上下文。
命令使用流程
设计阶段(需要人工确认):
/vibe-brainstorming "需求描述" → design.md
↓ 用户审核
/vibe-plan → plan.md
↓ 用户审核
执行阶段(全自动化):
/vibe-execute → 创建 Task 系统 → 协调者循环执行
跨 Compact 恢复
当上下文即将满时:
- PreCompact Hook 自动提取当前任务上下文到
.vibe/last_task_context.jsonl - Compact 后 SessionStart Hook 引导恢复
- 读取 design.md → Task JSON → last_task_context.jsonl
- 从中断点继续执行
校验 Task
最后一个 Task 是自动追加的校验 Task:
- 对比 design.md 和所有 Task metadata
- 检测降级信号("暂时跳过"、"简化实现"等)
- 运行完整测试套件
- 发现问题 → 创建修复 Task → 继续执行
- 全部通过 → 保存快照 → 标记完成