Локализованное руководство по чтению
writing-plansНазначение, использование и источник
Используйте этот метод, когда у вас есть спецификация или требования к многоэтапной задаче, прежде чем вносить изменения в код.
Источник получен:
- Репозиторий-источник
- obra/superpowers
- SKILL.md
skills/writing-plans/SKILL.md- Звёзды репозитория
- 309,479
- Последнее обновление репозитория
- 2026-10-30
- Категории Skills
- Рабочий процесс агента
- Время последнего сбора
Лицензия: MIT
Приведенные фрагменты описания рабочих процессов являются вспомогательными средствами для чтения, а не исполняемыми инструкциями от Codez. Для создания этой страницы не использовались сторонние инструменты.
Приведённые ниже фрагменты, описывающие цели и рабочие процессы, представляют собой исходный материал, систематизированный и переведённый для удобства чтения. Они отличаются от отдельно обозначенного редакционного анализа Codez.
Что делает этот навык
Используйте этот метод, когда у вас есть спецификация или требования к многоэтапной задаче, прежде чем вносить изменения в код.
Как работает рабочий процесс на вышестоящем уровне
Обзор
Напишите план реализации для инженера, который не видел этот код или спецификацию. Предположите, что он пишет идиоматический код на языке проекта, как только узнает точный интерфейс и точный тест, и что он сделает разумный выбор там, где план оставляет место для маневра. Чего он не может знать, так это того, что вы решили: какие файлы, какие имена и сигнатуры, какие значения из спецификации, какие тесты доказывают выполнение каждой задачи. Задокументируйте это. Предоставьте ему весь план в виде небольших задач. Принцип DRY (Don't Repeat Yourself — не повторяйте себя). YAGNI (You Ain't Gonna Need It — не дай бог). TDD (Development Development — разработай сам). Частые коммиты. Объявите в начале: «Я использую навык написания планов для создания плана реализации». Контекст: Если работа ведется в изолированном рабочем дереве, план должен был быть создан с помощью...superpowers:using-git-worktreesУровень мастерства на этапе выполнения. Сохраняйте планы в:docs/superpowers/plans/YYYY-MM-DD-.md
Шаговая детализация
Каждый шаг представляет собой одно действие с проверяемым результатом: «Написать тест, который не пройдёт» — шаг; «Запустить его, чтобы убедиться, что он не пройдёт» — шаг; «Реализовать минимальный код, чтобы тест прошёл» — шаг.
проход вверх по течению · L43 ↗Что включает в себя шаг
Шаг считается выполненным, когда разработчик может вывести из него ровно одну разумную вещь. В этом и заключается всё требование: однозначность, но не полнота. Каждый тип шага несёт в себе то, что делает его однозначным, и ничего больше: Шаг тестирования: имя теста и его утверждения в виде кода с точными значениями из спецификации. Шаг кода: точная сигнатура (имя, параметры, тип возвращаемого значения), файл, в котором он находится, и конкретные значения, которые фиксирует спецификация. Тело теста пишет разработчик. Тело появляется только для алгоритма, который не определяется сигнатурой и тестами, или для точной копии, которую исправляет спецификация. Шаг проверки: команда для выполнения и вывод, означающий, что она прошла успешно.
проход вверх по течению · L140 ↗Требования и настройка
Из этого файла не был выбран фрагмент с краткими требованиями. Это не означает, что у навыка нет зависимостей. Проверьте инструкции по настройке репозитория и указанные файлы.
Ограничения и проверки качества
Из этого файла не был выбран отдельный фрагмент с ограничениями. Это не означает, что навык безопасен для любых входных данных или сред. Проверьте полный исходный код и подтвердите свой собственный результат.
Начните с безопасного пробного периода.
- Проверьте поддерживаемый хост и инструкции по установке репозитория. Храните каталог Skill, а также связанные с ним скрипты, ресурсы и документацию вместе;SKILL.mdВ одиночку можно опустить зависимости.
- Предоставьте агенту ваши реальные входные данные, желаемый результат и критерии приемки. Синтаксис вызова и доступные инструменты зависят от хоста; данный сайт не предполагает универсальной команды установки.
- Попробуйте запустить исходный рабочий процесс в тестовом проекте или в его копии. Перед тем как разрешить операции, изменяющие файлы, удаленные сервисы или оплачиваемые ресурсы, проверьте их.
- Проверьте выходные данные на соответствие исходным проверкам качества и вашим собственным требованиям. Успешный запуск или большое количество звезд в репозитории не гарантируют корректного результата.
Подробнее читайте в источнике.
Смежные навыки
Перевод и сфера применения
В этом руководстве по чтению представлены избранные отрывки из закрепленного текста выше по течению.SKILL.mdПеревод выполнен с помощью переводчика. Это не полное руководство и не гарантия проверенной совместимости. Перед использованием ознакомьтесь с оригиналом и указанными в нем файлами.
Данное введение относится к закрепленной ниже версии; текущая активность в репозитории и время сбора данных отображаются отдельно.
- Закрепленный источник
- Прочитайте оригинал ↗
- Источник получен
- Исходный коммит
2ce8aa15d05bd57213e6f746f953aafb7ded7a8b- Исходный SHA-256
a6c67c1900064347c2a329990dd3c555657c51c3ec53b259a08aa01a2c26139a