Кросс-ревью Claude Code и Codex

Установка

mkdir -p .claude/skills/codex-dual-review-file-based
cp claude-code/* .claude/skills/codex-dual-review-file-based/

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Claude Code создает сессию в каталоге .dual-review, записывает контракт раунда и выдает готовую инструкцию для Codex. Codex забирает раунд, пишет ревью с машиночитаемым JSON-блоком, а Claude проверяет каждую находку как гипотезу, вносит принятые правки и открывает следующий раунд. Сессия завершается файлом final.md со статусом approved, failed или limit. MCP-сервер и CLI-мост не нужны.

Для кого. Для разработчиков, которые используют Claude Code и Codex одновременно и хотят независимую проверку решений другой моделью.

Пример запроса к агенту

/codex-dual-review-file-based Проверь план миграции авторизации на OAuth docs/auth-plan.md

Ограничения

Поддерживается только направление Claude Code как инициатор и Codex как ревьюер. Обоим агентам нужен доступ к одному рабочему дереву на всю сессию. Опрос файлов может замечать переход с задержкой в несколько секунд, по умолчанию не больше пяти раундов.

Как отключить. Удалите каталог .claude/skills/codex-dual-review-file-based. Файлы сессий остаются в .dual-review и не влияют на работу.

Проверка безопасности

• Запускает скрипты ожидания в PowerShell или Bash
• Второй агент получает доступ на чтение и запись к каталогу проекта

Коротко о README

README описывает файловый протокол ревью между Claude Code и Codex. Файлы сессии только добавляются, флаги захвата позволяют продолжить работу после сбоя, область ревью не меняется между раундами. Для ожидания ответа есть скрипты wait-for-review.ps1 и wait-for-review.sh. Отдельно перечислены проектные решения и ограничения протокола.

SKILL.md

---
name: codex-dual-review-file-based
description: "File-based dual-review с Codex как reviewer. Использует отдельный каталог сессии в `.dual-review`, структурированные файлы раундов и `final.md` как source of truth. Используй для независимой проверки плана, кода, архитектурного решения или гипотезы, когда Claude Code и Codex работают с общим каталогом проекта."
---

# Codex Dual Review (File-Based)

Текущий чат — initiator. Codex — reviewer.
Source of truth — только файлы в `<SESSION_DIR>/`.

## Пути и рабочие деревья Git

`SESSION_DIR` — абсолютный путь к каталогу сессии. Вычислить его как `<PROJECT_ROOT>/.dual-review/<session_id>`, где `PROJECT_ROOT` — текущий корень проекта Claude Code. Если Claude Code запущен внутри отдельного рабочего дерева Git, именно оно является `PROJECT_ROOT`; не переносить сессию в основной checkout.

Каталог вспомогательных файлов навыка (`SKILL_DIR`) — каталог, содержащий этот `SKILL.md`. Брать `reviewer-prompt.txt` и скрипт ожидания из него, а не строить путь относительно `PROJECT_ROOT`.

## Invocation

```
/codex-dual-review-file-based <описание задачи> [путь/к/плану.md] [max_rounds=5]
```

Если путь к плану передан — прочитать его и использовать как основу `round-start`.
Если `max_rounds` не указан — по умолчанию 5.

## Файловый контракт

- Внутри одной сессии только добавляются новые файлы. Append-only.
- Протокольные файлы не удаляются и не перезаписываются.
- Состояние раунда определяется листингом каталога: `.flg`-файлы — это zero-byte sentinel и часть state machine, не «шум».
- Область ревью (`scope`) фиксируется в первом раунде и не меняется в пределах одной сессии.
- `final.md` означает, что сессия завершена.

## Алгоритм

### Шаг 1. Подготовить контекст раунда

Изучить кодовую базу. Подготовить контекст для ревью:
- что именно нужно проверить;
- какие файлы относятся к задаче;
- какой `scope` нужен.

Канонические значения `scope`:
- `plan-only`
- `production-change`
- `lookup-test`
- `architecture-check`

Похожие