superpowers-zh
무엇인가
superpowers-zh는 AI 코딩 에이전트에 개발 작업 순서를 규율하는 스킬 묶음이다. 브레인스토밍으로 요구사항을 확정하고, 계획을 세우고, 테스트를 먼저 쓰고, 디버깅하고, 코드 리뷰를 요청하는 흐름을 각 스킬이 담당한다. 구현에 들어가기 전에 형식·데이터 규모·권한 같은 전제를 먼저 질문하도록 강제하는 것이 핵심 규율이다.
어떻게 동작하나
구성은 skills/ 디렉터리의 20개 스킬(각 SKILL.md), SessionStart 훅을 담은 hooks/, CLAUDE.md·GEMINI.md 같은 bootstrap 파일, 4종 plugin manifest로 이루어진다. 훅이 세션 시작 시점에 스킬을 로드해 상황에 맞는 스킬이 자동 발동한다. 예외로 chinese-* 4개는 자동 발동하지 않고 대화에서 /chinese-xxx를 직접 입력해야 로드되며, 업스트림 스킬의 자동 스케줄링을 오염시키지 않도록 참고자료로 분리돼 있다.
무엇과 다른가
프롬프트를 직접 쓰거나 단일 CLAUDE.md에 규칙을 몰아넣는 방식과 달리, 스킬별 파일 분리 + 훅 기반 자동 트리거 + 도구별 설치 경로 자동 감지를 결합한다. 영어 업스트림과의 차이는 번역 14개에 그치지 않는다. 중국어 표현 습관, 국내 Git/CI 생태, 중국 특화 스킬 4개가 더해지고, 업스트림이 제거한 mcp-builder·workflow-runner 2개를 이 포크가 계속 유지한다.
어떻게 쓰나
설치는 프로젝트 루트에서 npx superpowers-zh를 실행하면 되고, 여러 프로젝트에서 공유하려면 npx superpowers-zh --global을 쓴다. Claude Code만 쓴다면 claude plugin marketplace add jnMetaCode/superpowers-zh 후 claude plugin install superpowers-zh@superpowers-zh로 plugin 방식으로 설치해 claude plugin update로 갱신할 수 있다. 프로젝트级 설치는 홈 디렉터리에서 실행하지 않는다.
전제와 한계
26개 도구를 지원하지만 전역 설치가 가능한 것은 Claude Code·Codex CLI·Qoder·Windsurf·Qwen Code 등 일부이고, Cursor·Kiro·Trae·Aider 등은 프로젝트级 또는 앱 내 설정만 지원한다. Gemini CLI·Antigravity는 별도 전역 방식을 따른다. skills 디렉터리만 cp -r로 복사하는 수동 설치는 hooks와 bootstrap이 빠져 스킬이 자동 발동하지 않으므로 npx 설치가 권장된다.