diff --git a/docs/design.md b/docs/design.md index 6713200..cf03e76 100644 --- a/docs/design.md +++ b/docs/design.md @@ -40,11 +40,14 @@ codex-crew/ Детерминированная обвязка вокруг `codex exec`. Интерфейс: ``` -codex-run.sh exec [-C ] [codex-флаги...] -codex-run.sh resume -codex-run.sh review [--base X | --commit Y | --uncommitted] [instructions] +codex-run.sh exec [codex-флаги...] +codex-run.sh resume [codex-флаги...] +codex-run.sh review [--base X | --commit Y | --uncommitted] [codex-флаги...] [instructions] ``` +Codex-флаги (модель, sandbox, effort и т.д. — см. «Переопределяемые +параметры») пробрасываются в `codex exec` без интерпретации. + Поведение: - Запускает `codex exec --json -o /last.md ... > /events.jsonl 2> /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 ` (например `-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 ` | +| Доп. write-директории | `--add-dir ` | +| Картинки в промпт | `-i ` (повторяемый) | +| Структурированный ответ | `--output-schema ` | +| Профиль конфига | `-p ` ($CODEX_HOME/.config.toml) | +| Фичи вкл/выкл | `--enable ` / `--disable ` | +| Любой конфиг-ключ | `-c key=value` (dotted path, TOML-значение) | + +Запрещён `--ephemeral` — ломает resume. Точные допустимые значения effort +сверить при имплементации. + ## Скиллы (тонкие, для оркестратора) Все три: «спавни агента `codex`, промпт формируй так». Общее: передавать cwd