superpowers

KO | EN

gitlite — search

#javascript #python #ai #rust #macos #nodejs #windows #awesome #cli #awesome-list #mcp #ios #openai #open-source

(★ 272,754)

실제로 작동하는 에이전틱 스킬 프레임워크 & 소프트웨어 개발 방법론.

superpowers 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Superpowers

Superpowers는 코딩 에이전트를 위한 완벽한 소프트웨어 개발 방법론으로, 조합 가능한 일련의 스킬들과 에이전트가 이를 활용하도록 보장하는 초기 지침들을 기반으로 구축되었습니다.

## Quickstart

에이전트에 Superpowers를 부여하세요: [Claude Code](#claude-code), [Antigravity](#antigravity), [Codex App](#codex-app), [Codex CLI](#codex-cli), [Cursor](#cursor), [Factory Droid](#factory-droid), [Gemini CLI](#gemini-cli), [GitHub Copilot CLI](#github-copilot-cli), [Kimi Code](#kimi-code), [OpenCode](#opencode), [Pi](#pi).

## How it works

코딩 에이전트를 실행하는 순간부터 시작됩니다. 에이전트는 무언가를 구축하고 있다는 것을 감지하자마자 무작정 코드를 작성하기 시작하지 *않습니다*. 대신 한 걸음 물러서서 사용자가 실제로 무엇을 하려는지 질문합니다.

대화를 통해 사양(spec)을 이끌어내면, 실제로 읽고 소화할 수 있을 만큼 충분히 짧은 단위로 쪼개어 사용자에게 보여줍니다.

설계가 승인되면, 에이전트는 취향이 나쁘고, 판단력이 없고, 프로젝트 맥락이 없으며, 테스트를 꺼리는 열정적인 주니어 엔지니어라도 따를 수 있을 만큼 명확한 구현 계획을 세웁니다. 진정한 레드/그린 TDD, YAGNI(You Aren't Gonna Need It), DRY를 강조합니다.

그 다음, 사용자가 "시작"이라고 말하면 *서브에이전트 주도 개발(subagent-driven-development)* 프로세스를 실행합니다. 에이전트들이 각 엔지니어링 작업을 수행하고, 작업을 검사 및 검토하며 앞으로 나아갑니다. 에이전트가 사용자가 세운 계획에서 벗어나지 않고 한 번에 몇 시간 동안 자율적으로 작업하는 것도 드문 일이 아닙니다.

그 외에도 많은 기능이 있지만, 이것이 시스템의 핵심입니다. 그리고 스킬이 자동으로 트리거되기 때문에 특별한 작업을 할 필요가 없습니다. 코딩 에이전트는 자연스럽게 Superpowers를 갖추게 됩니다.

## Commercial Services

기업 환경에서 Superpowers를 사용하고 계시며 상용 지원, 추가 툴링 또는 관리형 지출(managed spending)의 혜택을 받을 수 있는 경우, sales@primeradiant.com으로 주저하지 말고 연락해 주세요.

## Installation

설치 방법은 하네스(harness)에 따라 다릅니다. 둘 이상을 사용하는 경우, 각각에 대해 Superpowers를 별도로 설치하세요.

### Claude Code

Superpowers는 [공식 Claude 플러그인 마켓플레이스](https://claude.com/plugins/superpowers)를 통해 이용할 수 있습니다.

#### Official Marketplace

- Anthropic의 공식 마켓플레이스에서 플러그인을 설치합니다:

```bash
  /plugin install superpowers@claude-plugins-official
  ```

#### Superpowers Marketplace

Superpowers 마켓플레이스는 Claude Code용 Superpowers 및 기타 관련 플러그인을 제공합니다.

- 마켓플레이스를 등록합니다:

```bash
  /plugin marketplace add obra/superpowers-marketplace
  ```

- 이 마켓플레이스에서 플러그인을 설치합니다:

```bash
  /plugin install superpowers@superpowers-marketplace
  ```

### Antigravity

이 저장소에서 Superpowers를 플러그인으로 설치합니다:

```bash
agy plugin install https://github.com/obra/superpowers
```

Antigravity는 플러그인의 세션 시작 훅을 실행하므로, 첫 번째 메시지부터 Superpowers가 활성화됩니다. 업데이트하려면 동일한 명령어로 재설치하세요.

### Codex App

Superpowers는 [공식 Codex 플러그인 마켓플레이스](https://github.com/openai/plugins)를 통해 이용할 수 있습니다.

- Codex 앱의 사이드바에서 Plugins를 클릭합니다.
- Coding 섹션에서 `Superpowers`를 볼 수 있습니다.
- Superpowers 옆의 `+`를 클릭하고 안내를 따릅니다.

### Codex CLI

Superpowers는 [공식 Codex 플러그인 마켓플레이스](https://github.com/openai/plugins)를 통해 이용할 수 있습니다.

- 플러그인 검색 인터페이스를 엽니다:

```bash
  /plugins
  ```

- Superpowers를 검색합니다:

```bash
  superpowers
  ```

- `Install Plugin`을 선택합니다.

### Cursor

- Cursor 에이전트 채팅에서 마켓플레이스를 통해 설치합니다:

```text
  /add-plugin superpowers
  ```

- 또는 플러그인 마켓플레이스에서 "superpowers"를 검색합니다.

### Factory Droid

- 마켓플레이스를 등록합니다:

```bash
  droid plugin marketplace add https://github.com/obra/superpowers
  ```

- 플러그인을 설치합니다:

```bash
  droid plugin install superpowers@superpowers
  ```

### Gemini CLI

- 확장 프로그램을 설치합니다:

```bash
  gemini extensions install https://github.com/obra/superpowers
  ```

- 나중에 업데이트합니다:

```bash
  gemini extensions update superpowers
  ```

### GitHub Copilot CLI

- 마켓플레이스를 등록합니다:

```bash
  copilot plugin marketplace add obra/superpowers-marketplace
  ```

- 플러그인을 설치합니다:

```bash
  copilot plugin install superpowers@superpowers-marketplace
  ```

### Kimi Code

Superpowers는 Kimi Code의 플러그인 마켓플레이스에서 이용할 수 있습니다.

- Kimi Code의 플러그인 매니저를 엽니다:

```text
  /plugins
  ```

- `Marketplace` > `Superpowers`로 이동하여 설치합니다.

- 또는 이 저장소에서 직접 설치합니다:

```text
  /plugins install https://github.com/obra/superpowers
  ```

- 상세 문서: [docs/README.kimi.md](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](docs/README.opencode.md)

### Pi

이 저장소에서 Superpowers를 Pi 패키지로 설치합니다:

```bash
pi install git:github.com/obra/superpowers
```

로컬 개발을 위해, 이 체크아웃을 임시 패키지로 로드하여 Pi를 실행합니다:

```bash
pi -e /path/to/superpowers
```

Pi 패키지는 Superpowers 스킬과, 세션 시작 시 그리고 컴팩션 후에 `using-superpowers` 부트스트랩을 주입하는 작은 확장 프로그램을 로드합니다. Pi는 네이티브 스킬을 지원하므로 호환성을 위한 `Skill` 도구가 필요하지 않습니다. 서브에이전트 및 작업 목록(task-list) 도구는 선택적인 Pi 컴패니언 패키지로 유지됩니다.

## The Basic Workflow

1. **brainstorming** - 코드 작성 전에 활성화됩니다. 질문을 통해 대략적인 아이디어를 구체화하고, 대안을 탐색하며, 검증을 위해 설계를 섹션별로 제시합니다. 설계 문서를 저장합니다.

2. **using-git-worktrees** - 설계 승인 후 활성화됩니다. 새 브랜치에 격리된 작업 공간을 만들고, 프로젝트 설정을 실행하며, 깨끗한 테스트 베이스라인을 확인합니다.

3. **writing-plans** - 승인된 설계와 함께 활성화됩니다. 작업을 한입 크기(각 2~5분 분량)의 작업으로 나눕니다. 모든 작업에는 정확한 파일 경로, 완전한 코드, 검증 단계가 포함됩니다.

4. **subagent-driven-development** 또는 **executing-plans** - 계획과 함께 활성화됩니다. 2단계 검토(사양 준수, 그 다음 코드 품질)를 거쳐 작업별로 신선한 서브에이전트를 파견하거나, 사람의 체크포인트와 함께 일괄 실행합니다.

5. **test-driven-development** - 구현 중에 활성화됩니다. RED-GREEN-REFACTOR를 적용합니다: 실패하는 테스트 작성, 실패 확인, 최소한의 코드 작성, 성공 확인, 커밋. 테스트 전에 작성된 코드는 삭제합니다.

6. **requesting-code-review** - 작업 사이에 활성화됩니다. 계획에 따라 검토하고 심각도에 따라 문제를 보고합니다. 치명적인 문제는 진행을 차단합니다.

7. **finishing-a-development-branch** - 작업이 완료되면 활성화됩니다. 테스트를 검증하고, 옵션(병합/PR/유지/폐기)을 제시하며, 워크트리를 정리합니다.

**에이전트는 모든 작업 전에 관련 스킬을 확인합니다.** 제안이 아닌 필수 워크플로입니다.

## What's Inside

### Skills Library

**Testing**
- **test-driven-development** - RED-GREEN-REFACTOR 사이클 (테스트 안티패턴 참고 자료 포함)

**Debugging**
- **systematic-debugging** - 4단계 근본 원인 분석 프로세스 (근본 원인 추적, 심층 방어, 조건 기반 대기 기법 포함)
- **verification-before-completion** - 실제로 수정되었는지 확인

**Collaboration** 
- **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단계 검토(사양 준수, 그 다음 코드 품질)를 통한 빠른 반복

**Meta**
- **writing-skills** - 모범 사례를 따르는 새 스킬 생성 (테스트 방법론 포함)
- **using-superpowers** - 스킬 시스템 소개

## Philosophy

- **Test-Driven Development** - 항상 테스트를 먼저 작성
- **Systematic over ad-hoc** - 짐작보다 프로세스 중시
- **Complexity reduction** - 단순성을 최우선 목표로 설정
- **Evidence over claims** - 성공을 선언하기 전에 검증

[오리지널 릴리스 공지](https://blog.fsck.com/2025/10/09/superpowers/)를 읽어보세요.

## Contributing

Superpowers의 일반적인 기여 프로세스는 아래와 같습니다. 새로운 스킬 기여는 일반적으로 수용되지 않으며, 스킬에 대한 모든 업데이트는 당사가 지원하는 모든 코딩 에이전트에서 작동해야 한다는 점을 유념해 주세요.

1. 저장소 포크하기
2. 'dev' 브랜치로 전환하기
3. 작업할 브랜치 생성하기
4. 신규 및 수정된 스킬 생성/테스트를 위해 `writing-skills` 스킬 따르기
5. PR 제출하기 (풀 리퀘스트 템플릿을 반드시 작성할 것)

스킬 동작 테스트는 `evals/`에 복제된 [superpowers-evals](https://github.com/prime-radiant-inc/superpowers-evals/)의 드릴 평가 하네스를 사용합니다. 설정은 `evals/README.md`를 참고하세요. 플러그인 인프라 테스트는 `tests/`에 위치하며 관련 `run-*.sh` 또는 `npm test`를 통해 실행됩니다.

전체 가이드는 `skills/writing-skills/SKILL.md`를 참조하세요.

## Updating

Superpowers 업데이트는 코딩 에이전트에 따라 다소 차이가 있지만, 대개 자동으로 이루어집니다.

## License

MIT License - 자세한 내용은 LICENSE 파일 참조

## Visual companion telemetry

스킬과 플러그인은 크리에이터에게 피드백을 제공하지 않기 때문에, 얼마나 많은 분이 Superpowers를 사용하고 계신지 파악할 수 없습니다. 기본적으로 brainstorming의 선택적 시각적 컴패니언 기능에 있는 Prime Radiant 로고는 당사 웹사이트에서 로드됩니다. 여기에는 사용 중인 Superpowers의 버전이 포함됩니다. 프로젝트, 프롬프트 또는 코딩 에이전트에 대한 어떠한 세부 정보도 포함되지 않습니다. 당사는 사용자의 클릭이나 구축 중인 내용에 대해 볼 수 없습니다. 이는 대략 몇 분이 어떤 버전의 Superpowers를 사용하고 계신지 파악하는 데 도움을 줍니다. 이는 100% 선택 사항입니다. 이를 비활성화하려면 환경 변수 `SUPERPOWERS_DISABLE_TELEMETRY`를 참(true) 값으로 설정하세요. 또한 Superpowers는 Claude Code의 `DISABLE_TELEMETRY` 및 `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` 옵트아웃 설정을 존중합니다.

## Community

Superpowers는 [Jesse Vincent](https://blog.fsck.com)와 [Prime Radiant](https://primeradiant.com)의 팀원들이 함께 만들었습니다.

- **Discord**: 커뮤니티 지원, 질문, 그리고 Superpowers로 구축 중인 내용을 공유하기 위해 [참여하세요](https://discord.gg/35wsABTejz)
- **Issues**: https://github.com/obra/superpowers/issues
- **Release announcements**: 새 버전 소식을 받아보려면 [가입하세요](https://primeradiant.com/superpowers/)

superpowers

superpowers 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

superpowers

superpowers 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README