crossfire
PlutoLei/crossfireActor-Critic пайплайн для совместной работы Claude и Codex: два AI-агента из разных обучающих дистрибуций планируют, реализуют и взаимно проверяют код, устраняя слепые пятна друг друга. Подходит для архитектурных решений, рефакторинга и критических релизов.
Установка
git clone https://github.com/PlutoLei/crossfire.gitREADME
Зачем Crossfire?
Что происходит, когда Claude и Codex закрывают в одной комнате и просят договориться об архитектуре? Получается на удивление хороший код.
crossfire — это Claude Code скилл, запускающий сквозной Actor-Critic пайплайн, в котором объединены две AI-модели из разных обучающих дистрибуций. Claude Code (Opus 4.6) выступает Архитектором и Ревьюером — стратегическим мыслителем у доски. Codex CLI (GPT-5.4) выступает Исполнителем и Аудитором — тяжёлой артиллерией, которая быстро пишет код и перепроверяет всё с дотошностью таможенного инспектора.
Ключевая идея: гетерогенные модели лучше замечают слепые пятна друг друга, чем однородные команды (arXiv:2602.03794). Фаза 0 — это парная терапия для AI. Фаза 2 — недоверие как услуга. Ваша кодовая база в выигрыше.
Как это работает
Пайплайн состоит из четырёх фаз — планирование, выполнение, ревью, отчёт:
- Фаза 0 — PLAN (Claude): Исследование кодовой базы → черновик плана → состязательная дискуссия с Codex → фиксация финального плана
- Фаза 1 — EXECUTE (Codex): Реализация строго по зафиксированному плану, с предварительной обработкой через защитный слой для Windows
- Фаза 2 — REVIEW (оба): Первичное ревью Claude → детерминированные проверки (тесты/линтеры) → финальный аудит Codex → перекрёстное ревью
- Фаза 3 — REPORT: Структурированный отчёт + автоматический git-коммит
Уровни пайплайна
| Уровень | Пайплайн | Подходит для | Глубина ревью |
|---|---|---|---|
| L1 | Пропуск фазы 0 → EXECUTE → быстрое ревью | Небольшие правки, известные исправления, низкая неоднозначность | Базовая |
| L2 | Полный 4-фазный пайплайн | По умолчанию для большинства задач разработки | Высокая (до 3 раундов) |
| L3 | Полный пайплайн + обязательное перекрёстное ревью | Архитектурные изменения, рискованный рефакторинг, критические релизы | Максимальная |
Если количество файлов и строк указывают на разные уровни, выбирается более высокий.
Быстрый старт
Требования
- Claude Code v1.0+
- Codex CLI v0.115.0+ —
npm install -g @openai/codex - Настройте модель Codex в
~/.codex/config.toml:tomlmodel = "gpt-5.4" model_reasoning_effort = "xhigh"
Установка
git clone https://github.com/PlutoLei/crossfire.git
mkdir -p ~/.claude/skills/crossfire/references
cp crossfire/SKILL.md ~/.claude/skills/crossfire/
cp crossfire/references/*.md ~/.claude/skills/crossfire/references/Первая команда
/crossfire code: Add a parse_date function to src/utils.py supporting ISO 8601 and Chinese date formatsШаблоны
Девять шаблонов для типовых задач:
| Шаблон | Уровень | Описание | Пример |
|---|---|---|---|
code | L1/L2 | Реализация новой функциональности | /crossfire code: Add parse_date to utils.py |
bugfix | L2 | Исправление первопричины + защита от регрессий | /crossfire bugfix: Fix confusion matrix colors |
refactor | L2 | Улучшение структуры с сохранением поведения | /crossfire refactor: Extract dedup logic |
test | L1 | Добавление или усиление автотестов | /crossfire test: Unit tests for process_one_paper |
review | L1 | Целевое ревью кода через Codex | /crossfire review: Review generate_essay_en.py |
audit | L2 | Параллельный аудит из двух источников (Claude + агент code-reviewer) | /crossfire audit: Audit TextMamba3D changes |
optimize | L2 | Оптимизация производительности или ресурсов | /crossfire optimize: Async batch requests |
architect | L3 | Проектирование архитектуры на уровне системы | /crossfire architect: Design figure compositor |
research | L2 | Реализация по исследовательской архитектуре (автоматический inject-plan) | /crossfire research: Implement per architecture_proposal.md |
Синтаксис: /crossfire <шаблон>: <описание> или /crossfire L2: <описание>
Флаги: --no-debate (пропустить дискуссию в фазе 0) · --no-audit (пропустить финальный аудит Codex) · --inject-plan <dir> (внедрить результаты исследования)
Конфигурация
Codex CLI
Основные настройки в ~/.codex/config.toml:
model = "gpt-5.4"
model_reasoning_effort = "xhigh"
[windows]
sandbox = "elevated"Защитный слой для Windows
Все вызовы Codex на Windows проходят обязательную предварительную обработку:
| Защита | Правило | Фазы |
|---|---|---|
| Нормализация путей | Все пути приводятся к прямым слешам | Все |
Инъекция cd | Первая строка каждого промпта Codex: cd <normalized-abs-path> | Все |
| Встраивание плана | ≤200 строк — инлайн в промпт; >200 строк — через ссылку на файл | Фаза 1 |
| Резервное восстановление вывода | Обнаружение отсутствующих/усечённых файлов → Claude завершает через инструмент Write | Фаза 1 |
Детали архитектуры
Полное описание пайплайна — включая подшаги фазы 0, многоуровневое ревью, циклы fix-reaudit и стратегию делегирования скиллов — см. в документации по архитектуре.
Благодарности
- Actor-Critic пайплайн для Claude Code