docs: add codex parameter override coverage

This commit is contained in:
admin committed 2026-07-07 15:45:22 +05:00
1 parent 445e013449
commit 6a8aabd3e1
1 file changed
+32 -3
+32 -3
View File
@@ -40,11 +40,14 @@ codex-crew/
Детерминированная обвязка вокруг `codex exec`. Интерфейс:
```
codex-run.sh <job_dir> exec [-C <dir>] [codex-флаги...] <prompt>
codex-run.sh <job_dir> resume <thread_id> <prompt>
codex-run.sh <job_dir> review [--base X | --commit Y | --uncommitted] [instructions]
codex-run.sh <job_dir> exec [codex-флаги...] <prompt>
codex-run.sh <job_dir> resume <thread_id> [codex-флаги...] <prompt>
codex-run.sh <job_dir> review [--base X | --commit Y | --uncommitted] [codex-флаги...] [instructions]
```
Codex-флаги (модель, sandbox, effort и т.д. — см. «Переопределяемые
параметры») пробрасываются в `codex exec` без интерпретации.
Поведение:
- Запускает `codex exec --json -o <job_dir>/last.md ... > <job_dir>/events.jsonl 2> <job_dir>/err.log`.
@@ -85,6 +88,32 @@ Frontmatter: `model: sonnet` (не Fable — правило юзера), `tools:
Путь к скрипту — через `${CLAUDE_PLUGIN_ROOT}/scripts/codex-run.sh`.
## Переопределяемые параметры codex
Дефолт — без флагов: наследуется `~/.codex/config.toml` (yolo: danger-full-access,
approval never, gpt-5.5, reasoning high, все MCP). Любой параметр
переопределяется на запуск. Механизм сквозной: оркестратор передаёт сабагенту
опциональную строку `codex options: <флаги>`, сабагент пробрасывает её в
`codex-run.sh`, тот — в `codex exec` как есть.
Таблица частых переопределений (войдёт в agents/codex.md и скиллы):
| Что | Флаг |
|---|---|
| Модель | `-m <model>` (например `-m o3`) |
| Reasoning effort | `-c model_reasoning_effort="minimal\|low\|medium\|high\|xhigh"` |
| Права/sandbox | `-s read-only` / `-s workspace-write` / `-s danger-full-access` (default) |
| Рабочая директория | `-C <dir>` |
| Доп. write-директории | `--add-dir <dir>` |
| Картинки в промпт | `-i <file>` (повторяемый) |
| Структурированный ответ | `--output-schema <schema.json>` |
| Профиль конфига | `-p <profile>` ($CODEX_HOME/<name>.config.toml) |
| Фичи вкл/выкл | `--enable <feature>` / `--disable <feature>` |
| Любой конфиг-ключ | `-c key=value` (dotted path, TOML-значение) |
Запрещён `--ephemeral` — ломает resume. Точные допустимые значения effort
сверить при имплементации.
## Скиллы (тонкие, для оркестратора)
Все три: «спавни агента `codex`, промпт формируй так». Общее: передавать cwd