diff --git a/agents/.agents/skills/codex-subagent-playbook/SKILL.md b/agents/.agents/skills/codex-subagent-playbook/SKILL.md index f24b9f1..7b0872a 100644 --- a/agents/.agents/skills/codex-subagent-playbook/SKILL.md +++ b/agents/.agents/skills/codex-subagent-playbook/SKILL.md @@ -1,6 +1,6 @@ --- name: codex-subagent-playbook -description: "Оптика тонкого мастера для одной нетривиальной задачи: исследование, планирование, реализация и независимая проверка через субагентов без поглощения контекста координатора." +description: "Оптика тонкого мастера для одной нетривиальной задачи: как выбирать делегирование, независимую проверку и файловый обмен, сохраняя контекст координатора для решений." --- # Тонкий мастер @@ -34,7 +34,9 @@ description: "Оптика тонкого мастера для одной не `$SCRATCH` — логический общий каталог одного прогона, доступный координатору и назначенным агентам. Физически это скретчпад сессии, временный каталог ОС либо гарантированно игнорируемый каталог проекта. В нём живут временные промпты, -отчёты, триаж и перепроверки; это не артефакты проекта. +отчёты, триаж и перепроверки; это не артефакты проекта. Не предполагай +конкретную оболочку или синтаксис пути: файловый маршрут должен работать +нативными средствами текущей ОС. - Временные обменные файлы веди на английском. Долговечные документы и текст для партнёра пиши на языке проекта. diff --git a/agents/.agents/skills/codex-subagent-playbook/agents/openai.yaml b/agents/.agents/skills/codex-subagent-playbook/agents/openai.yaml index 64d08c7..34798c1 100644 --- a/agents/.agents/skills/codex-subagent-playbook/agents/openai.yaml +++ b/agents/.agents/skills/codex-subagent-playbook/agents/openai.yaml @@ -1,6 +1,6 @@ interface: display_name: "Codex Subagent Playbook" short_description: "Делегирование без засорения контекста мастера" - default_prompt: "Используй $codex-subagent-playbook, чтобы провести задачу через субагентов и сохранить контекст мастера чистым." + default_prompt: "Используй $codex-subagent-playbook как оптику: выбери полезное делегирование и независимую проверку, сохранив контекст мастера для решений." policy: allow_implicit_invocation: false diff --git a/agents/.agents/skills/codex-subagent-playbook/references/prompt-templates.md b/agents/.agents/skills/codex-subagent-playbook/references/prompt-templates.md index e392fdf..7fa8ed4 100644 --- a/agents/.agents/skills/codex-subagent-playbook/references/prompt-templates.md +++ b/agents/.agents/skills/codex-subagent-playbook/references/prompt-templates.md @@ -18,12 +18,13 @@ ## Каталог прогона `$SCRATCH` определён в основном файле как общий временный каталог. Для задачи -создай уникальную подпапку: `D="$SCRATCH/"`. `P` указывает на +создай в нём уникальную подпапку, далее `D`. `P` обозначает каталог `references/prompts` этого скилла. Каждый агент получает отдельный `REPORT`. Собирай файлы механически, не читая полезную нагрузку в контекст координатора. -Примеры ниже используют POSIX `cat`; в PowerShell применяй -`Get-Content | Set-Content -Encoding utf8 `. +В схемах ниже `A + B -> C` означает текстовое объединение файлов в заданном +порядке нативным средством текущей ОС; `[A]` означает необязательный файл. +Схема не предписывает оболочку, синтаксис пути или отдельный этап процесса. ## Исполнитель или исследователь @@ -37,9 +38,11 @@ CHECKS: commands this agent should run REPORT: absolute unique path ``` -```bash -cat "$D/params.md" "$P/result-contract.md" "$P/runtime-language.md" \ - > "$D/prompt.md" +```text +D/params.md ++ P/result-contract.md ++ P/runtime-language.md +-> D/prompt.md ``` Самодостаточную постановку и подробное обязательное чтение добавляй только @@ -53,11 +56,15 @@ cat "$D/params.md" "$P/result-contract.md" "$P/runtime-language.md" \ TITLE: short review title WORKING DIRECTORY: absolute repo path STATEMENT: task and parent spec paths -SCOPE: changed files or task sections under review -BASELINE: what is explicitly outside this review +REVIEW INPUT: task sections, exact paths, a prepared diff path, or a diff command +OUT OF SCOPE: what is explicitly outside this review CHECKS: commands and expected counters ``` +`REVIEW INPUT` должен позволять отличить проверяемую работу от посторонних +изменений. Выбери достаточную форму для текущего дерева; диапазон коммитов не +обязателен, если точные пути, разделы или подготовленный diff уже задают границу. + `review-output.md` задаёт поля конкретной линии: ```text @@ -84,10 +91,13 @@ CODE LENS: seek correctness bugs, broken invariants, regressions, security issues, and tests that can pass without proving the behavior. ``` -```bash -cat "$D/review-common.md" "$D/review-focus.md" "$D/review-output.md" \ - "$P/review-boilerplate.md" "$P/runtime-language.md" \ - > "$D/review-prompt.md" +```text +D/review-common.md ++ D/review-focus.md ++ D/review-output.md ++ P/review-boilerplate.md ++ P/runtime-language.md +-> D/review-prompt.md ``` Для двух слепых линий создай `review-focus-a.md` и `review-focus-b.md`, @@ -104,20 +114,20 @@ cat "$D/review-common.md" "$D/review-focus.md" "$D/review-output.md" \ ## Триаж реализации -Передай исполнителю исходные отчёты без пересказа. `triage-params.md` -содержит путь итогового отчёта и проверки. `coordinator-notes.md` добавляй -только для совпадений, противоречий и новых решений уровня задачи. +Передай исполнителю актуальные подробные отчёты без пересказа: исходные обзоры +в первом круге, отчёты перепроверки для оставшихся и новых находок в следующих. +`triage-params.md` содержит путь итогового отчёта и проверки. +`coordinator-notes.md` добавляй только для совпадений, противоречий и новых +решений уровня задачи. -```bash -cat "$P/triage-header.md" "$D/triage-params.md" \ - "$D/review-a.md" > "$D/fix-prompt.md" -if [ -f "$D/review-b.md" ]; then - cat "$D/review-b.md" >> "$D/fix-prompt.md" -fi -if [ -f "$D/coordinator-notes.md" ]; then - cat "$D/coordinator-notes.md" >> "$D/fix-prompt.md" -fi -cat "$P/runtime-language.md" >> "$D/fix-prompt.md" +```text +P/triage-header.md ++ D/triage-params.md ++ ++ [] ++ [D/coordinator-notes.md] ++ P/runtime-language.md +-> D/fix-prompt.md ``` ## Узкая перепроверка @@ -126,9 +136,11 @@ cat "$P/runtime-language.md" >> "$D/fix-prompt.md" исходному отчёту и файлу резолюций, нужную проверку и новый уникальный `REPORT`. -```bash -cat "$P/recheck-header.md" "$D/recheck-params.md" \ - "$P/runtime-language.md" > "$D/recheck-prompt.md" +```text +P/recheck-header.md ++ D/recheck-params.md ++ P/runtime-language.md +-> D/recheck-prompt.md ``` Перепроверка следует решению координатора по договору ревью, а не номеру этапа. diff --git a/agents/.agents/skills/codex-subagent-playbook/references/review-and-triage.md b/agents/.agents/skills/codex-subagent-playbook/references/review-and-triage.md index c04460e..cd1ab17 100644 --- a/agents/.agents/skills/codex-subagent-playbook/references/review-and-triage.md +++ b/agents/.agents/skills/codex-subagent-playbook/references/review-and-triage.md @@ -85,9 +85,9 @@ reviewer -> detailed report file -> triage owner постановку. Продуктовый выбор и принятие риска выносит партнёру. **Реализация.** Пофиндинговый триаж делает исполнитель, у которого есть -контекст кода. Координатор передаёт оба исходных отчёта без изменений и -добавляет отдельную короткую шапку: совпадения, противоречия и возможный выход -за границы. Он не сливает и не удаляет «дубликаты». +контекст кода. Координатор передаёт актуальные подробные отчёты выбранных линий +без изменений и добавляет отдельную короткую шапку: совпадения, противоречия и +возможный выход за границы. Он не сливает и не удаляет «дубликаты». Для каждого идентификатора исполнитель возвращает один статус: @@ -109,6 +109,9 @@ reviewer -> detailed report file -> triage owner `APPROVED` либо явным принятием риска полномочным координатором или партнёром. Координатор получает по одной компактной строке со статусом каждого исходного или нового идентификатора; подробности остаются в файле перепроверки. +Если идентификатор не закрыт либо появился рядом с исправлением, актуальный +отчёт перепроверки напрямую идёт владельцу следующего триажа. Координатор не +восстанавливает доказательства из компактной сводки. Повторно поднятое аргументированно отклонённое замечание пометь как спор и отправь на отдельную узкую проверку усиленного уровня. Полный новый обзор diff --git a/agents/.agents/skills/codex-subagent-playbook/references/roles.md b/agents/.agents/skills/codex-subagent-playbook/references/roles.md index edf0720..661d5e1 100644 --- a/agents/.agents/skills/codex-subagent-playbook/references/roles.md +++ b/agents/.agents/skills/codex-subagent-playbook/references/roles.md @@ -11,7 +11,7 @@ - [Возможности хоста](#возможности-хоста) - [Выбор уровня](#выбор-уровня) - [Текущая маршрутизация](#текущая-маршрутизация) -- [Роли](#роли) +- [Возможные мандаты](#возможные-мандаты) - [Файл пользовательского агента](#файл-пользовательского-агента) - [Пределы параллельности](#пределы-параллельности)