Waza (技) (Claude Skill) — 사용 사례, 설치 & 라이브 데모

왜 쓰나요

핵심 기능

10개 이상의 습관형 스킬 (커밋, 리팩토링, 디버그, 리뷰)
각 스킬은 1페이지 마크다운 — 프레임워크 난잡함 없음
구성 가능 — 단일 Claude 세션에서 스킬 체인 가능
이중 언어 EN/중문 지침
MIT, 텔레메트리 없음

라이브 데모

실제 사용 모습

준비됨

설치

클라이언트 선택

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "waza-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/tw93/Waza",
        "~/.claude/skills/waza"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config 열기. 저장 후 앱 재시작.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "waza-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/tw93/Waza",
        "~/.claude/skills/waza"
      ],
      "_inferred": true
    }
  }
}

Cursor는 Claude Desktop과 동일한 mcpServers 스키마 사용. 프로젝트 설정이 전역보다 우선.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "waza-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/tw93/Waza",
        "~/.claude/skills/waza"
      ],
      "_inferred": true
    }
  }
}

Cline 사이드바의 MCP Servers 아이콘 클릭 후 "Edit Configuration" 선택.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "waza-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/tw93/Waza",
        "~/.claude/skills/waza"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop과 같은 형식. Windsurf 재시작 후 적용.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "waza-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/tw93/Waza",
        "~/.claude/skills/waza"
      ]
    }
  ]
}

Continue는 맵이 아닌 서버 오브젝트 배열 사용.

~/.config/zed/settings.json

{
  "context_servers": {
    "waza-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/tw93/Waza",
          "~/.claude/skills/waza"
        ]
      }
    }
  }
}

context_servers에 추가. 저장 시 Zed가 핫 리로드.

claude mcp add waza-skill -- git clone https://github.com/tw93/Waza ~/.claude/skills/waza

한 줄 명령. claude mcp list로 확인, claude mcp remove로 제거.

사용 사례

실전 활용법: Waza (技)

Claude가 하나의 거대한 덩어리 대신 작고 원자적인 커밋을 작성하게 만들기

👤 Claude PR이 600줄이 변경된 커밋 1개로 끝나는 모든 사람 ⏱ ~30 min intermediate

언제 쓸까: 커밋이 리뷰할 수 없어서 PR 리뷰가 힘들 때.

사전 조건

스킬 설치 — git clone https://github.com/tw93/Waza ~/.claude/skills/waza

흐름

커밋 계획

Use waza commit skill. Plan the work as a sequence of atomic commits before writing any code.✓ 복사됨

→ 번호가 매긴 커밋 계획; 각각이 한 줄 요약
하나씩 실행

Make commit 1. Stop. Show me the diff and message.✓ 복사됨

→ 단일 소형 커밋; 메시지가 규약을 따름
계속 또는 수정

Continue with the next commit, or revise the plan if step 1 changed your understanding.✓ 복사됨

→ 다음 커밋 또는 수정된 계획

결과: 실제로 리뷰할 수 있는 PR.

함정

계획이 너무 세분화됨 (사소한 변경에 10개 커밋) — 스킬 기본값은 PR당 3~7개 커밋을 목표로 합니다; 재정의하려면 --target N을 전달하세요

함께 쓰기: github

할 가치 있는 리팩토링에 red-green-refactor 적용

👤 레거시 코드를 리팩토링하는 개발자 ⏱ ~90 min intermediate

언제 쓸까: 리팩토링하고 싶지만 무언가를 깨트리고 싶지 않을 때.

흐름

테스트로 커버

Use waza refactor skill on /src/<module>.ts. First step: characterize current behavior with tests.✓ 복사됨

→ 현재 동작에 대한 테스트; 통과
리팩토링

Now refactor incrementally. Tests must stay green at every step.✓ 복사됨

→ 리팩토링 커밋 시리즈, 모두 통과

결과: 깨지지 않았다는 증거와 함께 더 깔끔한 코드.

함정

'현재 동작에 대한 테스트'에 기존 버그 포함 — 스킬이 의심스러운 테스트를 표시합니다; 표시하고 별도로 리팩토링하세요

PR에 대해 구조화된 코드 리뷰 실행

👤 일관성을 원하는 리뷰어 ⏱ ~30 min beginner

언제 쓸까: 본인이 작성하지 않은 PR을 리뷰할 때 — 놓치기 쉽습니다.

흐름

diff 검토

Use waza review skill on PR #123. Walk the diff hunk by hunk; check: correctness, naming, error handling, tests, security.✓ 복사됨

→ 헝크별 노트; 이슈 표면화됨
요약

Write the review summary — 3 strengths, 3 concerns, 1 question.✓ 복사됨

→ 게시 스타일 요약

결과: 무언가를 찾는 리뷰, '보기 좋아요' 연극이 아님.

함정

더 큰 이슈가 있을 때 스킬이 스타일을 사소하게 지적 — 심각도별로 재정렬됩니다; 순서를 신뢰하세요

함께 쓰기: github

조합

다른 MCP와 조합해 10배 효율

waza-skill + github

종단 간 PR 라이프사이클을 위해 GitHub MCP와 페어링

waza-skill + ccpm-skill

CCPM이 이슈 라이프사이클을 소유하고 Waza가 그 안에서 엔지니어링 규율을 소유

도구

이 MCP가 노출하는 것

도구	입력	언제 호출
commit.plan	task_description	사소하지 않은 모든 작업 시작
refactor.tdd	path, target	안전망이 있는 리팩토링
debug.systematic	symptom, context	추측에 저항하는 버그
review.checklist	pr_url	PR 리뷰

비용 및 제한

운영 비용

API 쿼터: 해당 없음
호출당 토큰: 가벼움 — 스킬은 짧은 마크다운
금액: 무료
팁: 습관은 복리로 쌓입니다 — 막혔을 때만이 아니라 일관되게 적용하세요

보안

권한, 시크릿, 파급범위

자격 증명 저장: 없음

데이터 외부 송신: 로컬

문제 해결

자주 발생하는 오류와 해결

단일이 괜찮을 때 스킬이 계속 커밋을 분리

최소 변경 단위가 다를 수 있습니다; 보정을 위해 예시 PR을 전달하세요

리팩토링 테스트가 너무 적은 커버리지

스킬이 건드린 모듈에서 커버리지 <30%이면 경고합니다 — 수동으로 시드를 추가하세요

대안

Waza (技) 다른 것과 비교

대안	언제 쓰나	단점/장점
wshobson/agents	습관 스킬이 아닌 역할 기반 에이전트(프론트엔드, 백엔드)를 원할 때	다른 형태이지만 둘 다 괜찮습니다 — 다른 추상화 수준
addyosmani/agent-skills	웹 성능/접근성 깊이가 특별히 필요할 때	Addy의 세트는 웹 프론트엔드이고 Waza는 일반 엔지니어링

Waza (技)