多工作流融合 x10 倍效率提升：多模型 Agent 编排 + Hooks Loop

星纬智联技术2026-01-24 9:38

do：多模型 Agent 编排 + Hooks Loop

把 /dev、/omo、ralph-loop、/feature-dev 四套工作流融合成一个、多 Agent 并行、多模型后端的功能开发编排器。

TL;DR

  • • • 一句话启动 ：/do 实现用户登录功能，剩下的交给 AI

  • • • 7 阶段完整覆盖：Discovery → Exploration → Clarification → Architecture → Implementation → Review → Summary

  • • • 多 Agent 并行：code-explorer、code-architect、code-reviewer、develop 各司其职

  • • • 多模型后端：分析用 grok-code，架构用 opus4.5，代码用 gpt5.2，按任务特性分配最优模型，可以自定义配置

  • • • Loop 机制保障：Stop Hook 阻止意外退出，确保流程完整执行

    复制代码 
    do 整体架构Hooks Loop 机制codeagent-wrapper 多 Agent

    Phase 1-2
    Phase 1,3,4
    Phase 5
    Phase 6-7
    检查状态
    .claude/do.local.md用户: /do 任务描述Claude Code 编排器code-explorergrok-codecode-architectopus4.5developgpt5.2code-reviewersonnetStop Hook 防中断

为什么做这个融合？

继 /dev /omo 之后一直在思考如何将这些好用的工作流融合起来，够快够智能够好用

      1. 需要 dev 的快、简单
      1. 需要 omo 的多模型 agent 编排
      1. 需要 ralph-loop 能够保证任务最终完成
      1. 需要主动沟通确定方案

基于上面的内容我突然想到把他们全部融合在一起不就好了吗，于是就有了 do。

Do 的核心参考来源：

来源 贡献
feature-dev 7 阶段工作流框架 + Agent 分工 + Context Pack 模板
dev 需求澄清机制 + 多后端路由 + 90% 覆盖率要求
omo 路由优先编排 + 最小 Agent 集选择 + 编排者不写代码原则
ralph-loop Stop Hook 防中断 + 状态文件持久化 + 完成信号机制

这不是重新发明轮子，而是把四个好轮子装到一辆车上。

复制代码 
  四套工作流
feature-dev7阶段框架dev 需求澄清+多后端omo路由编排ralph-loopHooks Loop融合do Skill

核心设计：编排者不写代码

这个设计来自 omo 的核心理念。do 的第一条铁律：

复制代码 
  Claude Code 只负责编排，所有代码变更必须委托给 codeagent-wrapper 中的 Agent。

这不是因为 Claude Code 写不了代码，而是因为：

  • • • 职责分离：编排者专注流程控制，执行者专注代码质量

  • • • 模型专长：不同 Agent 可以用不同后端（Codex、Claude、Gemini）

  • • • 可追溯性：每个 Agent 的输出都有独立日志和上下文

    复制代码 
    # 这是编排者的正确姿势

    codeagent-wrapper --agent develop - . <<'EOF'

    Original User Request

    /do 添加用户登录功能

    Context Pack

    • Code-explorer output: [Phase 2 分析结果]
    • Code-architect output: [Phase 4 架构方案]

    Current Task

    实现登录功能，遵循现有模式

    Acceptance Criteria

    端到端可用；测试通过；diff 最小化
    EOF

    复制代码 
    codeagent-wrapper 执行者Claude Code 编排者

    委托任务 + Context Pack
    委托任务 + Context Pack
    委托任务 + Context Pack
    委托任务 + Context Pack
    返回结果
    返回结果
    返回结果
    返回结果
    只负责流程控制不写代码code-explorercode-architectcode-reviewerdevelop

7 阶段工作流详解

Phase 1: Discovery - 理解需求

目标：搞清楚要做什么。

不是直接开干，而是先用 AskUserQuestion 问清楚：

  • • • 用户可见的行为是什么？
  • • • 范围边界在哪？
  • • • 验收标准是什么？

然后调用 code-architect 生成需求清单和澄清问题。

复制代码 
  codeagent-wrapper --agent code-architect - . <<'EOF'
## Current Task
Produce requirements checklist and identify missing information.
Output: Requirements, Non-goals, Risks, Acceptance criteria, Questions (<= 10)

## Acceptance Criteria
Concrete, testable checklist; specific questions; no implementation.
EOF

Phase 2: Exploration - 探索代码库

目标：搞清楚现有代码怎么写的。

Image

这里体现了 并行优先 原则------三个 code-explorer 任务同时跑：

复制代码 
  codeagent-wrapper --parallel <<'EOF'
---TASK---
id: p2_similar_features
agent: code-explorer
workdir: .
---CONTENT---
Find 1-3 similar features, trace end-to-end.
Return: key files with line numbers, call flow, extension points.

---TASK---
id: p2_architecture
agent: code-explorer
workdir: .
---CONTENT---
Map architecture for relevant subsystem.
Return: module map + 5-10 key files.

---TASK---
id: p2_conventions
agent: code-explorer
workdir: .
---CONTENT---
Identify testing patterns, conventions, config.
Return: test commands + file locations.
EOF

三个探索任务并行执行，结果合并后传递给下一阶段。

复制代码 
  Phase 2: 并行探索
p2_similar_features找相似功能p2_architecture映射架构p2_conventions识别规范Phase 1 完成合并结果Phase 3: Clarification

Phase 3: Clarification - 澄清疑问（强制阶段）

目标：解决所有模糊点。

这是 不可跳过 的阶段。Phase 1 和 Phase 2 的输出汇总后，让 code-architect 生成优先级排序的问题列表，然后用 AskUserQuestion 逐一确认。

复制代码 
  ## 澄清问题

1. 登录失败时，错误信息是否需要区分"用户不存在"和"密码错误"？
2. 是否需要支持"记住我"功能？
3. 密码重置流程是否在本次范围内？

不回答不进入下一阶段。这是从 ralph-loop 学来的------宁可多问，不要猜错。

Phase 4: Architecture - 设计方案

目标：确定怎么实现。

同样是并行模式------两个 code-architect 同时工作，提出两种方案：

Image

方案 特点
minimal-change 复用现有抽象，最小化新文件
pragmatic-clean 引入测试友好的接缝，更好的可维护性
复制代码 
  codeagent-wrapper --parallel <<'EOF'
---TASK---
id: p4_minimal
agent: code-architect
workdir: .
---CONTENT---
Propose minimal-change architecture: reuse existing abstractions.
Output: file touch list, risks, edge cases.

---TASK---
id: p4_pragmatic
agent: code-architect
workdir: .
---CONTENT---
Propose pragmatic-clean architecture: introduce seams for testability.
Output: file touch list, testing plan, risks.
EOF

用户选择后，进入实现阶段。

复制代码 
  Phase 4: 两种架构方案
minimal-change复用现有抽象最小化新文件风险低pragmatic-clean引入测试接缝更好可维护性更多改动Phase 2 探索结果用户选择Phase 5: Implementation

Phase 5: Implementation - 实现（需审批）

目标：把代码写出来。

这个阶段有个 显式审批门：

复制代码 
  用 AskUserQuestion 确认：
"Approve starting implementation?"
- Approve
- Not yet

批准后，调用 develop Agent 执行：

Image

复制代码 
  codeagent-wrapper --agent develop - . <<'EOF'
## Context Pack
- Code-explorer output: [Phase 2 全部输出]
- Code-architect output: [Phase 4 选定方案 + Phase 3 答案]

## Current Task
Implement with minimal change set following chosen architecture.
- Follow Phase 2 patterns
- Add/adjust tests per Phase 4 plan
- Run narrowest relevant tests

## Acceptance Criteria
Feature works end-to-end; tests pass; diff is minimal.
EOF

Phase 6: Review - 代码审查

目标：抓 bug、砍复杂度。

两个 code-reviewer 并行工作：

审查者 关注点
correctness 正确性、边界情况、失败模式
simplicity KISS 原则、消除冗余抽象
复制代码 
  codeagent-wrapper --parallel <<'EOF'
---TASK---
id: p6_correctness
agent: code-reviewer
workdir: .
---CONTENT---
Review for correctness, edge cases, failure modes.
Assume adversarial inputs.

---TASK---
id: p6_simplicity
agent: code-reviewer
workdir: .
---CONTENT---
Review for KISS: remove bloat, collapse needless abstractions.
EOF

审查结果出来后，用户决定：

  • • • Fix now（现在修）
  • • • Fix later（以后修）
  • • • Proceed as-is（直接过）

Phase 7: Summary - 总结文档

目标：记录做了什么。

最后一个 code-reviewer 调用，生成完成报告：

  • • • 做了什么
  • • • 关键决策和取舍
  • • • 修改的文件路径
  • • • 验证命令
  • • • 后续工作（可选）

完成后输出完成信号：

复制代码 
  <promise>DO_COMPLETE</promise>

    
    
    
  
Phase 1Discovery理解需求Phase 2Exploration探索代码库Phase 3Clarification澄清疑问Phase 4Architecture设计方案Phase 5Implementation实现代码Phase 6Review代码审查Phase 7Summary总结文档✓ FEATURE_COMPLETE

多模型后端：按任务选模型

codeagent-wrapper 支持为不同 Agent 配置不同后端。在 ~/.codeagent/models.json 中：

复制代码 
  {
  "agents": {
    "code-explorer": {
      "backend": "opencode",
      "model": "opencode/grok-code",
      "description": "快速代码分析"
    },
    "code-architect": {
      "backend": "claude",
      "model": "claude-opus-4-5-20251101",
      "description": "深度架构设计"
    },
    "code-reviewer": {
      "backend": "claude",
      "model": "claude-sonnet-4-5-20250929",
      "description": "代码审查"
    },
    "develop": {
      "backend": "codex",
      "model": "gpt-5.2",
      "description": "代码实现"
    }
  }
}

为什么这样分配？

Agent 推荐后端 原因
code-explorer grok-code 快速遍历、代价低
code-architect opus4.5 需要深度思考、权衡取舍
code-reviewer sonnet 平衡速度和质量
develop gpt-5.2 代码生成能力强、执行稳定
复制代码 
  可用后端~/.codeagent/models.json
code-explorer→ grok-codecode-architect→ opus4.5code-reviewer→ sonnetdevelop→ gpt5.2codexclaudegeminiopencode

Loop 机制：防止中途退出

这是从 ralph-loop 借鉴的核心机制。

状态文件

每次 /do 启动时，创建 .claude/do.local.md：

复制代码 
  ---
active: true
current_phase: 1
phase_name: "Discovery"
max_phases: 7
completion_promise: "<promise>DO_COMPLETE</promise>"
---

每完成一个阶段，更新 current_phase 和 phase_name。

Stop Hook

安装后会注册 Stop Hook。当 Claude 尝试退出时：

复制代码 
  # hooks/stop-hook.sh 核心逻辑
if [ "$phases_done" -eq 0 ]; then
  reason="feature-dev 循环未完成：当前阶段 ${current_phase}/${max_phases}..."
  printf '{"decision":"block","reason":"%s"}\n' "$reason"
fi

如果还没完成，Hook 会 阻止退出 并提示继续执行。

强制退出方式 ：将状态文件中 active 设为 false。

复制代码 
  /do 启动
current_phase=2
current_phase=3
current_phase=4
current_phase=5
current_phase=6
current_phase=7
输出 FEATURE_COMPLETE
尝试退出
尝试退出
尝试退出
尝试退出
尝试退出
尝试退出
否(钩子阻止 / 留在当前阶段)
是(允许退出 / 跳过剩余阶段)
Phase1Phase2Phase3Phase4Phase5Phase6Phase7CompleteTryStop <>尝试优雅退出？TryStop

安装与使用

前置条件

      1. 安装 codeagent-wrapper：

      git clone https://github.com/cexll/myclaude.git
      bash ./install.sh

      1. 配置至少一个后端 CLI：
    1. • codex（OpenAI Codex CLI）
    1. • claude（Claude Code CLI）
    1. • gemini（Gemini CLI）

安装 Skill

复制代码 
  python install.py --module do

安装内容：

  • • • ~/.claude/skills/do/ - Skill 文件
  • • • Hooks 自动合并到 ~/.claude/settings.json

使用

复制代码 
  # 在 Claude Code 中
/do 添加用户登录功能
/do 实现订单导出 CSV
/do feature-prd.md

卸载

复制代码 
  python install.py --uninstall --module do

自定义 Agent Prompt

Agent 提示词位于 ~/.claude/skills/do/agents/ 目录：

  • • • code-explorer.md - 代码追踪、架构映射
  • • • code-architect.md - 方案设计、文件规划
  • • • code-reviewer.md - 代码审查、简化建议

如需自定义，在 ~/.codeagent/agents/ 创建同名文件覆盖。

复制代码 
  自定义覆盖默认 Agent 配置
优先级更高
~/.claude/skills/do/agents/code-explorer.mdcode-architect.mdcode-reviewer.md~/.codeagent/agents/同名文件覆盖

总结

do 是四套工作流的合体：

  • • • feature-dev 的 7 阶段框架和 Agent 分工
  • • • dev 的需求澄清和多后端路由
  • • • omo 的智能路由和编排者不写代码原则
  • • • ralph-loop 的状态持久化和防中断机制

加上 codeagent-wrapper 的多后端支持，你可以：

      1. 用一条命令启动完整的功能开发流程
      1. 让不同模型各展所长
      1. 通过并行执行提升效率
      1. 借助 Loop 机制确保流程完整

我做的工作就是把这些优秀的设计拼到一起，形成一套可复制的 AI 编排方法论。

想学会自己写这样的 Skill？

这篇文章展示了 do 的设计思路，但如果你想：

  • • • 深入理解 Claude Code Skill 的完整机制
  • • • 学会设计多 Agent 编排工作流
  • • • 掌握 codeagent-wrapper 的高级用法
  • • • 构建适合你团队的定制化开发流程

欢迎关注 VibeCoding 企业课程。

我们会手把手教你：

  • • • Claude Code Skill 从零到一
  • • • 多模型后端配置与调优
  • • • Stop Hook 和状态机设计
  • • • 真实项目中的 AI 工程实践
相关推荐
qq77788892 小时前
一站式工具箱，成AI智能抠图、证件照制作、人声分离、视频插帧、超分放大、格式转换、压缩、拼接等30+硬核功能
经验分享
一轮弯弯的明月2 小时前
TCP连接管理（三次握手与四次挥手）
网络·经验分享·笔记·网络协议·tcp/ip·学习心得
Quintus五等升12 小时前
深度学习④|分类任务—VGG13
人工智能·经验分享·深度学习·神经网络·学习·机器学习·分类
诸葛成14 小时前
渗透测试-信息收集
经验分享·笔记·课程设计
源代码•宸14 小时前
Leetcode—509. 斐波那契数【简单】
经验分享·算法·leetcode·面试·golang·记忆化搜索·动规
联蔚盘云17 小时前
全球生成式人工智能的安全合规前瞻
经验分享
数据轨迹00118 小时前
ICCV MK-UNet：多核深度可分离卷积医学分割
经验分享·笔记·facebook·oneapi·twitter
Quintus五等升20 小时前
深度学习③|分类任务—AlexNet
人工智能·经验分享·深度学习·神经网络·学习·机器学习·cnn
方见华Richard21 小时前
认知几何学：思维如何弯曲意义空间V0.3
人工智能·经验分享·交互·原型模式·空间计算
热门推荐
01GitHub 镜像站点02OpenCode 入门教程：介绍 · 安装 · 配置第三方 API (如 Claude)03Claude Code Skills 实用使用手册04UV安装并设置国内源05在VSCode配置Java开发环境的保姆级教程（适配各类AI编程IDE）06BongoCat - 跨平台键盘猫动画工具07安娜的档案(Anna’s Archive) 镜像网站/国内最新可访问入口（持续更新）08AI 规范驱动开发“三剑客”深度对比：Spec-Kit、Kiro 与 OpenSpec 实战指南09Linux下V2Ray安装配置指南10Open Code教程（四）| 高级配置与集成