duoduo

Duo Review - 双 Agent 交叉审查

1. 启动检测 ⚠️

执行 echo $RUNNER 检测环境变量：

有输出 → Orchestrator daemon 启动，直接执行阶段流程

无输出 → 用户直接启动（终端 droid），进入交互模式：

1. 执行 gh pr view --json id,number,baseRefName,headRefName,headRepositoryOwner,headRepository 获取 PR 信息

2. 向用户确认："检测到 PR #XX (head → base)，开始审查？"

3. 用户确认后，先 export 环境变量再执行 duo-cli init：

   export RUNNER=droid
   export DROID_REPO="owner/repo"
   export DROID_PR_NUMBER=123
   export DROID_BRANCH="feat/xxx"
   export DROID_BASE="main"
   export DROID_PR_NODE_ID="PR_kwXXX"
   duo-cli init
   

4. 若检测不到 PR，询问用户输入 PR 编号

⚠️ 执行 duo-cli init 后立即停止！

duo-cli init 会启动 Orchestrator daemon（有 FIFO），由 daemon 执行后续所有阶段。 当前终端 droid 没有 FIFO，无法接收 Agent 消息，禁止继续执行任何 duo-cli 命令。

可选：告知用户 "Orchestrator 已启动，可用 tail -f /tmp/duo-xxx.log 查看进度"

2. 角色

3. 流程总览

flowchart TD
    Start([开始]) --> S1[阶段 1: 并行 PR 审查]
    S1 --> S2{阶段 2: 判断共识}
    
    S2 -->|both_ok| S5[阶段 5: 汇总]
    S2 -->|same_issues| S4[阶段 4: 修复验证]
    S2 -->|divergent| S3[阶段 3: 交叉确认]
    
    S3 -->|共识: 无需修复| S5
    S3 -->|共识: 需修复| S4
    S3 -->|5轮未达成| S5
    
    S4 -->|验证通过| S5
    S4 -->|5轮未通过| S5
    
    S5 --> End([结束])

阶段执行

每个阶段执行前，必须先读取对应角色的 stages/ 文件获取详细指令！

4. 通信架构

flowchart TB
    subgraph Agents
        Orchestrator[Orchestrator<br/>监督者]
        Opus[Opus<br/>Claude Opus 4.5]
        Codex[Codex<br/>GPT-5.2]
        
        Opus <-->|FIFO| Codex
        Orchestrator <-->|FIFO| Opus
        Orchestrator <-->|FIFO| Codex
    end
    
    SQLite[(SQLite<br/>消息记录)]
    Agents --> SQLite
    
    Agents -->|UI| PR[PR Comments]

• 阶段 1-2：Opus/Codex → Orchestrator（汇报结果）
• 阶段 3：Opus ↔ Codex 直接对话（交叉确认）
• SQLite - 所有消息自动记录
• 评论 = 纯 UI（给人看）

消息格式

Agent 间消息（duo-cli send 自动包裹 <MESSAGE> 标签）：

# 发送时只需写消息内容
duo-cli send orchestrator "审查完成，无问题"

# duo-cli 会自动包裹为：
# <MESSAGE from="opus" to="orchestrator">
# 审查完成，无问题
# </MESSAGE>

用户 @Mention（由 workflow 注入，不包裹）：

<USER_MENTION repo="owner/repo" pr="123" author="username">
用户评论内容...
</USER_MENTION>

回复用户（通过 PR 评论，不是 FIFO）：

duo-cli comment post "回复内容"

PR 评论（给人看，必须包含 HTML 注释标识）：

<!-- duo-{agent}-{type} -->
## <img src='...' width='18' /> {Title}
> 🕐 {TIMESTAMP}

{内容}

常用标识：duo-opus-r1, duo-codex-r1, duo-opus-fix, duo-codex-verify, duo-summary, duo-mention-reply

5. Orchestrator 行为规范

角色：监督者 + 仲裁者

• 启动流程，分配任务
• 监控进度（通过 duo-cli messages 查询）
• 在僵局时介入仲裁

禁止：

• 读取 PR diff、REVIEW.md、代码文件
• 等待 Agent 时执行任何命令（FIFO 消息会丢失！）

必须：

• 启动 Agent 后直接回复"等待中..."然后结束回复
• Agent 结果会自动作为新消息发来

6. CLI 命令

7. 状态 Keys

# 元信息
stage               当前阶段 (1-5 或 done)
runner              droid | workflow
pr_node_id          PR GraphQL ID

# Session（duo-cli spawn 自动管理）
{agent}:session, {agent}:fifo, {agent}:pid, {agent}:log, {agent}:model

# 阶段 2
s2:result           both_ok | same_issues | divergent

# 阶段 4
s4:branch, s4:round

# @Mention
mention:status      idle | processing | done

8. @Mention 处理

收到 <USER_MENTION> 消息时，读取 stages/0-mention-orchestrator.md。