Skip to content

An agentic skills framework & software development methodology that works.

License

Notifications You must be signed in to change notification settings

h0rn3t/superpowers

 
 

Repository files navigation

Superpowers

Superpowers — це повний робочий процес розробки програмного забезпечення для ваших агентів кодування, побудований на основі набору компонованих «навичок» та деяких початкових інструкцій, які забезпечують їх використання вашим агентом.

Як це працює

Все починається з моменту запуску вашого агента кодування. Як тільки він бачить, що ви щось створюєте, він не одразу намагається писати код. Натомість він робить крок назад і запитує вас, що ви хочете побудувати.

Після того як він зібрав специфікацію з розмови, він показує її вам частинами, достатньо короткими, щоб можна було прочитати та засвоїти.

Коли ви затвердили дизайн, ваш агент складає план реалізації, який достатньо зрозумілий для прилежного молодшого інженера без досвіду, без судження, без контексту проекту та...

Далі, як тільки ви скажете «го», він запускає процес subagent-driven-development, де агенти проходять через кожне інженерне завдання, перевіряють свою роботу та рухаються далі. Це не...

��ут є багато чого ще, але це суть системи. І тому що навички спрацьовують автоматично, вам не потрібно нічого робити особливого. Ваш агент кодування просто має Superpowers.

Установка

Примітка: Установка різниться за платформами. Claude Code або Cursor мають вбудовані маркетплейси плагінів. Codex та OpenCode потребують ручного налаштування.

Claude Code (через Marketplace)

У Claude Code зареєструйте маркетплейс спочатку:

/plugin marketplace add obra/superpowers-marketplace

Потім установіть плагін із цього маркетплейсу:

/plugin install superpowers@superpowers-marketplace

Cursor (через Marketplace)

У Cursor Agent chat установіть з маркетплейсу:

/plugin-add superpowers

Codex

Скажіть Codex:

Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.codex/INSTALL.md

Детальна документація: docs/README.codex.md

OpenCode

Скажіть OpenCode:

Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md

Детальна документація: docs/README.opencode.md

Перевірка установки

Розпочніть нову сесію у вибраній платформі та попросіть щось, що повинно спрацювати навичку (наприклад, «help me plan this feature» або «let's debug this issue»). Агент повинен автоматично...

Базовий робочий процес

  1. brainstorming - Активується перед написанням коду. Уточнює грубі ідеї через запитання, досліджує альтернативи, представляє дизайн частинами для затвердження. Зберігає документ дизайну.

  2. using-git-worktrees - Активується після затвердження дизайну. Створює ізольоване робоче середовище на новій гілці, запускає налаштування проекту, перевіряє чистий базовий рівень тестів.

  3. writing-plans - Активується з затвердженим дизайном. Розбиває роботу на невеликі завдання (2-5 хвилин кожне). Кожне завдання має точні шляхи файлів, повний код, кроки перевірки.

  4. subagent-driven-development або executing-plans - Активується з планом. Відправляє свіжого підагента на завдання з двостадійним переглядом (відповідність специфікації, потім якість коду), або виконує партіями...

  5. test-driven-development - Активується під час реалізації. Застосовує RED-GREEN-REFACTOR: напишіть тест, що не проходить, спостерігайте за відмовою, напишіть мінімальний код, спостерігайте за успіхом, зафіксуйте. Видаляє код, написаний до...

  6. requesting-code-review - Активується між завданнями. Переглядає за планом, звітує про проблеми за серйозністю. Критичні проблеми блокують прогрес.

  7. finishing-a-development-branch - Активується при завершенні завдань. Перевіряє тести, представляє опції (merge/PR/keep/discard), очищує worktree.

Агент перевіряє наявність відповідних навичок перед будь-яким завданням. Обов'язкові робочі процеси, не пропозиції.

Що всередині

Бібліотека навичок

Тестування

  • test-driven-development - RED-GREEN-REFACTOR цикл (включає довідник антипатернів тестування)

Налагодження

  • systematic-debugging - 4-фазовий процес пошуку корінної причини (включає root-cause-tracing, defense-in-depth, condition-based-waiting технікі)
  • verification-before-completion - Переконатися, що це дійсно виправлено

Співпраця

  • brainstorming - Сократівське уточнення дизайну
  • writing-plans - Детальні плани реалізації
  • executing-plans - Пакетне виконання з контрольними точками
  • dispatching-parallel-agents - Одночасні робочі процеси підагентів
  • requesting-code-review - Попередня перевірка контрольного списку
  • receiving-code-review - Відповідь на відгуки
  • using-git-worktrees - Паралельні гілки розробки
  • finishing-a-development-branch - Робочий процес рішення merge/PR
  • subagent-driven-development - Швидка ітерація з двостадійним переглядом (відповідність специфікації, потім якість коду)

Мета

  • writing-skills - Створіть нові навички, дотримуючись найкращих практик (включає методологію тестування)
  • using-superpowers - Введення в систему навичок

Філософія

  • Test-Driven Development - Пишіть тести спершу, завжди
  • Systematic over ad-hoc - Процес замість вгадування
  • Complexity reduction - Простота як основна мета
  • Evidence over claims - Перевіряйте перед оголо��енням успіху

Читайте далі: Superpowers для Claude Code

Внесення внеску

Навички живуть безпосередньо в цьому репозиторії. Щоб внести внесок:

  1. Fork репозиторій
  2. Створіть гілку для своєї навички
  3. Дотримуйтесь навички writing-skills для створення та тестування нових навичок
  4. Надішліть PR

Дивіться skills/writing-skills/SKILL.md для повного посібника.

Оновлення

Навички оновлюються автоматично при оновленні плагіна:

/plugin update superpowers

Ліцензія

MIT License - див. файл LICENSE для деталей

Підтримка

About

An agentic skills framework & software development methodology that works.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • Shell 76.4%
  • JavaScript 12.4%
  • Python 5.7%
  • TypeScript 4.3%
  • Batchfile 1.2%