Составляет подробный пошаговый план реализации по спецификации или требованиям — до начала изменений в коде. План помогает разработчику без контекста проекта понять, какие файлы менять, что тестировать и в каком порядке выполнять задачи.

Возможности

• Сначала описывает файлы для создания и изменения и их ответственность.
• Делит работу на небольшие задачи с независимо проверяемым результатом.
• Для каждого шага указывает конкретные тесты, команды запуска и ожидаемый результат.
• Учитывает TDD, частые коммиты и принципы DRY и YAGNI.
• Проверяет план на полноту относительно спецификации, заглушки и несоответствия типов и интерфейсов.
• По умолчанию сохраняет планы в docs/superpowers/plans/YYYY-MM-DD-<feature-name>.md.

Когда использовать

• Есть спецификация или требования для задачи из нескольких шагов.
• Нужно до начала работы определить, какие файлы затронуть и как разбить реализацию.
• В спецификации объединены несколько независимых подсистем: навык предложит разделить работу на отдельные планы.
• План должен быть понятен разработчику, который почти не знаком с кодовой базой или предметной областью.

Примеры

Запуск теста из шага плана:

pytest tests/path/test.py::test_name -v

Коммит результата задачи:

git add tests/path/test.py src/path/file.py
git commit -m "feat: add specific feature"

Установка

npx skills add https://github.com/obra/superpowers --skill writing-plans