Superpowers 치트 시트 — 어떤 스킬을 언제 사용할지에 대한 완전 가이드

서론

이 기사는 Superpowers를 이미 설치한 분들을 위한 치트 시트입니다.

"스킬이 많이 있는데, 결국 언제 무엇을 사용해야 하나요?"라는 의문에 답합니다. 자주 발생하는 3가지 작업 시나리오별로 워크플로우(Workflow)를 정리하였으며, 마지막에 모든 스킬의 목록표를 부록으로 게재하였습니다.

워크플로우 1: 새로운 기능을 구현할 때

각 스킬의 역할

| 스킬 |
| 커맨드 |
| 할 일 |
| brainstorming |
| /brainstorming |
| "무엇을 만들 것인가"를 모호한 상태로 구현하지 않기 위한 설계 세션 |
| writing-plans |
| /writing-plans |
| 설계를 단계별 구현 계획으로 구체화 |
| using-git-worktrees |
| /using-git-worktrees |
| 작업 브랜치(Branch)를 main에서 격리 |
| test-driven-development |
| /test-driven-development |
| 테스트를 먼저 작성한 후 구현 |
| verification-before-completion |
| /verification-before-completion |
| "완료했다"라고 말하기 전에 커맨드 출력으로 확인 |
| requesting-code-review |
| /requesting-code-review |
| 머지(Merge) 전 셀프 리뷰 및 리뷰 요청 |
| |
| |
| |

워크플로우 2: 버그를 수정할 때

각 스킬의 역할

| 스킬 |
| 커맨드 |
| 할 일 |
| systematic-debugging |
| /systematic-debugging |
| 짐작으로 고치기 전에 근본 원인을 특정하는 사이클을 강제 |
| test-driven-development |
| /test-driven-development |
| 버그를 재현하는 테스트를 먼저 작성하고, 수정 후 그린(Green) 상태가 되는 것을 확인 |
| verification-before-completion |
| /verification-before-completion |
| "고쳤다"라고 말하기 전에 실제로 커맨드로 확인 |
| |
| |
| |

워크플로우 3: PR을 내고 머지할 때

각 스킬의 역할

| 스킬 |
| 커맨드 |
| 할 일 |
| requesting-code-review |
| /requesting-code-review |
| PR 작성 전 셀프 리뷰 체크리스트를 실행 |
| receiving-code-review |
| /receiving-code-review |
| 리뷰 지적 사항을 맹목적으로 구현하지 않고, 기술적으로 검증한 후 대응 |
| finishing-a-development-branch |
| /finishing-a-development-branch |
| 머지(Merge)・스쿼시(Squash)・삭제 등의 선택지를 정리하여 완료 |
| |
| |
| |

부록: 전체 스킬 목록

| 스킬명 |
| 커맨드 |
| 발동 타이밍 |
| brainstorming |
| /brainstorming |
| 새로운 기능이나 변경 사항을 만들기 전 (필수) |
| writing-plans |
| /writing-plans |
| 스펙(Spec)이 확정되어 구현 계획을 세울 때 |
| using-git-worktrees |
| /using-git-worktrees |
| 구현 시작 전 또는 브랜치(Branch) 격리가 필요할 때 |
| test-driven-development |
| /test-driven-development |
| 구현 코드를 작성하기 전 (필수) |
| executing-plans |
| /executing-plans |
| 다른 세션에서 계획을 실행할 때 |
| subagent-driven-development |
| /subagent-driven-development |
| 독립적인 태스크를 병렬로 실행할 때 |
| dispatching-parallel-agents |
| /dispatching-parallel-agents |
| 2개 이상의 독립적인 태스크가 있을 때 |
| systematic-debugging |
| /systematic-debugging |
| 버그, 테스트 실패, 예기치 않은 동작에 직면했을 때 |
| verification-before-completion |
| /verification-before-completion |
| "완료" 또는 "수정됨"이라고 말하기 전 (필수) |
| requesting-code-review |
| /requesting-code-review |
| 구현 완료 및 머지(Merge) 전의 셀프 리뷰 |
| receiving-code-review |
| /receiving-code-review |
| 리뷰 코멘트를 받았을 때 |
| finishing-a-development-branch |
| /finishing-a-development-branch |
| 구현 완료 및 머지(Merge) 방법을 결정할 때 |
| writing-skills |
| /writing-skills |
| 새로운 스킬을 생성하거나 편집할 때 |
| using-superpowers |
| 자동 (대화 시작 시) |
| 세션 시작 시 자동 적용 |