Files
VibeEngineering/.claude/CLAUDE.md
闫旭隆 c484cafb45 Initial commit: VibeEngineering V2
- 两阶段分离:设计阶段人工确认,执行阶段全自动化
- 子代理驱动:Implementer → Spec Reviewer → Quality Reviewer
- 原生 Task 系统:使用 Claude Code Task 替代自定义状态管理
- 跨 Compact 恢复:PreCompact + SessionStart Hook(内联命令实现)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-04 18:00:55 +08:00

2.0 KiB
Raw Blame History

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