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