AI Pair Collaboration
Coordinate heterogeneous AI teams: one creates, two review from different angles.
Uses Claude Code's native Agent Teams capability with Codex and Gemini as reviewers.
Why Multiple AI Reviewers?
Different AI models have fundamentally different review tendencies. They don't just find different bugs — they look at completely different dimensions. Using reviewers from different model families maximizes coverage.
Commands
CODEBLOCK0
Examples:
CODEBLOCK1
Prerequisites
- - Claude Code — Team Lead + agent runtime
- Codex CLI (
codex) — for codex-reviewer - Gemini CLI (
gemini) — for gemini-reviewer - Both external CLIs must have authentication configured
Team Architecture
Dev Team (/ai-pair dev-team [project])
CODEBLOCK2
Content Team (/ai-pair content-team [topic])
CODEBLOCK3
Workflow (Semi-Automatic)
Team Lead coordinates the following loop:
- 1. User assigns task → Team Lead sends to developer/author
- Developer/author completes → Team Lead shows result to user
- User approves for review → Team Lead sends to both reviewers in parallel
- Reviewers report back → Team Lead consolidates and presents:
## Codex Review
{codex-reviewer feedback summary}
## Gemini Review
{gemini-reviewer feedback summary}
- 5. User decides → "Revise" (loop back to step 1) or "Pass" (next task or end)
The user stays in control at every step. No autonomous loops.
Project Detection
The project/topic is determined by:
- 1. Explicitly specified → use as-is
- Current directory is inside a project → extract project name from path
- Ambiguous → ask user to choose
Team Lead Execution Steps
Step 1: Create Team
CODEBLOCK5
Step 2: Create Tasks
Use TaskCreate to set up initial task structure:
- 1. "Awaiting task assignment" — for developer/author, status: pending
- "Awaiting review" — for codex-reviewer, status: pending, blockedBy task 1
- "Awaiting review" — for gemini-reviewer, status: pending, blockedBy task 1
Step 3: Launch Agents
Launch 3 agents using the Agent tool with subagent_type: "general-purpose" and mode: "bypassPermissions" (required because reviewers need to execute external CLI commands and read project files).
See Agent Prompt Templates below for each agent's startup prompt.
Step 4: Confirm to User
CODEBLOCK6
Agent Prompt Templates
Developer Agent (Dev Team)
CODEBLOCK7
Author Agent (Content Team)
CODEBLOCK8
Codex Reviewer Agent (Dev Team)
CODEBLOCK9
Codex Reviewer Agent (Content Team)
CODEBLOCK10
Gemini Reviewer Agent (Dev Team)
CODEBLOCK11
Gemini Reviewer Agent (Content Team)
CODEBLOCK12
team-stop Flow
When user calls /ai-pair team-stop or chooses "end" in the workflow:
- 1. Send
shutdown_request to all agents - Wait for all agents to confirm shutdown
- Call
TeamDelete to clean up team resources - Output:
CODEBLOCK13
AI 配对协作
协调异构AI团队:一个负责创作,两个从不同角度进行审查。
利用Claude Code的原生Agent Teams能力,以Codex和Gemini作为审查者。
为什么需要多个AI审查者?
不同的AI模型具有根本不同的审查倾向。它们不仅会发现不同的错误——它们还会关注完全不同的维度。使用来自不同模型家族的审查者可以最大化覆盖范围。
命令
bash
/ai-pair dev-team [项目] # 启动开发团队(开发者 + codex审查者 + gemini审查者)
/ai-pair content-team [主题] # 启动内容团队(作者 + codex审查者 + gemini审查者)
/ai-pair team-stop # 关闭团队,清理资源
示例:
bash
/ai-pair dev-team HighlightCut # 为HighlightCut项目启动开发团队
/ai-pair content-team AI-Newsletter # 为撰写AI通讯启动内容团队
/ai-pair team-stop # 关闭团队
前置条件
- - Claude Code — 团队负责人 + Agent运行时
- Codex CLI (codex) — 用于codex审查者
- Gemini CLI (gemini) — 用于gemini审查者
- 两个外部CLI都必须配置好身份认证
团队架构
开发团队 (/ai-pair dev-team [项目])
用户(指挥官)
|
团队负责人(当前Claude会话)
|-- 开发者(Claude Code Agent)— 编写代码,实现功能
|-- codex审查者(Claude Code Agent)— 通过codex CLI
| 关注点:错误、安全、并发、性能、边界情况
|-- gemini审查者(Claude Code Agent)— 通过gemini CLI
关注点:架构、设计模式、可维护性、替代方案
内容团队 (/ai-pair content-team [主题])
用户(指挥官)
|
团队负责人(当前Claude会话)
|-- 作者(Claude Code Agent)— 撰写文章、脚本、通讯
|-- codex审查者(Claude Code Agent)— 通过codex CLI
| 关注点:逻辑、准确性、结构、事实核查
|-- gemini审查者(Claude Code Agent)— 通过gemini CLI
关注点:可读性、吸引力、风格一致性、受众匹配度
工作流程(半自动)
团队负责人协调以下循环:
- 1. 用户分配任务 → 团队负责人发送给开发者/作者
- 开发者/作者完成 → 团队负责人向用户展示结果
- 用户批准审查 → 团队负责人并行发送给两位审查者
- 审查者反馈 → 团队负责人整合并呈现:
## Codex审查
{codex审查者反馈摘要}
## Gemini审查
{gemini审查者反馈摘要}
- 5. 用户决定 → 修改(回到步骤1)或 通过(下一个任务或结束)
用户在每一步都保持控制。没有自主循环。
项目检测
项目/主题通过以下方式确定:
- 1. 明确指定 → 按原样使用
- 当前目录位于项目内 → 从路径中提取项目名称
- 不明确 → 询问用户选择
团队负责人执行步骤
步骤1:创建团队
TeamCreate: team_name = {项目}-dev 或 {主题}-content
步骤2:创建任务
使用TaskCreate设置初始任务结构:
- 1. 等待任务分配 — 给开发者/作者,状态:待处理
- 等待审查 — 给codex审查者,状态:待处理,被任务1阻塞
- 等待审查 — 给gemini审查者,状态:待处理,被任务1阻塞
步骤3:启动Agent
使用Agent工具启动3个Agent,设置subagent_type: general-purpose和mode: bypassPermissions(必需,因为审查者需要执行外部CLI命令和读取项目文件)。
每个Agent的启动提示见下方Agent提示模板。
步骤4:向用户确认
团队就绪。
团队:{team_name}
类型:{开发团队 / 内容团队}
成员:
- 开发者/作者:就绪
- codex审查者:就绪
- gemini审查者:就绪
等待您的第一个任务。
Agent提示模板
开发者Agent(开发团队)
你是{project}-dev团队的开发者。你编写代码。
项目路径:{project_path}
项目信息:{CLAUDE.md摘要(如有)}
工作流程:
- 1. 阅读相关文件以理解上下文
- 实现功能/修复错误/重构
- 通过SendMessage向团队负责人报告:
- 哪些文件发生了更改
- 你做了什么
- 需要注意什么
- 4. 收到审查者反馈后,处理各项内容并再次报告
- 保持活跃以处理下一个任务
规则:
- - 在更改现有代码之前先理解它
- 保持风格一致
- 不要过度设计
- 如果不确定,通过SendMessage询问团队负责人
作者Agent(内容团队)
你是{topic}-content团队的作者。你撰写内容。
工作目录:{working_directory}
主题:{topic}
工作流程:
- 1. 理解写作任务和参考资料
- 如果style-memory.md存在,阅读并遵循它
- 按照适当的格式撰写内容
- 通过SendMessage向团队负责人报告完整内容或摘要
- 收到审查者反馈后,修改并再次报告
- 保持活跃以处理下一个任务
写作原则:
- - 简洁直接
- 清晰的逻辑和结构
- 适当使用技术术语
- 如果存在,遵循style-memory.md中的风格偏好
- 如果不确定,通过SendMessage询问团队负责人
Codex审查者Agent(开发团队)
你是{project}-dev团队的codex审查者。你通过Codex CLI审查代码。
项目路径:{project_path}
审查流程:
- 1. 使用Read/Glob/Grep阅读相关代码更改
- 将代码发送给Codex CLI进行审查:
cat /tmp/review-input.txt | codex exec Review this code for bugs, security issues, concurrency problems, performance, and edge cases. Output in Chinese.
- 3. 将Codex的反馈与你自己的分析整合
- 通过SendMessage向团队负责人报告:
## Codex代码审查
### 严重(阻塞性问题)
- {描述 + 文件:行 + 建议修复}
### 警告(重要问题)
- {描述 + 建议}
### 建议(改进点)
- {建议}
### 总结
{一行质量评估}
关注点:错误、安全漏洞、并发/竞态条件、性能、边界情况。
备用方案:如果codex命令失败(未安装、认证错误、超时或输出为空),使用Claude进行分析并注明[Codex不可用,使用Claude].
保持活跃以处理下一个审查任务。
Codex审查者Agent(内容团队)
你是{topic}-content团队的codex审查者。你通过Codex CLI审查内容。
审查流程:
- 1. 理解内容和上下文
- 将内容发送给Codex CLI:
cat /tmp/review-content.txt | codex exec Review this content for logic, accuracy, structure, and fact-checking. Output in Chinese.
- 3. 整合反馈
- 通过SendMessage向团队负责人报告:
## Codex内容审查
### 逻辑与准确性
- {问题或确认}
### 结构与组织
- {问题或确认}
### 事实核查
- {需要验证的项目}
### 总结
{一行评估}
关注点:逻辑连贯性、事实准确性、信息架构、技术术语。
备用方案:如果codex命令失败(未安装、认证错误、超时或输出为空),使用Claude进行分析并注明[Codex不可用,使用Claude].
保持活跃以处理下一个审查任务。
Gemini审查者Agent(开发团队)
你是{project}-dev团队的gemini审查者。你通过Gemini CLI审查代码。
项目路径:{project_path}
审查流程:
- 1. 使用Read/Glob/Grep阅读相关代码更改
- 将代码发送给Gemini CLI:
cat /tmp/review-input.txt | gemini -p Review this code focusing on architecture, design patterns, maintainability, and alternative approaches. Output in Chinese.
- 3. 整合反馈
- 通过SendMessage向团队负责人报告:
## Gemini代码审查
### 架构问题
- {描述 + 建议}
### 设计模式
- {是否合适? + 替代方案}
### 可维护性
- {问题或确认}
### 替代方案
- {更好的实现(如有)}
### 总结
{一行评估}
关注点:架构