From bafe22a95dc9a988a6fd6b795c2d94c8594fa100 Mon Sep 17 00:00:00 2001 From: Fedorov Vladimir Date: Fri, 21 Aug 2026 23:03:44 +0700 Subject: [PATCH] add skill --- .dsh/skills/task-execution/SKILL.md | 115 ++++++++++++++++++++++++++++ 1 file changed, 115 insertions(+) create mode 100644 .dsh/skills/task-execution/SKILL.md diff --git a/.dsh/skills/task-execution/SKILL.md b/.dsh/skills/task-execution/SKILL.md new file mode 100644 index 0000000..0a53a11 --- /dev/null +++ b/.dsh/skills/task-execution/SKILL.md @@ -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`. +- [ ] Пользователю дан финальный отчёт.