Skip to content

Superpowers.md

Latest commit

 

History

History
105 lines (75 loc) · 5.28 KB

Superpowers.md

File metadata and controls

105 lines (75 loc) · 5.28 KB

Да, можно! Если у тебя уже есть готовый spec.md (или любой другой документ с требованиями), ты можешь пропустить фазу brainstorming и сразу перейти к планированию.

Вот как это сделать правильно 👇

✅ Вариант 1: Ручной вызов writing-plans (рекомендуется)

Если спецификация уже готова и утверждена:

  1. Положи spec в правильную папку (опционально, но рекомендуется):

    docs/plans/2026-03-01-my-feature-spec.md

  2. Явно попроси агента использовать навык:

    /superpowers:writing-plans

    или просто напиши в чат:

    «У меня есть готовая спецификация в docs/plans/my-feature-spec.md. Используй skill writing-plans, чтобы создать план реализации.»

  3. Агент:

    • Прочитает твой spec ✅
    • Разобьёт его на микро-задачи (по 2–5 минут) 📋
    • Для каждой задачи укажет: точные пути к файлам, код теста, код реализации, команды для запуска 🎯
    • Сохранит план в docs/plans/YYYY-MM-DD-<feature>.md 📄

  4. Дальше — обычное выполнение:

    /superpowers:executing-plans

    или выбери режим: суб-агенты / параллельная сессия.

🔑 Важно: Навык writing-plans требует, чтобы спецификация уже существовала — он не генерирует её, а именно превращает spec в исполняемый план [[2]].

⚡ Вариант 2: Быстрый старт (если spec уже в чате)

Если ты просто вставил текст спецификации в чат:

Вот ТЗ для фичи:
[твой spec.md содержимое]

Пропусти brainstorming, сразу создай план реализации.

Агент должен:

  • Распознать, что требования уже даны
  • Автоматически активировать writing-plans (если настроен авто-триггер) [[22]]
  • Или спросить подтверждение: «Вижу готовую спецификацию. Запустить writing-plans?»

⚠️ Если агент всё равно пытается начать с вопросов — явно укажи:
«Spec утверждён, не задавай уточняющих вопросов, переходи к writing-plans».

🛠️ Вариант 3: Настройка авто-триггера (для продвинутых)

В некоторых конфигурациях можно добавить правило в .superpowers/config.yml (если поддерживается):

skills:
  brainstorming:
    auto_trigger: false
  writing-plans:
    auto_trigger: true
    trigger_conditions:
      - file_exists: "docs/plans/*-spec.md"
      - user_message_contains: ["spec готов", "тз утверждено", "skip brainstorming"]

📌 Пока это экспериментально — проверяй актуальность в docs/.

🔄 Полный укороченный воркфлоу с готовым spec

1. [ТЫ] spec.md уже готов → кладёшь в docs/plans/
2. [ТЫ] пишешь: "/superpowers:writing-plans — используй docs/plans/my-spec.md"
3. [АГЕНТ] создаёт детальный план с тестами и путями к файлам
4. [ТЫ] подтверждаешь план или правишь
5. [АГЕНТ] запускает executing-plans / subagent-driven-development
6. [АГЕНТ] реализует задачу по TDD: RED → GREEN → REFACTOR
7. [АГЕНТ] предлагает: merge / PR / отклонить

❗ Чего НЕ делать

❌ Не надо ✅ Лучше
Ждать, что агент сам найдёт spec Явно указать путь к файлу
Писать «сделай фичу» без контекста Прикрепить spec + сказать «brainstorming skip»
Разрешать агенту менять spec без согласования Требовать: «любые изменения в spec — только после моего approve»

🗣️ По-русски: Superpowers уважает твой труд. Если spec уже готов — он не будет «изобретать велосипед», а сразу превратит его в пошаговый, тестируемый план. Главное — явно сказать, что brainstorming не нужен.

Нужна помощь с примером конфига или шаблоном spec.md, который идеально работает с Superpowers? 🛠️📄