add skill

2026-08-21 23:03:44 +07:00
parent a2cadf6eca
commit bafe22a95d
1 changed files with 115 additions and 0 deletions
@@ -0,0 +1,115 @@
+---
+name: task-execution
+description: Выполняет любую нетривиальную задачу по процессу «план → ревью сеньёром → правки → выполнение → ревью результата → правки». План и результат проверяет субагент в роли senior developer; каждый цикл повторяется, пока замечаний не останется. При неясностях агент задаёт вопросы пользователю. Загружай для реализации фичи, исправления бага, рефакторинга, написания кода или документации, когда задача не сводится к одному тривиальному действию.
+whenToUse: Пользователь просит выполнить задачу (написать код, починить баг, отрефакторить, задокументировать, что-то исследовать и внедрить) и задача не является тривиальным одношаговым действием. Для тривиальных правок скил можно не применять.
+---
+
+# Выполнение любой задачи: план → сеньёр → выполнение → сеньёр
+
+## Контекст
+
+Любая нетривиальная задача выполняется строго по циклу: сначала **план**, затем **ревью плана сеньёром** с правками до полного одобрения, затем **выполнение** по одобренному плану, затем **ревью результата сеньёром** с правками, пока замечаний не останется. На каждом этапе, если что-то неясно, задаются вопросы пользователю.
+
+## Роли
+
+- **Исполнитель** — ты (агент). Составляешь план, выполняешь, правишь по замечаниям.
+- **Сеньёр (senior developer)** — отдельный субагент, запускаемый через `subagent`. Он **не видит наш диалог**, поэтому каждый промпт ревью должен быть самодостаточным: включай в него всю необходимую информацию (задачу, план, критерии, предыдущие замечания).
+- **Пользователь** — источник требований и финальный судья. Ему задаются вопросы при неясностях.
+
+## Обязательные правила
+
+1. **Сначала план — потом выполнение.** Не начинай выполнение, пока сеньёр не одобрил план (ответил `APPROVED`).
+2. **Ревью плана и результата — только через субагента в роли senior developer** (см. шаблоны промптов ниже). Запускай его с `run_in_background: false` — следующий шаг зависит от его ответа.
+3. **Замечания исправляются все, без выбора.** Нельзя отбрасывать замечание «потому что не согласен»: если не согласен — верни уточняющий вопрос сеньёру или спроси пользователя.
+4. **Цикл повторяется, пока сеньёр не вернёт `APPROVED`** — и для плана, и для результата.
+5. **Неясно — спроси.** На любом этапе (задача, шаг плана, замечание сеньёра) при неоднозначности задай вопрос пользователю через `ask_user_question`. Догадки вместо вопросов — ошибка.
+6. **Отслеживай прогресс** через `todo_write`: план из шага 2 переносится в todo-список, пункты отмечаются по мере выполнения.
+7. **Профильные скилы** (например `create-go-module`) — источник правил «как делать» для конкретной задачи. Этот скил управляет процессом «как вести задачу»; оба применяются вместе.
+
+## Шаги
+
+### 1. Уточни задачу
+
+Разберись, что именно нужно сделать. Если неясны цель, объём, ограничения или критерии приёмки — задай вопросы пользователю до составления плана.
+
+### 2. Составь план
+
+План должен содержать:
+
+- **Цель** и ожидаемый результат;
+- **Шаги** с конкретными файлами, командами и артефактами;
+- **Проверки** (сборка, тесты, линтеры, вёрстка и т.п.);
+- **Критерии готовности** — что считается «сделано»;
+- **Риски и открытые вопросы** (если есть).
+
+Заведи todo-список через `todo_write` в соответствии с планом.
+
+### 3. Ревью плана сеньёром
+
+Запусти субагента с промптом по шаблону **«Ревью плана»** (ниже). Сеньёр возвращает либо `APPROVED`, либо список замечаний.
+
+### 4. Цикл правок плана
+
+- Есть замечания → исправь план (и todo-список), отправь на ревью **повторно**: в промпт добавь предыдущие замечания и что именно изменилось.
+- Повторяй, пока не получишь `APPROVED`.
+
+### 5. Выполнение
+
+Выполняй строго по одобренному плану, отмечая прогресс в `todo_write`. Если в ходе выполнения стало ясно, что план нужно изменить — не отклоняйся молча: вернись к шагу 3 с обновлённым планом.
+
+### 6. Ревью результата
+
+Сначала сам проверь результат (прогони проверки из плана), затем отдай его сеньёру по шаблону **«Ревью результата»**. Сеньёр сверяет результат с планом и критериями, проверяет корректность и соблюдение конвенций проекта.
+
+### 7. Цикл правок результата
+
+Правь по замечаниям, повторяй ревью, пока сеньёр не вернёт `APPROVED`. При каждом повторе сообщай сеньёру, что изменилось с прошлого раза.
+
+### 8. Финальный отчёт
+
+Кратко сообщи пользователю: что сделано, какие файлы затронуты, как проверялось, что план и результат одобрены сеньёром.
+
+## Шаблон: промпт «Ревью плана»
+
+```
+Ты — senior developer. Оцени план выполнения задачи.
+
+Задача: <текст задачи>
+План: <план>
+Критерии готовности: <критерии>
+
+Проверь: полноту (нет ли пропущенных шагов), достижимость, корректность
+подхода, риски, соответствие конвенциям проекта, отсутствие лишних шагов.
+Ответь СТРОГО одним из двух вариантов:
+- APPROVED — если замечаний нет;
+- список замечаний, каждое в формате «<что не так> → <как исправить>».
+```
+
+## Шаблон: промпт «Ревью результата»
+
+```
+Ты — senior developer. Оцени результат выполнения задачи.
+
+Задача: <текст задачи>
+План: <план>
+Критерии готовности: <критерии>
+Результат: <что сделано: файлы, изменения, выводы проверок>
+
+Проверь: результат соответствует плану и критериям готовности, код/текст
+корректен, соблюдены конвенции проекта, нет регрессий.
+Ответь СТРОГО одним из двух вариантов:
+- APPROVED — если замечаний нет;
+- список замечаний, каждое в формате «<что не так> → <как исправить>».
+```
+
+## Ограничение итераций
+
+Если в одном цикле (план или результат) после **5 раундов** замечания не исчерпались — остановись и спроси пользователя: продолжать цикл или зафиксировать оставшиеся замечания как известные ограничения.
+
+## Критерии готовности
+
+- [ ] План составлен и одобрен сеньёром (`APPROVED`) до начала выполнения.
+- [ ] Все замечания сеньёра по плану учтены.
+- [ ] Результат соответствует плану и критериям готовности.
+- [ ] Все замечания сеньёра по результату учтены, получен `APPROVED`.
+- [ ] Пользователю дан финальный отчёт.