feat: codex-agent, codex-review, codex-consult skills

2026-07-07 16:01:36 +05:00
1 parent 4705c9eb91
commit 2acbbdd7be
@@ -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'ем — не прерывает.
@@ -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.
+
+## Финал — резюме юзеру
+
+- Что согласовано и внесено.
+- Что отклонено и почему.
+- Нерешённые расхождения, если упёрлись (решает юзер).
@@ -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 <sha>`
+- незакоммиченное: `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 в ту же сессию: попроси обосновать или
+  показать репро. Не принимай и не отвергай молча.