diff --git a/skills/codex-agent/SKILL.md b/skills/codex-agent/SKILL.md new file mode 100644 index 0000000..e0376b3 --- /dev/null +++ b/skills/codex-agent/SKILL.md @@ -0,0 +1,35 @@ +--- +name: codex-agent +description: Делегировать Codex'у исполнение — написать код, починить баг, исследовать. Use when user says «отдай кодексу», «пусть codex сделает/напишет/починит», «делегируй в codex», or when a plan step is assigned to Codex as the implementer. +--- + +# Делегация задачи Codex + +Спавни сабагента `codex` (Agent tool). Он держит живую codex-сессию: +доработки и ответы на его вопросы — SendMessage тому же агенту, НЕ новый спавн. + +## Промпт сабагенту — обязательные части + +- `cwd: <абсолютный путь проекта>` +- Задание: что сделать. Конкретно, с релевантными файлами/путями. +- Критерии приёмки: что должно работать, какие тесты/команды пройти. +- Что вернуть: отчёт, список тронутых файлов, как проверено. +- Опционально: `codex options: -m o3 -s read-only ...` + +## Пример + +``` +cwd: /home/smartass/Projects/nomcrm-api +Задание: почини N+1 в эндпоинте GET /orders — queries лог показывает +по запросу на каждую позицию заказа. Смотри app/controllers/OrdersController.php. +Критерии: существующие тесты проходят (composer test), запросов к БД ≤ 3 на запрос. +Верни: список изменённых файлов, суть фикса, вывод composer test. +``` + +## После завершения + +- Ответ codex = отчёт + `thread_id: ...`. Не верь на слово: проверь diff, + прогони тесты сам. +- Замечания → SendMessage тому же сабагенту (та же codex-сессия, контекст цел). +- Codex закончил вопросом (блокер) → ответь через SendMessage, он продолжит. +- Пока работает, можно спросить статус SendMessage'ем — не прерывает. diff --git a/skills/codex-consult/SKILL.md b/skills/codex-consult/SKILL.md new file mode 100644 index 0000000..a9b52b6 --- /dev/null +++ b/skills/codex-consult/SKILL.md @@ -0,0 +1,29 @@ +--- +name: codex-consult +description: Второе мнение Codex по артефакту — спека, план, дизайн, документ, идея. Итерации до консенсуса. Use when user says «проверь у кодекса», «спроси codex», «второе мнение», «пусть codex ревьюнет спеку/план», or when validating a spec/plan before execution. +--- + +# Консультация с Codex + +Спавни сабагента `codex`, итерируй SendMessage'ами. Жёсткий лимит: 5 итераций. + +## Первый промпт — обязательные части + +- Роль: «Ты — второе мнение, НЕ исполнитель. Артефакт не переписывай. + Верни находки с severity и отдельно вопросы.» +- Требования юзера — дословно (что артефакт должен удовлетворять). +- Сам артефакт: текст целиком или `cwd:` + путь к файлу. + +## Цикл итераций + +1. Получил находки → оцени критически сам (используй + superpowers:receiving-code-review, не соглашайся слепо). +2. Внёс правки в артефакт → SendMessage: что принял, что отклонил и ПОЧЕМУ, + плюс обновлённый артефакт или diff. +3. Повторяй до «существенных замечаний нет» или лимита 5. + +## Финал — резюме юзеру + +- Что согласовано и внесено. +- Что отклонено и почему. +- Нерешённые расхождения, если упёрлись (решает юзер). diff --git a/skills/codex-review/SKILL.md b/skills/codex-review/SKILL.md new file mode 100644 index 0000000..dc441d3 --- /dev/null +++ b/skills/codex-review/SKILL.md @@ -0,0 +1,37 @@ +--- +name: codex-review +description: Ревью кода силами Codex — ветка, коммит, uncommitted-изменения или произвольные файлы. Use when user says «ревью у кодекса», «пусть codex посмотрит ветку/коммит/файл», «codex review», «второй ревьюер». +--- + +# Ревью через Codex + +Спавни сабагента `codex`. Скоуп задаёт режим: + +- ветка против базы: `review scope: --base main` +- один коммит: `review scope: --commit ` +- незакоммиченное: `review scope: --uncommitted` +- произвольные файлы / абстрактный скоуп: БЕЗ `review scope:` — обычное + задание «сделай ревью файлов X, Y и их производных». + +## Промпт сабагенту — обязательные части + +- `cwd: <абсолютный путь репозитория>` (review работает от cwd) +- `review scope: ...` (если применимо) +- Фокус, если есть: безопасность / перфоманс / корректность / всё. +- Формат находок: `file:line — 🔴|🟡|🔵 — проблема — предлагаемый фикс`, + без похвал и пересказа кода. + +## Пример + +``` +cwd: /home/smartass/Projects/proxy-gate +review scope: --base main +Фокус: корректность и безопасность. +Формат находок: file:line — 🔴|🟡|🔵 — проблема — фикс. Без похвал. +``` + +## После + +- Находки отдай юзеру / обработай по задаче. +- Спорная находка → SendMessage в ту же сессию: попроси обосновать или + показать репро. Не принимай и не отвергай молча.