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. 全部通过 → 保存快照 → 标记完成
|