К основному содержанию
скилл CX Codex

collaborating-with-codex — скилл для Claude Code

Скилл collaborating-with-codex передаёт ограниченную задачу отдельной локальной или удалённой сессии Codex CLI. Основная сессия Claude Code сохраняет контроль над итоговыми правками и проверкой.

MIT ★ 475 обновлён 2026-10-13

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add cnfjlhj/ai-collab-playbook --skill collaborating-with-codex -a claude-code
Открыть на GitHub

Что делает collaborating-with-codex

Скилл запускает Codex CLI через скрипт scripts/codex_bridge.py: можно попросить его подготовить прототип, разобраться с ошибкой или проверить код. Ответ приходит в JSON с результатом, идентификатором сессии и сообщениями агента. Основная сессия отвечает за постановку задачи, сведение результатов, финальные правки и проверку.

Для продолжения работы скрипту передают SESSION_ID из первого ответа. Удалённый запуск использует SSH и требует, чтобы локальная машина подключалась без интерактивного запроса, а на сервере были установлены codex и POSIX-совместимая оболочка. При SSH пути --cd и --image относятся к удалённой машине. По умолчанию песочница доступна только для чтения; расширять права стоит лишь для задачи, которой нужна запись.

Какие задачи решает

  • поручить Codex подготовить diff для прототипа
  • передать разбор ошибки отдельной сессии
  • проверить код, не отдавая ей финальные правки
  • продолжить работу Codex по SESSION_ID
  • запустить Codex на удалённом сервере через SSH

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

  • Проверь этот код и верни заметки для ревью, не меняя файлы.
  • Разбери ошибку в проекте и предложи diff для исправления.
  • Подключись к серверу server-alias и проверь удалённый проект на ошибки тестов.

Как установить collaborating-with-codex

1Через Skills CLI (Vercel)

npx skills add cnfjlhj/ai-collab-playbook --skill collaborating-with-codex -a claude-code

2Вручную: положить файлы

~/.claude/skills/collaborating-with-codex/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/collaborating-with-codex/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о collaborating-with-codex

Как установить collaborating-with-codex в Claude Code?

Выполните npx skills add cnfjlhj/ai-collab-playbook --skill collaborating-with-codex -a claude-code. Файл скилла находится по пути ~/.claude/skills/collaborating-with-codex/SKILL.md.

Что делает collaborating-with-codex?

Скилл запускает отдельную сессию Codex CLI для прототипирования, отладки или ревью. Основная сессия Claude Code сохраняет ответственность за итоговый результат.

Можно ли продолжить сессию Codex на удалённой машине?

Да. Передайте SESSION_ID и подключайтесь к тому же SSH-хосту. На удалённой машине должны быть доступны codex и POSIX-совместимая оболочка.

Исходный текст

SKILL.md · MIT
---
name: collaborating-with-codex
description: Use when you explicitly want a second local or SSH remote Codex CLI session to prototype, debug, or review code, while your current session remains the primary owner of the final result.
---

## Quick Start

```bash
python scripts/codex_bridge.py --cd "/path/to/project" --PROMPT "Your task"
```

Remote Codex over SSH:

```bash
python scripts/codex_bridge.py --ssh "server-alias" --cd "/remote/project" --PROMPT "Your task"
```

**Output:** JSON with `success`, `SESSION_ID`, `agent_messages`, and optional `error`.

## Collaboration Rules

- Keep the current session responsible for scope, synthesis, final edits, and verification.
- Delegate a bounded task with a concrete output contract such as a diff, diagnosis, or review note.
- Avoid overlapping write scope between sessions unless the second session is review-only.
- Start with read-only access; expand the sandbox only when the delegated task requires it.
- Do not set model or profile overrides unless the user explicitly asked for them.

## Parameters

```
usage: codex_bridge.py [-h] --PROMPT PROMPT --cd CD [--sandbox {read-only,workspace-write,danger-full-access}] [--SESSION_ID SESSION_ID] [--skip-git-repo-check]
                       [--return-all-messages] [--image IMAGE] [--model MODEL] [--yolo] [--profile PROFILE] [--ssh SSH] [--ssh-option SSH_OPTION]
                       [--codex-bin CODEX_BIN]

Codex Bridge

options:
  -h, --help            show this help message and exit
  --PROMPT PROMPT       Instruction for the task to send to codex.
  --cd CD               Set the workspace root for codex before executing the task.
  --sandbox {read-only,workspace-write,danger-full-access}
                        Sandbox policy for model-generated commands. Defaults to `read-only`.
  --SESSION_ID SESSION_ID
                        Resume the specified session of the codex. Defaults to `None`, start a new session.
  --skip-git-repo-check
                        Allow codex running outside a Git repository (useful for one-off directories).
  --return-all-messages
                        Return all messages (e.g. reasoning, tool calls, etc.) from the codex session. Set to `False` by default, only the agent's final reply message is
                        returned.
  --image IMAGE         Attach one or more image files to the initial prompt. Separate multiple paths with commas or repeat the flag.
  --model MODEL         The model to use for the codex session. This parameter is strictly prohibited unless explicitly specified by the user.
  --yolo                Run every command without approvals or sandboxing. Only use when `sandbox` couldn't be applied.
  --profile PROFILE     Configuration profile name to load from `~/.codex/config.toml`. This parameter is strictly prohibited unless explicitly specified by the user.
  --ssh SSH             Run Codex on a remote host via SSH. Value can be an SSH alias or user@host. When set, --cd and --image paths are remote paths.
  --ssh-option SSH_OPTION
                        Extra ssh option, repeatable. Example: --ssh-option=-J --ssh-option=bastion
  --codex-bin CODEX_BIN
                        Codex executable to run locally or on the remote host. Defaults to `codex`. `--remote-codex` is accepted as a backward-compatible alias.
```

## Multi-turn Sessions

**Always capture `SESSION_ID`** from the first response for follow-up:

```bash
# Initial task
python scripts/codex_bridge.py --cd "/project" --PROMPT "Analyze auth in login.py"

# Continue with SESSION_ID
python scripts/codex_bridge.py --cd "/project" --SESSION_ID "uuid-from-response" --PROMPT "Write unit tests for that"
```

Remote sessions use the same `SESSION_ID`, but continue them against the same SSH host:

```bash
python scripts/codex_bridge.py --ssh "server-alias" --cd "/remote/project" --SESSION_ID "uuid-from-response" --PROMPT "Now implement it"
```

## SSH Remote Codex

Use `--ssh` when the repository, runtime, or credentials needed for the task live on a remote server.

Requirements:
- Local machine can run `ssh <host>` non-interactively.
- Remote host has `codex` installed and available in the remote non-interactive shell `PATH`, or pass `--codex-bin "/absolute/path/to/codex"`.
- The remote host should use a POSIX-compatible shell for command quoting.
- `--cd` is a remote absolute path when `--ssh` is set.
- `--image` paths are also remote paths when `--ssh` is set. Upload local images first if Codex on the server needs them.

Examples:

```bash
# Use an SSH config alias
python scripts/codex_bridge.py --ssh "gpu-box" --cd "/srv/app" --PROMPT "Review this service for race conditions"

# Use user@host and a remote codex path
python scripts/codex_bridge.py --ssh "[email protected]" --codex-bin "/home/ubuntu/.local/bin/codex" --cd "/home/ubuntu/app" --PROMPT "Run the failing tests and diagnose"

# Use a jump host
python scripts/codex_bridge.py --ssh "private-box" --ssh-option=-J --ssh-option=bastion --cd "/workspace/repo" --PROMPT "Inspect the deployment scripts"
```

Do not use `--ssh` for local repositories. Do not pass `--model` or `--profile` unless the user explicitly requested them.

## Common Patterns

**Prototyping (read-only, request diffs):**
```bash
python scripts/codex_bridge.py --cd "/project" --PROMPT "Generate unified diff to add logging"
```

**Debug with full trace:**
```bash
python scripts/codex_bridge.py --cd "/project" --PROMPT "Debug this error" --return-all-messages
```

**Remote debug with write access:**
```bash
python scripts/codex_bridge.py --ssh "server-alias" --cd "/remote/project" --sandbox workspace-write --PROMPT "Fix the failing integration test and summarize the patch"
```

© cnfjlhj · MIT · cnfjlhj/ai-collab-playbook

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
gerrit odyssey4me Скилл ведёт изменения через Gerrit: отправляет патчсеты, скачивает чужие правки для проверки и отдаёт результаты запросов в markdown. CX Codex +1 135установок tunnel-doctor daymade Скилл tunnel-doctor для Claude Code диагностирует сбои соединения и низкую скорость на маршрутах через Tailscale, прокси, TUN, DNS и SSH-туннели. Запускается первым при проблемах с подключением через туннель или прокси. CX Codex +1 741установок wish-ssh-code-review existential-birds Скилл wish-ssh-code-review проверяет код SSH-серверов на базе Go-библиотеки Charmbracelet Wish: порядок middleware, работу с PTY, ключи хоста и корректное завершение работы. CX Codex +1 119установок desktop-commander-overview cline Скилл desktop-commander-overview объясняет агенту, что умеет MCP-сервер Desktop Commander: постоянные сессии, долгие процессы, файлы вне проекта, Excel и PDF, SSH. CX Codex +1 3 200установок ssh OpenHands Скилл ssh для работы с удалёнными машинами: подключение по паролю или ключу, генерация ключей, конфиги, команды на сервере и передача файлов через SCP. CX Codex +1 1 200установок run-experiment wanshuiyin Скилл run-experiment для Claude Code автоматизирует запуск ML-экспериментов на локальных GPU, удалённых серверах, Vast.ai и Modal. Разворачивает код, проверяет видеопамять и настраивает логирование. CX Codex +1 579установок

Из того же набора18

Весь набор →
论文精读 Промпт 论文精读 для Claude Code помогает разбирать англоязычные научные статьи по абзацам: сохраняет исходный текст, даёт академический перевод на китайский и аналитический комментарий. GP ChatGPT ★ 475звёзд репо research-lead-sidecar Скилл research-lead-sidecar для Claude Code организует исследовательскую работу: основной агент ведёт критический путь, субагенты выполняют ограниченные побочные задачи. Ведёт долгие задачи с отдельными направлениями работы. CX Codex +1 ★ 475звёзд репо spec-first-mvp Скилл spec-first-mvp останавливает разработку перед реализацией и требует написать короткую спецификацию, список одноразовых прототипов и критерии для решения «продолжать или нет». CX Codex +1 ★ 475звёзд репо collaborating-with-gemini Скилл collaborating-with-gemini подключает Gemini CLI в роли второго пилота для поиска багов, ревью патчей и прототипирования через мост на Python. CX Codex +1 ★ 475звёзд репо question-refiner Скилл question-refiner превращает размытый исследовательский вопрос в структурированное техзадание для глубокого исследования. Задаёт уточняющие вопросы, собирает требования к формату, источникам и объёму, а потом генерирует готовый промпт. CX Codex +1 ★ 475звёзд репо collaborating-with-claude Скилл collaborating-with-claude передаёт задачи на второе мнение в Claude Code CLI через bridge-скрипт, сохраняя контроль за основным агентом. CX Codex +1 ★ 475звёзд репо paper-review-pipeline Скилл paper-review-pipeline разбирает черновик научной статьи по разделам и собирает список проблем с приоритетами P0–P2, а также помогает составить ответ на рецензии. CX Codex +1 ★ 475звёзд репо paper2html Скилл paper2html превращает научные статьи из PDF, arXiv или LaTeX в автономную веб-страницу с формулами KaTeX и анализом на китайском языке. CX Codex +1 ★ 475звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой