codex-adapter — скилл для Claude Code: задачи через Codex
Скилл codex-adapter для Claude Code передаёт OpenAI Codex CLI одну чёткую механическую задачу. Запускается по прямой просьбе передать Codex переименование, правку конфигурации или скриптовую замену.
MIT ★ 26 обновлён 2026-11-16
npx skills add wrg32786/aigent-os --skill codex-adapter -a claude-codeЧто делает codex-adapter
Скилл запускает через Codex CLI одну ограниченную задачу: например, переименовывает файлы, меняет конфигурацию или применяет повторяющуюся правку. Задача должна иметь понятный результат, который можно проверить по diff. Для запуска нужен установленный Codex CLI и ясные формулировка задачи и рабочая папка.
Скрипт daemons/codex-adapter.sh запускает codex exec в указанной директории. После выполнения он сохраняет журнал, статус Git и diff для проверки; если папка не является Git-репозиторием, файлы нужно просмотреть напрямую. Скилл не коммитит и не отправляет изменения. Секреты, производственная конфигурация и архитектурные решения выходят за его рамки.
Какие задачи решает
- передать Codex CLI пакетное переименование файлов
- изменить конфигурацию или запись в
.gitignore - применить одинаковую правку в нескольких файлах
- запустить линт-фиксы и проверить получившийся diff
Примеры запросов агенту
- Передай Codex CLI переименование
old-nameвnew-nameв папкеsrc. - Используй Codex для добавления
*.tmpв.gitignore. - Передай Codex скриптовую замену во всех файлах
srcи покажи diff для проверки.
Как установить codex-adapter
1Через Skills CLI (Vercel)
npx skills add wrg32786/aigent-os --skill codex-adapter -a claude-code2Вручную: положить файлы
~/.claude/skills/codex-adapter/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/codex-adapter/
1Через Skills CLI (Vercel)
npx skills add wrg32786/aigent-os --skill codex-adapter -a codex2Вручную: положить файлы
.agents/skills/codex-adapter/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add wrg32786/aigent-os --skill codex-adapter -a cursor2Вручную: положить файлы
.cursor/skills/codex-adapter/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install wrg32786/aigent-os skills/codex-adapter2Вручную: положить файлы
.github/skills/codex-adapter/SKILL.md1Через Skills CLI (Vercel)
npx skills add wrg32786/aigent-os --skill codex-adapter -a gemini-cli2Командой платформы
gemini skills install https://github.com/wrg32786/aigent-os --path skills/codex-adapterВручную: положить файлы
.devin/skills/codex-adapter/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add wrg32786/aigent-os --skill codex-adapter -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о codex-adapter
Как установить codex-adapter в Claude Code?
Выполни npx skills add wrg32786/aigent-os --skill codex-adapter -a claude-code. Файл скилла появится по пути ~/.claude/skills/codex-adapter/SKILL.md.
Что делает codex-adapter?
Он передаёт Codex CLI одну механическую задачу с проверяемым результатом, затем сохраняет diff и статус Git для проверки. Изменения автоматически не коммитятся и не отправляются.
Что нужно для работы codex-adapter?
Нужен установленный Codex CLI, доступный как codex или через AIGENT_CODEX_BIN. Также требуются формулировка задачи и целевая папка.
Исходный текст
SKILL.md · MIT
--- name: codex-adapter description: "Route one mechanical task to OpenAI Codex CLI with review before merge. Use when explicitly asked to hand Codex a rename, config edit, or scripted replacement." allowed-tools: Read, Bash user-invocable: true triggers: - route this to codex - use codex for this - hand this to codex - run this through codex - codex exec - non-claude executor --- # Codex Adapter This is aigent-OS's first (and currently only) non-Claude executor: a thin wrapper around `daemons/codex-adapter.sh` that runs a single bounded, mechanical task through the [Codex CLI](https://developers.openai.com/codex)'s non-interactive `codex exec` mode. ## Scope -- what "bounded and mechanical" means Good fits: a scripted rename, a config/gitignore entry, a repetitive multi-file edit with a clear before/after, a lint-fix pass. The task prompt you hand it should be checkable by a human (or you) glancing at the resulting diff -- if you can't describe in one sentence what "done" looks like, it's not bounded enough for this adapter; do it yourself instead. Not a fit: architecture decisions, anything requiring judgment about tradeoffs, anything touching credentials/secrets/production config, anything the user hasn't explicitly asked to route to Codex. ## Before you invoke it 1. Confirm the Codex CLI is actually available: `command -v codex` (or whatever `AIGENT_CODEX_BIN` is set to). If it isn't installed, tell the user instead of guessing at a path. 2. State the bounded task in one sentence, and the target directory. If either is unclear, ask -- don't invoke on a guess. ## Invocation ```bash bash daemons/codex-adapter.sh "<bounded task prompt>" --dir <path> [--sandbox <mode>] ``` - `AIGENT_CODEX_BIN` (env, default `codex`) -- path or name of the Codex CLI binary. Never hardcode a machine-specific path in the invocation; set the env var if the binary isn't on `PATH`. - `--dir <path>` -- working directory the task runs in. Default: current directory. - `--sandbox <mode>` -- passed through to `codex exec --sandbox`. Default `workspace-write` (Codex may read/write inside `--dir`, nothing wider). Example: ```bash AIGENT_CODEX_BIN=codex bash daemons/codex-adapter.sh \ "Add a .gitignore entry for *.tmp files" --dir . ``` ## After it runs -- the review gate The adapter **never commits or pushes**. It writes: - `.aigent/codex-runs/<timestamp>/output.log` -- the raw Codex CLI transcript - `.aigent/codex-runs/<timestamp>/review.diff` -- a working-tree diff (tracked changes + a synthetic diff for any new untracked files) if `--dir` is a git repository - `.aigent/codex-runs/<timestamp>/status.txt` -- `git status --porcelain` for the same tree Read `review.diff` before doing anything else. Treat a Codex-produced change exactly like a sub-agent's diff: verify it does what was asked, then decide whether to stage/commit it yourself. If `--dir` isn't a git repository, the adapter says so explicitly and you review the files directly instead. ## What this is not Not a general multi-LLM router -- it's one task class routed to one executor. Extending this to route by task type, or to wire additional CLIs (Gemini CLI, opencode, etc.) behind the same interface, is future work, not something to imply is already live.
© wrg32786 · MIT · wrg32786/aigent-os