Superpowers (obra/superpowers)
- 추천0
- GitHub 별318K
- 개발라이선스MIT
코딩 에이전트용 개발 방법론 스킬 모음. 되묻기 · 설계 · 계획 · TDD · 서브에이전트 개발 · 코드 리뷰를 자동으로 이어 줘요
요약
코딩 에이전트용 개발 방법론 스킬 모음. 되묻기 · 설계 · 계획 · TDD · 서브에이전트 개발 · 코드 리뷰를 자동으로 이어 줘요
설명
Superpowers
Superpowers는 코딩 에이전트를 위한 완성형 소프트웨어 개발 방법론입니다. 서로 조합할 수 있는 스킬 묶음과, 에이전트가 그 스킬을 꼭 쓰도록 만드는 기본 지침으로 이루어져 있습니다.
작동 방식
코딩 에이전트를 켜는 순간부터 시작됩니다. 무언가를 만든다는 것을 알아차리면 곧바로 코드를 쓰지 않습니다. 대신 한 걸음 물러서서 진짜로 무엇을 하려는지 묻습니다.
대화에서 스펙을 끌어내면, 실제로 읽고 소화할 수 있을 만큼 짧게 나눠 보여 줍니다.
설계를 승인하면, 에이전트가 구현 계획을 만듭니다. 취향도 판단력도 없고, 프로젝트 맥락도 모르고, 테스트를 싫어하는 의욕 넘치는 주니어 엔지니어도 따라할 수 있을 만큼 분명한 계획입니다. 진짜 레드/그린 TDD, YAGNI(You Aren't Gonna Need It, 필요 없는 건 만들지 않는다), DRY(중복 금지)를 강조합니다.
그다음으로 "진행해"라고 말하면 subagent-driven-development(서브에이전트 주도 개발) 과정을 시작합니다. 에이전트들이 엔지니어링 작업을 하나씩 맡고, 그 결과를 점검·리뷰하며 계속 나아갑니다. 에이전트가 세운 계획에서 벗어나지 않고 한 번에 두어 시간씩 스스로 일하는 것도 드문 일이 아닙니다.
이 밖에도 많은 것이 있지만, 시스템의 핵심은 이것입니다. 스킬이 자동으로 발동하므로 따로 할 것은 없습니다. 코딩 에이전트에 그냥 Superpowers가 생기는 것입니다.
상업 서비스
기업에서 Superpowers를 쓰고 있고 상업적 지원, 추가 도구, 지출 관리가 필요하다면 망설이지 말고 sales@primeradiant.com으로 연락하세요.
설치
설치 방법은 하네스(harness, 에이전트 실행 환경)마다 다릅니다. 여러 개를 쓴다면 하네스마다 Superpowers를 따로 설치하세요.
Claude Code
Superpowers는 공식 Claude 플러그인 마켓플레이스에서 받을 수 있습니다.
공식 마켓플레이스
-
Anthropic의 공식 마켓플레이스에서 플러그인을 설치합니다.
/plugin install superpowers@claude-plugins-official
Superpowers 마켓플레이스
Superpowers 마켓플레이스는 Claude Code용으로 Superpowers와 관련 플러그인 몇 개를 제공합니다.
-
마켓플레이스를 등록합니다.
/plugin marketplace add obra/superpowers-marketplace -
이 마켓플레이스에서 플러그인을 설치합니다.
/plugin install superpowers@superpowers-marketplace
Antigravity
이 저장소에서 Superpowers를 플러그인으로 설치합니다.
agy plugin install https://github.com/obra/superpowers
Antigravity는 설치된 각 스킬의 설명을 목록으로 보여 주고, using-superpowers 스킬의 설명이 모델에게 대화 시작 때 그 스킬을 불러오도록 안내합니다. 업데이트하려면 같은 명령으로 다시 설치하세요.
Codex 앱
Superpowers는 공식 Codex 플러그인 마켓플레이스에서 받을 수 있습니다.
- Codex 앱에서 사이드바의 Plugins를 누릅니다.
- Coding 섹션에
Superpowers가 보일 것입니다. - Superpowers 옆의
+를 누르고 안내를 따릅니다.
Codex CLI
Superpowers는 공식 Codex 플러그인 마켓플레이스에서 받을 수 있습니다.
-
플러그인 검색 화면을 엽니다.
/plugins -
Superpowers를 검색합니다.
superpowers -
Install Plugin을 선택합니다.
Cursor
-
Cursor Agent 채팅에서 마켓플레이스로 설치합니다.
/add-plugin superpowers -
또는 플러그인 마켓플레이스에서 "superpowers"를 검색합니다.
Devin CLI
-
이 저장소에서 플러그인을 설치합니다.
devin plugins install obra/superpowers -
최신 버전으로 업데이트합니다.
devin plugins update superpowers
Factory Droid
-
마켓플레이스를 등록합니다.
droid plugin marketplace add https://github.com/obra/superpowers -
플러그인을 설치합니다.
droid plugin install superpowers@superpowers
Gemini CLI
-
확장을 설치합니다.
gemini extensions install https://github.com/obra/superpowers -
나중에 업데이트합니다.
gemini extensions update superpowers
GitHub Copilot CLI
-
마켓플레이스를 등록합니다.
copilot plugin marketplace add obra/superpowers-marketplace -
플러그인을 설치합니다.
copilot plugin install superpowers@superpowers-marketplace
Grok Build CLI
Superpowers는 공식 Grok 플러그인 마켓플레이스에서 받을 수 있습니다.
-
xAI의 공식 마켓플레이스에서 플러그인을 설치합니다.
grok plugin install superpowers@xai-official --trust -
또는 TUI에서 마켓플레이스를 열고 Superpowers를 검색해 설치합니다.
/marketplace
Kimi Code
Superpowers는 Kimi Code의 플러그인 마켓플레이스에서 받을 수 있습니다.
-
Kimi Code의 플러그인 관리자를 엽니다.
/plugins -
Marketplace>Superpowers로 가서 설치합니다. -
또는 이 저장소에서 바로 설치합니다.
/plugins install https://github.com/obra/superpowers -
자세한 문서: docs/README.kimi.md
OpenCode
OpenCode는 자체 플러그인 설치 방식을 씁니다. 다른 하네스에서 이미 쓰고 있어도 Superpowers를 따로 설치하세요.
-
OpenCode에게 이렇게 말합니다.
Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md -
자세한 문서: docs/README.opencode.md
Pi
이 저장소에서 Superpowers를 Pi 패키지로 설치합니다.
pi install git:github.com/obra/superpowers
로컬에서 개발할 때는 이 체크아웃을 임시 패키지로 불러와 Pi를 실행합니다.
pi -e /path/to/superpowers
Pi 패키지는 Superpowers 스킬과, 세션이 시작될 때와 컨텍스트 압축 뒤에 using-superpowers 부트스트랩을 넣어 주는 작은 확장을 불러옵니다. Pi는 스킬을 네이티브로 지원하므로 호환용 Skill 도구가 필요 없습니다. 서브에이전트와 할 일 목록 도구는 선택적인 Pi 보조 패키지로 남아 있습니다.
Qwen Code
Qwen Code는 Claude Code 마켓플레이스의 플러그인을 직접 설치합니다.
-
이 저장소에서 플러그인을 설치하고, 묻으면
superpowers를 고릅니다.qwen extensions install obra/superpowers -
나중에 업데이트합니다.
qwen extensions update superpowers
Hermes Agent
이 저장소에서 Superpowers를 Hermes 플러그인으로 설치합니다.
hermes plugins install obra/superpowers --enable
설치한 뒤 실행 중인 Hermes 세션을 모두 다시 시작하세요. 참고: Hermes에는 컨텍스트 압축 뒤에 실행되는 훅이 없어서, 첫 번째 턴을 넘겨 압축되는 아주 긴 세션에서는 부트스트랩이 사라집니다. 스킬이 발동하지 않으면 새 세션을 시작하세요.
Muse
Superpowers는 네이티브 Muse 플러그인으로도 쓸 수 있습니다. 저장소도 스킬도 모든 하네스에서 같습니다. using-superpowers 부트스트랩은 Claude Code, Codex, Cursor, Gemini, Pi 등과 마찬가지로 네이티브 SessionStart 훅으로 들어가서, 세션마다 따로 켜 필요가 없습니다.
-
로컬 체크아웃에서 설치합니다.
muse plugins install ./ muse plugins approve superpowers또는 클론해서 설치합니다.
git clone https://github.com/obra/superpowers.git muse plugins install ./superpowers muse plugins approve superpowers -
나중에 업데이트합니다.
muse plugins update superpowers
설치한 뒤 실행 중인 Muse 세션을 다시 시작해야 SessionStart 훅이 적용됩니다. 스킬은 바로 켜지지만 훅은 처음 설치할 때 승인이 필요합니다. 확인하려면 새 세션을 시작하고 Let's make a react todo list를 보내 보세요. 제대로 설치됐다면 코드를 쓰기 전에 brainstorming이 자동으로 발동합니다. 버전은 .version-bump.json에서 관리되고, scripts/bump-version.sh가 이를 맞춰 줍니다.
기본 워크플로
-
brainstorming - 무언가를 만들기 전에 발동합니다. 질문을 통해 진짜로 원하는 것과 그 이유를 끌어내고, 이해한 내용을 다시 들려주어 바로잡게 합니다. 작은 변경은 채팅에서 합의하고, 프로젝트는 개발자가 계획을 세울 수 있을 만한 설계 문서를 작성합니다.
-
using-git-worktrees - 설계 승인 뒤에 발동합니다. 새 브랜치에 격리된 작업 공간을 만들고, 프로젝트 설정을 실행하고, 테스트 기준선이 깨끗한지 확인합니다.
-
writing-plans - 승인된 설계가 있을 때 발동합니다. 작업을 아주 작은 단위(각 2~5분)로 쪼갭니다. 모든 작업에 정확한 파일 경로, 완전한 코드, 검증 단계가 들어 있습니다.
-
subagent-driven-development 또는 executing-plans - 계획이 있을 때 발동합니다. 작업마다 새 서브에이전트를 보내고 끝날 때마다 리뷰하거나(가장 꼼꼼함), 현재 세션에서 모든 작업을 이어서 구현하고 마지막에 브랜치 전체를 새롭게 한 번 리뷰합니다(가장 저렴함).
-
test-driven-development - 구현하는 동안 발동합니다. RED-GREEN-REFACTOR를 강제합니다. 실패하는 테스트를 쓰고, 실패하는 것을 확인하고, 최소한의 코드를 쓰고, 통과하는 것을 확인하고, 커밋합니다. 테스트보다 먼저 쓴 코드는 지웁니다.
-
requesting-code-review - 작업 사이에 발동합니다. 계획과 대조해 리뷰하고 문제를 심각도별로 보고합니다. 심각한 문제는 진행을 막습니다.
-
finishing-a-development-branch - 작업이 끝났을 때 발동합니다. 테스트를 확인하고, 선택지(병합/PR/유지/폐기)를 보여 주고, 워크트리를 정리합니다.
에이전트는 모든 작업 전에 관련 스킬이 있는지 확인합니다. 제안이 아니라 필수 워크플로입니다.
무언가 잘못됐을 때
가끔 세션이 이상하게 동작합니다. 발동하지 말아야 할 때 스킬이 발동하거나, 발동해야 할 때 조용하거나, 에이전트가 계획을 무시하고 같은 일을 반복하거나, 예상보다 토큰을 많이 쓰는 경우입니다. 코딩 에이전트에게 "이 세션에서 superpowers가 뭐가 잘못됐는지 알아봐 줘"라고 하면 diagnosing-superpowers 스킬이 실행됩니다. 이전 세션을 살펴보려면 세션을 지정하세요. "세션 <id>에서 superpowers가 뭐가 잘못됐는지 알아봐 줘".
이 스킬은 세션 기록을 읽고, 무슨 일이 있었는지 줄 단위 근거와 함께 보고하며, 원하면 버그 리포트용으로 개인 정보를 지운 묶음을 만들어 줍니다.
커뮤니티
Superpowers는 Jesse Vincent와 Prime Radiant의 동료들이 만듭니다.
- Discord: 커뮤니티 지원, 질문, Superpowers로 만든 결과물 공유는 여기에서 참여하세요.
- 이슈: https://github.com/obra/superpowers/issues
- 릴리스 소식: 새 버전 알림은 여기에 가입하세요.
안에 든 것
스킬 라이브러리
테스트
- test-driven-development - RED-GREEN-REFACTOR 주기(테스트 안티패턴 참고 자료 포함)
디버깅
- systematic-debugging - 4단계 근본 원인 추적(root-cause-tracing, defense-in-depth, condition-based-waiting 기법 포함)
- verification-before-completion - 정말 고쳐졌는지 확인
- diagnosing-superpowers - 세션에서 무엇이 잘못됐는지 근거와 함께 파악. 개인 정보를 지운 묶음을 내보내거나 이슈를 등록
협업
- brainstorming - 만들기 전에 의도를 끌어내기
- writing-plans - 상세한 구현 계획
- executing-plans - 인라인 계획 실행: 하나의 컨텍스트, 마지막 한 번의 리뷰
- dispatching-parallel-agents - 동시 서브에이전트 워크플로
- requesting-code-review - 리뷰 전 체크리스트
- receiving-code-review - 피드백에 대응하기
- using-git-worktrees - 병렬 개발 브랜치
- finishing-a-development-branch - 병합/PR 결정 워크플로
- subagent-driven-development - 2단계 리뷰(스펙 충족 여부, 그다음 코드 품질)를 거치는 빠른 반복
메타
- writing-skills - 모범 사례에 맞게 새 스킬 만들기(테스트 방법론 포함)
- using-superpowers - 스킬 체계 소개
철학
- 테스트 주도 개발 - 항상 테스트부터 쓴다
- 즉흥보다 체계적으로 - 추측보다 절차
- 복잡도 줄이기 - 단순함이 첫째 목표
- 주장보다 증거 - 성공이라고 말하기 전에 확인한다
최초 릴리스 안내 글을 읽어 보세요.
기여하기
Superpowers의 일반적인 기여 절차는 아래와 같습니다. 새 스킬의 기여는 일반적으로 받지 않으며, 스킬을 고치는 모든 변경은 지원하는 모든 코딩 에이전트에서 동작해야 합니다. 또한 다른 사람이 올린 이슈를 고치는 에이전트 작성 PR은, 같은 문제를 겪었더라도 메인테이너가 요청했을 때를 제외하고 받지 않습니다. 이럴 때는 이미 있는 이슈에 본인의 보고를 덧붙이세요.
- 저장소를 포크합니다.
- 'dev' 브랜치로 전환합니다.
- 작업용 브랜치를 만듭니다.
- 새 스킬이나 고친 스킬을 만들고 테스트할 때는
writing-skills스킬을 따릅니다. - PR을 제출하며, 사람이 자기 말로 쓴 요약을 포함해 PR 템플릿의 모든 항목을 채웁니다.
스킬 동작 테스트는 superpowers-evals의 drill eval 하네스를 사용하며 evals/에 클론합니다. 설정은 evals/README.md를 보세요. 플러그인 인프라 테스트는 tests/에 있고 해당 run-*.sh 또는 npm test로 실행합니다.
자세한 가이드는 skills/writing-skills/SKILL.md를 보세요.
업데이트
Superpowers 업데이트는 코딩 에이전트에 따라 다르지만 대개 자동으로 이루어집니다.
라이선스
MIT 라이선스 - 자세한 내용은 LICENSE 파일을 보세요.
시각 도우미 사용 통계
스킬과 플러그인은 만든 사람에게 아무 피드백도 주지 않기 때문에, 얼마나 많은 분이 Superpowers를 쓰고 있는지 알 수 없습니다. 기본적으로 brainstorming의 선택적 기능인 시각 도우미에 들어 있는 Prime Radiant 로고는 우리 웹사이트에서 불러옵니다. 이때 사용 중인 Superpowers의 버전이 함께 전달됩니다. 프로젝트, 프롬프트, 코딩 에이전트에 대한 자세한 정보는 들어 있지 않습니다. 클릭이나 무엇을 만들고 있는지는 전혀 보지 않습니다. 이는 몇 명이 어느 버전의 Superpowers를 쓰는지 대략적으로 파악하는 데 도움이 됩니다. 완전히 선택 사항이며, 끄려면 환경 변수 SUPERPOWERS_DISABLE_TELEMETRY를 아무 참 값으로 설정하세요. Superpowers는 Claude Code의 DISABLE_TELEMETRY와 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 옵트아웃도 따릅니다.
평점
- 5점
- 0
- 4점
- 0
- 3점
- 0
- 2점
- 0
- 1점
- 0