Writing Plans: скилл Superpowers, который пишет план до правки кода

obra/superpowers· Проверено 13.11.2026· 317 тыс.на GitHub

Скилл Superpowers: по спецификации агент пишет план реализации для инженера, который не видел ни кода, ни спецификации: файлы, сигнатуры, тесты и команды проверки на каждый шаг.

Как установить Writing Plans

Личные скиллы лежат в ~/.claude/skills/, проектные — в .claude/skills/ репозитория. Проверка: команда /skills в сессии, вызов по имени — /writing-plans.

# плагином, внутри Claude Code
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace

# или вручную
git clone --depth 1 https://github.com/obra/superpowers.git /tmp/writing-plans
mkdir -p ~/.claude/skills/writing-plans
cp -r /tmp/writing-plans/skills/writing-plans/. ~/.claude/skills/writing-plans/

Что умеет

Расписать, какие файлы создать или изменить и за что отвечает каждый
Разбить работу на задачи с собственным циклом тестов, а задачи — на шаги в одно действие
Указать в каждом шаге путь, сигнатуру, тест или команду с ожидаемым выводом
Выписать пять сценариев, которые спецификация подразумевает, но тесты не проверяют (Review Focus)
Сверить план со спецификацией: покрытие требований, согласованность типов, длину

План сохраняется в docs/superpowers/plans/ГГГГ-ММ-ДД-<фича>.md и начинается с шапки: цель, архитектура, стек, путь к спецификации, глобальные ограничения.

У каждой задачи есть блок Interfaces: что она берёт у прежних задач и что отдаёт следующим, с точными именами и типами.

Шаг теста — код теста с утверждениями, шаг кода — сигнатура и файл; тело функции пишет исполнитель.

В конце агент просит проверить план и выбрать исполнение: субагентами (subagent-driven-development) или самому в текущей сессии (executing-plans).

Что нужно
АгентыСтавится вместе с набором Superpowers в Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot CLI, OpenCode, Qwen Code и другие агенты.

Что попросить агента

Напиши план реализации по <docs/superpowers/specs/2026-11-13-auth-design.md>Разложит работу на задачи с файлами, интерфейсами и тестами, сверит план со спецификацией и спросит, как его выполнять
У меня спецификация на <API, админку и мобильное приложение>Предложит разбить её на отдельные планы по подсистемам, каждый с рабочим и тестируемым результатом
План вышел длиннее самого кода, переделайЗаменит тела функций на сигнатуры, имена тестов и утверждения, оставив только решения

Ограничения

!

Если спецификация охватывает несколько независимых подсистем, скилл предлагает разбить её на отдельные планы

!

Рассчитан на цепочку Superpowers: план выполняют скиллы subagent-driven-development или executing-plans

Описание из SKILL.md

Use when you have a spec or requirements for a multi-step task, before touching code

Частые вопросы

Как установить writing-plans skill в Claude Code?
Поставьте набор Superpowers: /plugin install superpowers@claude-plugins-official или через маркетплейс автора obra/superpowers-marketplace. Скилл writing-plans включится сам, когда задача подойдёт.
Откуда writing-plans берёт спецификацию?
Обычно из дизайн-документа, который пишет скилл brainstorming. Путь к спецификации стоит в шапке плана, исполнители читают оба файла.
Почему в плане нет готового кода функций?
План фиксирует решения, которые исполнитель не примет сам: файлы, имена, сигнатуры, значения из спецификации, тесты. Тело функции появляется только для алгоритма, который сигнатура и тесты не определяют.
Где лежит план?
По умолчанию в docs/superpowers/plans/ с датой в имени файла. Если вы указали другое место, агент возьмёт его.
Как выбрать способ выполнения?
Субагентами — самый тщательный: свежий исполнитель и ревьюер на каждую задачу. Самому в сессии — дешевле и быстрее, одно ревью всей ветки в конце. Агент порекомендует один из двух под конкретный план.

Похожие скиллы