waza

Waza는 AI 코딩 에이전트를 위한 여덟 가지 엔지니어링 습관 스킬 모음입니다. 전제는 훌륭한 엔지니어가 코드를 작성하는 것 이상을 한다는 것입니다. 요구사항을 압박 테스트하고, 근본 원인까지 디버깅하고, 자신의 diff를 리뷰하고, 1차 자료를 읽습니다. Waza는 이런 습관을 에이전트가 실행할 수 있는 스킬로 패키징하며, 각 스킬은 하나의 역할과 명확한 트리거를 가집니다. ## 여덟 가지 스킬 - /think — 새로운 것을 만들기 전에 사용합니다. 문제에 도전하고, 설계를 압박 테스트하며, 다른 에이전트가 구현할 수 있는 결정 완결형 계획을 만듭니다. - /ui — 프론트엔드 인터페이스를 만들 때 사용합니다. 확고한 방향성을 가진 독특한 UI를 목표로 하며, 스크린샷 기반 미적 반복 작업을 포함합니다. - /check — 작업 후 그리고 병합이나 릴리스 전에 사용합니다. 프로젝트 제약에 비추어 diff를 리뷰하고, 결과를 검증하며, 승인된 릴리스 및 메인테이너 작업을 처리합니다. - /hunt — 모든 버그, 회귀 또는 예상치 못한 동작에 사용합니다. 수정을 적용하기 전에 근본 원인을 확인하는 체계적 디버깅입니다. - /write — 산문을 쓰거나 편집할 때 사용합니다. 중국어와 영어에서 자연스럽게 들리도록 산문을 다시 쓰고, 딱딱하고 상투적인 표현을 잘라냅니다. - /learn — 익숙하지 않은 영역을 파고들 때 사용합니다. 6단계 리서치 워크플로: 수집, 소화, 개요 작성, 채우기, 다듬기, 그다음 자기 리뷰 및 발행입니다. - /read — 모든 URL 또는 PDF에 사용합니다. 변환, 인용, 출처 표시, 저장 또는 추가 리서치를 위해 간결한 요약이나 깔끔한 Markdown을 반환합니다. - /health — 에이전트 상태를 감사합니다: Codex, Claude Code, 프로젝트 지침, 검증기 출력, AI 유지보수성이며, 심층 점검 전에 예산을 고려한 요약 패스를 수행합니다. 각 스킬은 참조 문서, 헬퍼 스크립트, 실제 실패에서 얻은 함정 관련 노트를 담은 폴더입니다. ## 설치 Claude Code, Codex, Cursor 및 기타 에이전트의 경우, 단일 npx 명령이 공유 `~/.agents/skills` 디렉터리에 스킬을 설치하며, Claude Code는 심볼릭 링크로 연결됩니다. 해당 디렉터리를 읽는 에이전트는 스킬을 슬래시 명령으로 인식합니다. 비공개 스킬 디렉터리를 사용하는 에이전트는 `-a` 플래그 뒤에 지정합니다. 업데이트는 `npx skills update -g -y`를 사용합니다. Claude Code와 Codex용 호스트 플러그인도 지원되며, 여기서 스킬은 네임스페이스가 붙습니다(예: `/waza:check`). Claude Desktop 사용자는 릴리스에서 ZIP을 다운로드하여 Customize > Skills 아래에 업로드할 수 있습니다. Pi 패키지도 제공됩니다. ## 체이닝과 컨텍스트 스킬을 어떻게 체이닝할지는 사용자가 결정합니다. 문서화된 워크플로에는 기능 계획(/think 후 /check), 수정 배포(/hunt, 수정, /check), 리서치와 작성(/read, /learn, /write), 디버그 및 검증(/hunt 후 /check)이 포함됩니다. Waza는 일반적인 습관만 제공합니다. /check 스킬은 런타임에 대상 저장소의 공개 컨텍스트(예: README, 패키지 매니페스트, Makefile, CI 워크플로)와 작업 제약을 읽어 프로젝트를 인식하게 됩니다. 비공개 경로, 자격 증명 또는 토큰은 읽지 않습니다. ## 추가 기능 Claude Code용 최소 상태 표시줄은 컨텍스트 창, 5시간 할당량, 7일 할당량을 표시하며, 진행 막대 없이 사용량에 따라 색상으로 구분됩니다. Codex에는 `~/.codex/config.toml`에서 구성하는 네이티브 상태 표시줄 항목이 있습니다. 세 가지 선택적 규칙 토글을 설치할 수 있습니다: 프롬프트에 영어 실수가 있을 때 짧은 교정을 덧붙이는 영어 코칭, 항상 켜져 있는 안티 패턴 가드레일, 요청이 트리거와 일치할 때 비 Claude 호스트에게 Waza 스킬을 우선 사용하라고 알려 주는 라우팅 힌트입니다. ## 배경 Waza(技)는 일본 무술에서 기술을 뜻하는 용어입니다. 이 프로젝트는 더 무거운 스킬 모음과 비교해 의도적으로 작은 규모를 지향하며, 스킬은 실제 프로젝트에서 만들어져 7개 프로젝트의 300개 이상 세션에서 다듬어졌다고 밝힙니다. Kaku(코드) 및 Kami(문서)와 함께 3부작의 일부로 설명됩니다. MIT 라이선스입니다.