docs(skills): предполёт в рецептах Кодекса, урок отдал форму сбора

- Зачем:
  - среда сама отвечает за пять секунд, теряет она унаследованный файловый
    дескриптор или нет, поэтому документ несёт проверку, а не ответ; форма
    сбора вывода за вечер менялась дважды и не должна жить в двух местах.
- Что:
  - в «Сквозные правила» codex-exec.md добавлен предполёт: самотест
    `codex --version > f; wc -c f`, ветка «ноль байт» с раздельными каналами
    и `set -o pipefail`, оговорка про `wait`.
  - предполётная проверка песочницы переехала туда же из пункта про AppArmor,
    три рецепта не тронуты — их POSIX-форма и код возврата остались честными.
  - урок 2026-08-06 отдал самотест и форму предполёту, оставил находки:
    дефект `2>&1 | cat`, съеденный каналом код возврата, ненужный `script`.
- Проверка:
  - `false | cat > f; echo $?` — 0, с `set -o pipefail` — 1.
  - `bash -c 'echo "{}"; echo err >&2' 2> >(cat > e) | cat > o` — потоки
    в разных файлах, `jq` по логу проходит.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Dmitry DementievandClaude Opus 5 committed 2026-08-06 19:04:27 +03:00
1 parent 5665b96641
commit 1b73419c1d
2 files changed
+29 -27

No files matched your search

@@ -15,6 +15,24 @@ WSL2 Ubuntu: exec/resume/`-o`/фоновый Bash — весь конвейер)
## Сквозные правила (любая ветка)
- **Предполёт — один раз на новой машине или в новом харнессе.** Две
проверки. Песочница: диагностика из
[codex-sandbox-apparmor.md](codex-sandbox-apparmor.md) (сигнатура поломки
и лечение — там же). Вывод доходит до файла: `codex --version > f;
wc -c f` — 18 байт значит, что рецепты ниже работают как написаны. Ноль
байт: среда теряет унаследованный файловый дескриптор (известный случай —
T3 Code, [lessons.md](lessons.md) 2026-08-06), и тогда каждый поток идёт
своим каналом в свой файл, а код возврата держит `pipefail`:
```bash
set -o pipefail
cat "$D/task-prompt.md" | codex exec --json … -o "$D/task-result.md" - \
2> >(cat > "$D/task-stderr.txt") | cat > "$D/task-stdout.jsonl"
```
Без `pipefail` статус вернёт `cat`, и отказ Кодекса прочтётся успехом.
Подстановка процесса дописывает stderr асинхронно: читаешь этот файл тем
же вызовом — поставь `wait`.
- **Промпт — файлом, шум — в файлы.** Промпт подавай через stdin (`-`): вход
этого вызова занят промптом и должен оставаться открытым — правило
`< /dev/null` для фоновых команд сюда не относится (закроешь — получишь
@@ -103,9 +121,7 @@ WSL2 Ubuntu: exec/resume/`-o`/фоновый Bash — весь конвейер)
паникует; полный фикс — AppArmor-профиль, и он под sudo: сам не применяй,
дай пользователю готовые команды из
[codex-sandbox-apparmor.md](codex-sandbox-apparmor.md) (`!`-префикс в чат),
после применения профиля напомни убрать `use_legacy_landlock`. Перед первым
прогоном конвейера на новой Linux-машине прогони оттуда же диагностику
превентивно.
после применения профиля напомни убрать `use_legacy_landlock`.
- **Блок классификатора — сначала сузь песочницу, потом зови пользователя.**
Первая проверка: нет ли в команде `-s danger-full-access` — классификатор
его блокирует, и он не нужен (почему — в ветке исполнителя). Если блок не
@@ -362,30 +362,16 @@ codex-cli 0.146.0 и была неверна. Развели две провер
- **Не всякий харнесс — этот харнесс.** В Claude Code CLI 2.1.223 на той же
машине и той же 0.146.1 всё штатно: файл на выходе — 18 байт, лог — семь
строк, `- < prompt.md` читается. Ярлыку «я в агенте» не верь, спроси среду
сама, это пять секунд:
```bash
codex --version > f; wc -c f # 0 — среда теряет унаследованный файловый
# дескриптор, собирай вывод каналом
# 18 — рецепты codex-exec.md как написаны
```
- **Правило, годное в обеих средах**: и промпт, и вывод гнать каналами,
потоки при этом не сливать —
```bash
cat "$D/task-prompt.md" | codex exec --json … -o "$D/task-result.md" - \
2> >(cat > "$D/task-stderr.txt") | cat > "$D/task-stdout.jsonl"
```
`2>&1 | cat` был бы короче и подложил бы ошибку разбора: строка stderr
в JSONL ломает `jq` и может встать первой вместо `thread.started`. В
разъехавшемся виде живут все три механизма рецептов — thread_id из первой
строки, сторож по росту лога, проверка отписки через `command_execution`.
Оговорка: подстановка процесса дописывает stderr асинхронно, перед чтением
этого файла в том же вызове нужен `wait`. Псевдотерминал из первой редакции
не нужен: `script` давал тот же JSONL ценой `\r` и непереносимости. Сами
рецепты `codex-exec.md` не правились — форма выше их не отменяет, а
дописывает сбор вывода.
сама — самотест стоит пять секунд и живёт предполётом в
[codex-exec.md](codex-exec.md).
- **Лечение живёт в рецептах, не здесь.** Форма сбора — каждый поток своим
каналом в свой файл — стоит там же, в предполёте, и включается по
результату самотеста; сами рецепты не правились. Три вещи, которые стоили
отдельной проверки. `2>&1 | cat` короче и подкладывает ошибку разбора:
строка stderr в JSONL ломает `jq` и может встать первой вместо
`thread.started`. Канал глотает код возврата (`false | cat` даёт ноль) —
отсюда `set -o pipefail` в форме. Псевдотерминал из первой редакции не
нужен: `script` давал тот же JSONL ценой `\r` и непереносимости.
- **Механизм не вскрыт.** Известно поведение, не причина: файл на входе и
выходе дочернего процесса пуст, канал цел, песочница ни при чём. Пишу это
свойством среды и не выдаю за объяснение.