개요
Superpowers는 조합 가능한 스킬 모듈과 초기 명령어를 제공하여 프로그래밍 에이전트에 구조화된 개발 프로세스를 제공합니다. 플러그인 시스템을 통해 다양한 코딩 어시스턴트를 지원하며, 테스트 주도 개발, 체계적인 디버깅 및 협업 계획을 강제합니다.
README 미리보기
# Superpowers\n\nSuperpowers is a complete software development methodology for your coding agents, built on top of a set of composable skills and some initial instructions that make sure your agent uses them.\n\n## Quickstart\n\nGive your agent Superpowers: [Claude Code](#claude-code), [Codex CLI](#codex-cli), [Codex App](#codex-app), [Factory Droid](#factory-droid), [Gemini CLI](#gemini-cli), [OpenCode](#opencode), [Cursor](#cursor), [GitHub Copilot CLI](#github-copilot-cli).\n\n## How it works\n\nIt starts from the moment you fire up your coding agent. As soon as it sees that you're building something, it *doesn't* just jump into trying to write code. Instead, it steps back and asks you what you're really trying to do. \n\nOnce it's teased a spec out of the conversation, it shows it to you in chunks short enough to actually read and digest. \n\nAfter you've signed off on the design, your agent puts together an implementation plan that's clear enough for an enthusiastic junior engineer with poor taste, no judgement, no project context, and an aversion to testing to follow. It emphasizes true red/green TDD, YAGNI (You Aren't Gonna Need It), and DRY. \n\nNext up, once you say "go", it launches a *subagent-driven-development* process, having agents work through each engineering task, inspecting and reviewing their work, and continuing forward. It's not uncommon for Claude to be able to work autonomously for a couple hours at a time without deviating from the plan you put together.\n\nThere's a bunch more to it, but that's the core of the system. And because the skills trigger automatically, you don't need to do anything special. Your coding agent just has Superpowers.\n\n\n## Sponsorship\n\nIf Superpowers has helped you do stuff that makes money and you are so inclined, I'd greatly appreciate it if you'd consider [sponsoring my opensource work](https://github.com/sponsors/obra).\n\nThanks! \n\n- Jesse\n\n\n## Installation\n\nInstallation differs by harness. If you us
FAQ (5)
문제 해결Superpowers brainstorm 서버가 큰 WebSocket 메시지를 받으면 왜 다운되나요?
skills/brainstorming/scripts/server.cjs에서 누락된 페이로드 크기 검사로 인해 클라이언트가 거대한 Buffer.alloc을 트리거하여 프로세스가 충돌할 수 있었습니다. 이는 PR #1555 (dev에 병합됨)에 의해 수정되었으며, 최대 프레임 크기 제한(예: 10MB)이 추가되었습니다. 이 수정 사항이 포함된 최신 버전으로 업그레이드하거나, WebSocket 핸들러에서 MAX_FRAME_BYTES보다 큰 프레임을 거부하는 방식으로 수동으로 패치하십시오.
문제 해결에이전트가 여러 계획을 생성할 때 왜 output token limit에 도달하는가?
Superpowers v5.1.0+로 업데이트하세요. 이 버전에서는 계획 작성이 더 이상 하위 에이전트를 파견하지 않아 토큰 제한을 피할 수 있습니다. 이전 버전에서는 해결 방법으로 축약 형식을 사용하여 수동으로 계획을 작성하거나 계획을 여러 부분으로 나누세요. CLI Opus 모델의 경우 출력 제한을 초과하지 않도록 계획 세부 정보를 줄이세요.
문제 해결OpenCode를 1.4.0으로 업그레이드한 후 oh-my-opencode가 사라지는 이유는 무엇인가요?
OpenCode를 버전 1.15.10 이상으로 업그레이드하십시오. 이 버전에서 이 버그가 해결되었습니다. 만약 1.4.0을 계속 사용해야 한다면, native skill tool과 관련된 영구적인 수정을 위해 issue #1492를 추적하십시오.
문제 해결왜 skill(name="...")가 OpenCode에서 실패하나요? 'opencode debug skill'에 스킬이 나열되어 있는데도 말이죠.
에이전트의 tool list에 skill function tool이 누락되었습니다. 이를 해결하려면: (1) 플러그인의 skills 디렉토리에서 ~/.config/opencode/skills/superpowers/로 심볼릭 링크를 생성합니다(옵션 A). (2) bootstrap text를 업데이트하여 에이전트가 skill()이 실패할 때 SKILL.md에 대해 glob으로 대체하고 read하도록 지시합니다(옵션 C). 또는 도구가 없는 경우 messages.transform hook을 통해 skill 내용을 주입합니다(옵션 B).
문제 해결Aider에서 구현 계획을 작성하기 전에 아키텍처 가정을 확인하는 방법은 무엇인가요?
브레인스토밍과 스펙 자체 리뷰 후, 간단한 핸드오프 준비 상태 점검을 수행합니다. 범위, 비목표, 산출물, 검증 기대치가 플래너가 작업하기에 충분히 명확한지 확인하세요. 해결되지 않은 질문이 아키텍처, 데이터 흐름, 사용자 대상 동작 또는 테스트를 실질적으로 변경할 수 있다면, 가장 작은 명확화 질문 하나를 하고 스펙을 업데이트한 후 자체 리뷰를 다시 실행하세요. 이렇게 하면 조기 아키텍처 결정이 코드 상세 계획에 숨어들어가는 것을 방지할 수 있습니다.