Урок 17.5. Справочник скиллов: полная библиотека

Сверено по каталогу: https://github.com/obra/superpowers/tree/main/skills (frontmatter всех SKILL.md, срез 2026-10-03)

Зачем это нужно

К уроку 17.4 известна механика; прежде чем разбирать каждый шаг процесса (уроки 17.6–17.12), нужна карта: какие скиллы существуют, когда какой срабатывает и что остается на выходе. README проекта делит библиотеку на четыре категории (Testing, Debugging, Collaboration, Meta) и подчеркивает: «The agent checks for relevant skills before any task. Mandatory workflows, not suggestions» — это справочник по обязательным процедурам, а не меню на выбор.

Этот урок — табличный справочник, как справочник команд /opsx:* в модуле 15 и /speckit.* в уроке 2.8: используйте его как оглавление модуля и для навигации по репозиторию; полный текст каждого скилла — по ссылкам «Оригинал» соответствующего урока.

Основная идея

Библиотека — 15 скиллов, покрывающих весь цикл разработки: замысел → дизайн → изоляция → план → исполнение → тесты → ревью → завершение → отладка → верификация, плюс метаскиллы (как писать скиллы и как их применять). Триггеры описаны так, что каждый этап автоматически получает своего скилла: запрос на фичу → brainstorming; сообщение о баге → systematic-debugging; наличие плана → исполнение; готовность заявить «готово» → verification-before-completion.

flowchart TD subgraph Цикл["Полный цикл: скиллы по этапам"] A["brainstorming"] --> B["using-git-worktrees"] B --> C["writing-plans"] C --> D["subagent-driven-development или executing-plans"] D --> E["test-driven-development (на каждой задаче)"] D --> F["requesting-code-review / receiving-code-review"] D --> G["dispatching-parallel-agents (независимые задачи)"] E --> H["finishing-a-development-branch"] F --> H end I["systematic-debugging (баг в любой момент)"] -.-> D J["verification-before-completion (перед любым «готово»)"] -.-> H K["diagnosing-superpowers (сессия пошла не так)"] -.-> Цикл L["Meta: using-superpowers, writing-skills"] -.-> Цикл

Сводная таблица: все 15 скиллов

Формат: имя → триггер (по description) → действие → артефакт/результат → урок разбора.

Testing

Скилл	Триггер	Что делает	Урок
`test-driven-development`	реализация любой фичи или багфикса, до написания кода	цикл RED-GREEN-REFACTOR: падающий тест → минимальный код → рефакторинг → коммит; справочник антипаттернов тестирования	17.10

Debugging

Скилл	Триггер	Что делает	Урок
`systematic-debugging`	любой баг, падение теста, неожиданное поведение — до предложения фиксов	4-фазный процесс поиска корневой причины; включает техники `root-cause-tracing`, `defense-in-depth`, `condition-based-waiting`	17.13
`verification-before-completion`	перед заявлением «готово/исправлено/проходит» — перед коммитом и PR	требует запустить команду верификации и прочесть вывод: доказательства прежде заявлений	17.13
`diagnosing-superpowers`	сессия Superpowers пошла не так: повторная работа, игнор плана, молчащий скилл, «слишком дорого»	читает транскрипты сессии, отчет с доказательствами `path:line`, по запросу — обезличенный пакет для баг-репорта	17.14

Collaboration

Скилл	Триггер	Что делает	Урок
`brainstorming`	перед любой творческой работой: фичи, компоненты, функциональность, изменение поведения	уточняет замысел и требования сократическим диалогом; маршруты spike/bounded/architectural; сохраняет дизайн-документ	17.6
`writing-plans`	есть спека или требования многошаговой задачи, до касания кода	план из задач по 2-5 минут: точные пути, полный код, шаги верификации — для исполнителя без контекста	17.8
`executing-plans`	партнер выбрал инлайн-исполнение, или нет инструмента сабагентов	все задачи в текущей сессии, TDD на каждом шаге, одно свежее ревью ветки в конце	17.9
`subagent-driven-development`	исполнение плана с независимыми задачами в текущей сессии	свежий сабагент-исполнитель на задачу + ревью после каждой (соответствие плану, затем качество) + широкое ревью ветки в конце	17.9
`dispatching-parallel-agents`	2+ независимых задачи без общего состояния	по агенту на независимую домен-область, параллельная диспетчеризация, интеграция и полный прогон тестов	17.9
`requesting-code-review`	завершение задач, крупных фич, перед merge	диспетчеризует сабагента-ревьюера с точно собранным контекстом; замечания по критичности	17.11
`receiving-code-review`	получение замечаний, особенно неясных или сомнительных	техническая проверка прежде исполнения: перечитай, пойми, проверь против кодовой базы, отвечай технически	17.11
`using-git-worktrees`	начало работы над фичей, требующей изоляции, или перед исполнением планов	изолированное рабочее дерево (нативный инструмент каркаса, иначе git worktree), setup, чистый бейзлайн тестов	17.7
`finishing-a-development-branch`	реализация завершена, тесты проходят, пора интегрировать	проверяет тесты, определяет окружение, предъявляет опции (merge / PR / оставить / удалить), вычищает worktree	17.12

Скилл	Триггер	Что делает	Урок
`writing-skills`	создание или редактирование скиллов, проверка перед деплоем	TDD для документации: давление-сценарии до, минимальный скилл, закрытие лазеек после	17.15
`using-superpowers`	старт любого диалога	правило «скиллы проверяются до любого ответа»; отображение действий на инструменты каркаса	17.4

Слэш-команды ручного вызова

В Claude Code плагин выставляет слэш-команды семейства /superpowers:* (урок 17.3); по туториалу OpenCodeDocs базовые:

Команда	Скилл
`/superpowers:brainstorm`	`brainstorming`
`/superpowers:write-plan`	`writing-plans`
`/superpowers:execute-plan`	исполнение плана (`executing-plans` / `subagent-driven-development`)

Слэш-команды — способ явно направить агента; основная механика — автоматические триггеры по description (урок 17.4). Состав команд может отличаться между каркасами и версиями — проверяйте /help после установки.

Семь шагов базового workflow

README формулирует базовый workflow как последовательность с активацией по ходу процесса — приведем как в уроке 17.1, но в терминах триггеров:

№	Скилл	Активируется	Урок
1	`brainstorming`	перед написанием кода	17.6
2	`using-git-worktrees`	после согласования дизайна	17.7
3	`writing-plans`	с согласованным дизайном	17.8
4	`subagent-driven-development` или `executing-plans`	с готовым планом	17.9
5	`test-driven-development`	во время реализации	17.10
6	`requesting-code-review`	между задачами	17.11
7	`finishing-a-development-branch`	когда задачи завершены	17.12

Поверх этой канвы — сквозные скиллы: systematic-debugging (любой баг в любой момент), verification-before-completion (любое «готово»), dispatching-parallel-agents (независимые задачи), receiving-code-review (любые замечания), diagnosing-superpowers (сбой самого Superpowers).

Как пользоваться справочником

Читать по урокам: колонка «Урок» — карта модуля; каждый скилл из таблицы разобран в своем уроке с полным переводом ключевых правил.
Сверяться по репозиторию: прямой текст — skills/<имя>/SKILL.md; frontmatter каждого скилла начинается с description, по которому он срабатывает.
Не путать скилл и команду: скилл — процедурный документ; слэш-команда — лишь ручной вызов некоторых из них.

Краткое резюме

Библиотека Superpowers — 15 скиллов в четырех категориях: Testing (1), Debugging (3), Collaboration (9), Meta (2). Каждый этап разработки покрыт скиллом с автоматическим триггером; дисциплины парные — «включающий» и «требующий» скилл.

Справочник = карта модуля: колонка «Урок» ведет к полному разбору каждого скилла.
Базовый workflow — 7 шагов; поверх — сквозные скиллы отладки, верификации и диагностики.
Слэш-команды (/superpowers:brainstorm и др.) — ручной вызов; норма — автоматические триггеры по description.
Полный текст каждого скилла — skills/<имя>/SKILL.md в репозитории.

Вопросы для самопроверки

Назовите четыре категории библиотеки и по одному скиллу каждой; зачем нужны метаскиллы?
Какие два скилла исполняют один план и по какому критерию выбирается режим?
Почему verification-before-completion не входит в «семь шагов» базового workflow? Когда он срабатывает?
Приведите две парные дисциплины из библиотеки и объясните, что держит каждая сторона пары.
Чем слэш-команда /superpowers:write-plan отличается от скилла writing-plans? Какой способ основной?

Что дальше

Со следующего урока, 17.6, начинается разбор основного процесса по шагам: первый шаг — brainstorming, маршруты spike/bounded/architectural и устройство обязательных контрольных точек HARD-GATE.