双模型协作编码循环

技能文档

---
name: bear2u-codex-claude-loop
title: 双模型协作编码循环
description: 编排「规划实施 + 独立审校」的双智能体协作循环：主智能体负责架构、规划与编码实现，独立审校模型负责方案验证与代码审查，持续互审直到质量达标。当用户要求双模型互审、交叉审查代码质量、实施方案先验证再执行、迭代式审查改进、建立自纠错编码流程时触发。
category: 开发工具
---

# 双模型协作编码循环

实现一个均衡的工程协作循环：一方专注架构与执行，另一方独立验证与审查，双方持续互审、互相交接上下文，产出高质量代码。

## 核心角色

- **主智能体（实施方）**：负责架构设计、任务规划与代码实现
- **审校智能体（独立第二模型）**：通过只读方式对方案与代码做验证与审查，可用任一具备只读执行能力的模型 CLI 承担
- **持续互审**：每次变更后互相审查对方的工作
- **上下文交接**：始终从最近一次完成清理的一方继续

## 技能工作流

### 步骤1：规划

1. 为任务制定详细计划
2. 把实现拆解为清晰的步骤
3. 记录假设条件与潜在问题
4. 以结构化格式输出计划

### 步骤2：方案验证

把计划发给审校智能体验证。向用户确认审校模型与推理力度（低/中/高）后，通过审校 CLI 的只读沙箱执行，审查要点：

- 逻辑错误
- 遗漏的边界情况
- 架构缺陷
- 安全隐患

示例（以审校 CLI 为 `review-cli` 占位，按实际工具替换）：

```bash
echo "Review this implementation plan and identify any issues:
[实施方计划全文]
Check for: logic errors, missing edge cases, architecture flaws, security concerns" \
  | review-cli exec --sandbox read-only
```

收集审校方的反馈意见。

### 步骤3：反馈循环

审校发现问题时：

1. 向用户汇总审校意见
2. 按反馈修订计划
3. 询问用户：「修订计划并重新验证，还是直接带着修复继续？」
4. 必要时回到步骤2

### 步骤4：执行实现

方案通过验证后：

1. 主智能体用可用的文件读写工具实现代码
2. 把实现拆解为可管理的小步骤
3. 每步谨慎执行并妥善处理错误
4. 记录实现了哪些内容

### 步骤5：变更后交叉审查

每次变更后：

1. 把实现发给审校智能体复查：缺陷检测、性能问题、最佳实践、安全漏洞
2. 主智能体分析审校意见并决策：
   - 关键问题立即修复
   - 涉及架构调整时先与用户讨论
   - 记录已做的决策

### 步骤6：迭代改进

1. 主智能体根据审查意见完成修复
2. 重大修改送回审校方复验（可复用上一次审校会话的模型与沙箱设置继续会话）
3. 循环直到达到质量标准

```bash
echo "Review the updated implementation" | review-cli exec resume --last
```

**注意**：续会继承原会话的全部设置（模型、推理力度、沙箱）。

## 问题修复流程

审校发现问题：

1. 主智能体分析根因
2. 用可用工具实施修复
3. 把更新后的代码送回审校方验证
4. 重复直到验证通过

实现出错：

1. 主智能体复盘错误
2. 调整实现策略
3. 继续推进前先重新验证

## 最佳实践

- **执行前必须验证方案**
- **变更后绝不跳过交叉审查**
- **双方交接清晰**，记录谁做了什么
- **善用会话续接**保存审校状态

## 命令速查

| 阶段 | 命令模式（占位符按实际工具替换） | 用途 |
|-------|----------------|---------|
| 验证方案 | `echo "plan" \| review-cli exec --sandbox read-only` | 编码前检查逻辑 |
| 实现 | 主智能体使用文件读写工具 | 执行通过验证的方案 |
| 审查代码 | `echo "review changes" \| review-cli exec --sandbox read-only` | 审校方复查实现 |
| 继续审查 | `echo "next step" \| review-cli exec resume --last` | 续接审校会话 |
| 应用修复 | 主智能体使用文件读写工具 | 修复审校发现的问题 |
| 复验 | `echo "verify fixes" \| review-cli exec resume --last` | 修复后再次核验 |

## 错误处理

1. 审校命令非零退出码时停止
2. 汇总审校意见并向用户请示方向
3. 出现以下情况时，实施变更前先与用户确认方案：
   - 需要重大架构调整
   - 将影响多个文件
   - 涉及破坏性变更
4. 审校产生警告时，评估严重度再决定下一步

## 完美循环

```
规划（实施方） → 验证方案（审校方） → 反馈 →
实现（实施方） → 审查代码（审校方） →
修复问题（实施方） → 复验（审校方） → 循环直至完善
```

由此形成自纠错的高质量工程系统：

- **实施方**负责全部代码实现与修改
- **审校方**提供验证、审查与质量保障

使用说明

# 双模型协作编码循环

编排「规划实施 + 独立审校」的双智能体协作循环，持续互审直到代码质量达标。

## 能做什么

- 六阶段工作流：规划 → 方案验证 → 反馈循环 → 实现 → 交叉审查 → 迭代改进
- 主智能体负责架构与编码，独立审校模型负责验证与复查
- 方案先验证再执行，每次变更后强制交叉审查
- 支持复用审校会话（模型与沙箱设置继承）
- 形成自纠错的高质量工程闭环

## 何时使用

- 要求方案先验证、代码必互审的工程流程
- 双模型交叉审查提升代码质量
- 建立可自纠错的迭代开发循环

## 快速上手

```text
用双模型循环实现 xxx 功能：你负责规划与编码，把方案和代码交给审校模型验证
```

审校方由任一具备只读执行能力的模型 CLI 承担，命令占位符按实际工具替换。

## 目录结构

- `SKILL.md`：协作循环工作流与命令速查

如何安装此技能？

访问技能市场，点击「安装」按钮，按提示将技能包放入 AI 编程助手的 skills 目录即可。