Omo Ofr Agents

跳过启发（优先考虑显式风险信号）

• 跳过 ofr-explore：用户已提供确切文件路径+行号，或你已从上下文获得。
• 跳过 ofr-oracle：变更是局部+低风险的（单区域、明确修复、无权衡）。
• 跳过实现代理：用户只想要分析/答案（在 ofr-explore/ofr-librarian 后停止）。

常见食谱（示例，非规则）

核心定位：Idea 阶段的知识引擎

关键洞察：在 Idea 阶段，大模型必须充分理解创新点和现有架构，这样生成的论文架构才能最正确。

本套件是 ofr-pipeline Idea 阶段的核心支撑，通过多代理协作确保：

1. 创新点理解到位 → ofr-librarian 深度分析论文贡献
2. 现有架构理解到位 → ofr-explore 精确定位 BasicOFR 结构
3. 集成方案正确 → ofr-oracle 基于双重理解做出最优决策

┌─────────────────────────────────────────────────────────────────┐
│              Idea 阶段：omo-ofr-agents 核心战场                   │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  ┌─────────────────────────────────────────────────────────┐   │
│  │ 创新点理解层                                              │   │
│  │ ofr-librarian: 论文去魅 → 贡献点提取 → novelty 评估        │   │
│  │ ofr-multimodal-looker: 读架构图 → 理解模块关系            │   │
│  └────────────────────────┬────────────────────────────────┘   │
│                           ↓                                     │
│  ┌─────────────────────────────────────────────────────────┐   │
│  │ 现有架构理解层                                            │   │
│  │ ofr-explore: RTN/RRTN/MambaOFR 定位 → 注册点/forward/IO   │   │
│  │ ofr-explore: ideas/ 已有实现 → 可复用模式                  │   │
│  └────────────────────────┬────────────────────────────────┘   │
│                           ↓                                     │
│  ┌─────────────────────────────────────────────────────────┐   │
│  │ 集成决策层                                                │   │
│  │ ofr-oracle: Baseline 选择 → 集成点设计 → 消融矩阵          │   │
│  │             → diff_plan.json 生成                         │   │
│  └────────────────────────┬────────────────────────────────┘   │
│                           ↓                                     │
│  ┌─────────────────────────────────────────────────────────┐   │
│  │ 代码生成层                                                │   │
│  │ ofr-codegen: 按 diff_plan 生成 → 4 项验证 → 90 分门禁      │   │
│  └─────────────────────────────────────────────────────────┘   │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘
                              ↓
┌─────────────────────────────────────────────────────────────────┐
│                    exp 阶段: 训练与评估                           │
│  ├── ofr-exp-train       ← ofr-visualization-engineer Debug     │
│  │                       ← ofr-remote-operator 远程执行          │
│  └── ofr-exp-test        ← ofr-multimodal-looker 结果分析        │
└─────────────────────────────────────────────────────────────────┘
                              ↓
┌─────────────────────────────────────────────────────────────────┐
│                    paper 阶段: 论文生成                           │
│  ├── ofr-paper-table     ← ofr-paper-writer 辅助                 │
│  └── ofr-paper-generate  ← ofr-paper-writer 主力                 │
└─────────────────────────────────────────────────────────────────┘

Idea 阶段的代理协作流程

用户输入: arXiv ID / 论文 / GitHub
                ↓
    ┌──────────────────────┐
    │   ofr-librarian      │  ← 论文"去魅"，提取工程本质
    │   - 核心创新点       │
    │   - 可迁移模块       │
    │   - novelty 评估     │
    └──────────┬───────────┘
               ↓
    ┌──────────────────────┐
    │   ofr-explore        │  ← 理解 BasicOFR 现有架构
    │   - ARCH_REGISTRY    │
    │   - Baseline 结构    │
    │   - ideas/ 已有实现  │
    └──────────┬───────────┘
               ↓
    ┌──────────────────────┐
    │   ofr-oracle         │  ← 基于双重理解做决策
    │   - Baseline 选择    │
    │   - 集成点设计       │
    │   - diff_plan.json   │
    └──────────┬───────────┘
               ↓
    ┌──────────────────────┐
    │   ofr-codegen        │  ← 执行代码生成
    │   - 按 diff_plan     │
    │   - 4 项验证         │
    │   - 90 分门禁        │
    └──────────────────────┘

为什么 Idea 阶段需要多代理？

代理调用格式

codeagent-wrapper --agent <agent_name> - <workdir> <<'EOF'
## Original User Request
<原始请求>

## Context Pack (include anything relevant; write "None" if absent)
- Explore output: <...>
- Librarian output: <...>
- Oracle output: <...>
- Known constraints: <测试命令、时间预算、仓库规范等>

## Current Task
<具体任务描述>

## Acceptance Criteria
<明确的完成条件>
EOF

在 shell 工具中执行，超时 2h。

代理一览

多模型协作架构

核心理念：不同大模型各有所长，让最擅长的模型做最擅长的事。

┌─────────────────────────────────────────────────────────────────────────────┐
│                    多模型协作 - 实际可用配置                                   │
├─────────────────────────────────────────────────────────────────────────────┤
│                                                                             │
│  ┌─────────────────────────────────────────────────────────────────────┐   │
│  │ Claude (Anthropic) ─ 推理与写作 [付费]                               │   │
│  │ ├── Opus 4.5:   ofr-sisyphus, ofr-oracle ← 最强推理/架构决策        │   │
│  │ └── Sonnet 4.5: ofr-librarian, ofr-paper-writer, ofr-codegen,       │   │
│  │                 ofr-explore, ofr-remote-operator                    │   │
│  └─────────────────────────────────────────────────────────────────────┘   │
│                                                                             │
│  ┌─────────────────────────────────────────────────────────────────────┐   │
│  │ Gemini (Google) ─ 多模态理解 [免费额度]                              │   │
│  │ └── 2.0-Flash:  ofr-visualization-engineer, ofr-multimodal-looker   │   │
│  │                 ← 多模态理解/读图                                     │   │
│  └─────────────────────────────────────────────────────────────────────┘   │
│                                                                             │
│  ┌─────────────────────────────────────────────────────────────────────┐   │
│  │ DeepSeek [可选] ─ 低成本替代 [便宜]                                  │   │
│  │ └── Coder-V2:   ofr-codegen, ofr-explore (budget mode)             │   │
│  │                 ← 价格约 Claude 的 1/10                              │   │
│  └─────────────────────────────────────────────────────────────────────┘   │
│                                                                             │
└─────────────────────────────────────────────────────────────────────────────┘

成本优化方案

为什么选择这种模型分配？

并行执行优化

效率提升：无依赖的代理可以并行运行，大幅缩短总耗时。

可并行的任务组

┌─────────────────────────────────────────────────────────────────┐
│ idea_understanding 并行组（最多 3 个并发）                         │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│   ┌─────────────┐   ┌─────────────┐   ┌─────────────────────┐   │
│   │ ofr-librarian│   │ ofr-explore │   │ofr-multimodal-looker│   │
│   │ (Claude)    │   │ (OpenCode)  │   │ (Gemini)            │   │
│   │             │   │             │   │                     │   │
│   │ 读论文      │   │ 读代码      │   │ 读架构图            │   │
│   └──────┬──────┘   └──────┬──────┘   └──────────┬──────────┘   │
│          │                 │                      │              │
│          └─────────────────┼──────────────────────┘              │
│                            ↓                                     │
│                   ┌─────────────────┐                           │
│                   │   ofr-oracle    │  ← 汇总后做决策            │
│                   │   (Claude Opus) │                           │
│                   └─────────────────┘                           │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

并行执行示例

# Sisyphus 可以同时启动多个代理
# Step 1: 并行启动 3 个理解任务
codeagent-wrapper --agent ofr-librarian - . <<'EOF' &
[论文分析任务]
EOF

codeagent-wrapper --agent ofr-explore - . <<'EOF' &
[代码定位任务]
EOF

codeagent-wrapper --agent ofr-multimodal-looker - . <<'EOF' &
[架构图分析任务]
EOF

# 等待全部完成
wait

# Step 2: 汇总后调用 oracle
codeagent-wrapper --agent ofr-oracle - . <<'EOF'
## Context Pack
- Librarian output: [并行任务1结果]
- Explore output: [并行任务2结果]
- Multimodal output: [并行任务3结果]

## Current Task
基于以上理解，制定集成方案
EOF

串行 vs 并行对比

示例

Sisyphus 执行：

单步: ofr-librarian（只需文献分析，无代码变更）

codeagent-wrapper --agent ofr-librarian - /path/to/BasicOFR <<'EOF'
## Original User Request
分析 arXiv:2501.04486 这篇论文是否适合集成到 BasicOFR

## Context Pack
- Explore output: None
- Librarian output: None
- Oracle output: None

## Current Task
阅读论文，梳理创新点，评估与老电影退化场景的匹配度，判断是否适合 BasicOFR。

## Acceptance Criteria
输出：论文摘要、核心创新、与 OFR 的匹配度评分（1-10）、推荐/不推荐理由。
EOF

Sisyphus 执行：

Step 1: ofr-librarian（理解论文创新）

codeagent-wrapper --agent ofr-librarian - /path/to/BasicOFR <<'EOF'
## Original User Request
把 WaveMamba 的创新点集成到 BasicOFR

## Context Pack
- Explore output: None
- Librarian output: None
- Oracle output: None

## Current Task
分析 WaveMamba 论文，提取可迁移到 BasicOFR 的核心模块。

## Acceptance Criteria
输出：创新点列表、可迁移模块、潜在风险、推荐集成策略。
EOF

Step 2: ofr-explore（定位集成点）

codeagent-wrapper --agent ofr-explore - /path/to/BasicOFR <<'EOF'
## Original User Request
把 WaveMamba 的创新点集成到 BasicOFR

## Context Pack
- Librarian output: [paste librarian output]

## Current Task
找到 BasicOFR 中与 WaveMamba 创新点对齐的位置（registry/forward/IO）。

## Acceptance Criteria
输出：集成点文件路径、行号、现有实现摘要。
EOF

Step 3: ofr-oracle（架构决策 - 高风险变更）

codeagent-wrapper --agent ofr-oracle - /path/to/BasicOFR <<'EOF'
## Original User Request
把 WaveMamba 的创新点集成到 BasicOFR

## Context Pack
- Librarian output: [paste librarian output]
- Explore output: [paste explore output]

## Current Task
制定集成计划，设计消融矩阵，评估风险。

## Acceptance Criteria
输出：集成计划、文件变更列表、消融矩阵、风险评估、diff_plan.json 草案。
EOF

Step 4: ofr-codegen（实现代码）

codeagent-wrapper --agent ofr-codegen - /path/to/BasicOFR <<'EOF'
## Original User Request
把 WaveMamba 的创新点集成到 BasicOFR

## Context Pack
- Librarian output: [paste librarian output]
- Explore output: [paste explore output]
- Oracle output: [paste oracle output with diff_plan.json]

## Current Task
按 diff_plan.json 生成代码，运行 4 项验证。

## Acceptance Criteria
代码生成完成、4 项验证通过、05-codegen-report.md 生成。
EOF

Sisyphus 执行：

Step 1: ofr-visualization-engineer

codeagent-wrapper --agent ofr-visualization-engineer - /path/to/BasicOFR <<'EOF'
## Original User Request
训练失败了，帮我 Debug

## Context Pack
- Explore output: None

## Current Task
分析训练日志和 visualiza_feature 输出，定位失败原因。

## Acceptance Criteria
输出：错误类型、根因分析、修复建议。
EOF

注意：如果需要读取截图/架构图，并行调用 ofr-multimodal-looker。 </example>

禁止行为

• 禁止 自己写代码（必须委托给实现代理）
• 禁止 调用代理时不传递原始请求和相关 Context Pack
• 禁止 跳过代理直接用 grep/glob 做复杂分析
• 禁止 把 explore → oracle → develop 当作强制工作流

使用原则（强约束）

1. 单写入者：并行代理只输出"定位/建议/研究"，最终改代码与改配置由主执行者统一落地，避免状态分叉。
2. BasicOFR 规范优先：路径、命名、visualiza_feature、消融矩阵、debug 门控以 OFR 工作流规范为准。
3. 先可验证后扩展：先做 debug/短训闭环，再上长训与远程实验。
4. 目标驱动：一切工作最终服务于发表 SCI 论文这一目标。