tw93/Waza

Waza – AI 기반 엔지니어링 습관 스킬

소개
Waza는 Claude Code, Codex, Cursor, Gemini-CLI, Copilot 등 LLM 기반 코딩 어시스턴트에 설치할 수 있는 작은 스킬 모음입니다. 각 스킬은 구체적인 엔지니어링 습관(계획, UI 디자인, 디버깅, 코드 리뷰, 리서치, 요약, 글쓰기, 상태 점검)을 코드화하며, /think 또는 /check와 같은 슬래시 명령어로 호출할 수 있습니다. 스킬이 실행되면 구조화된 출력을 생성하고, 제어권을 사용자나 체인의 다음 스킬로 반환합니다.

중요성
LLM 에이전트는 코드 생성에는 뛰어나지만, 규율 있는 워크플로우가 없으면 노이즈가 많고 일반적인 결과를 생성하는 경향이 있습니다. Waza는 프로세스 계층을 제공합니다. 명확한 트리거, 잘 정의된 결과물, 그리고 모델이 궤도를 벗어나지 않도록 하는 가드레일입니다. 익숙한 엔지니어링 습관을 재사용 가능하고 모델에 구애받지 않는 플러그인으로 전환함으로써, Waza는 Claude, Codex 또는 기타 LLM 기반 IDE를 사용하든 동일한 규율 있는 워크플로우를 얻을 수 있게 합니다.

주요 기능

스킬	사용 시기	기능
/think	새 기능 시작 전	문제를 제기하고, 설계를 압박 테스트하며, 완전한 구현 계획을 반환합니다.
/ui	프론트엔드 구축 시	UI 목업을 생성하고 스크린샷을 반복하여 구체적인 시각적 방향을 제시합니다.
/check	변경 후, 병합 전	프로젝트 제약 조건에 따라 diff를 검토하고, 결과를 확인하며, 릴리스를 트리거할 수 있습니다.
/hunt	버그 발생 시	수정 사항을 적용하기 전에 근본 원인을 확인하는 체계적인 디버깅 워크플로우.
/write	글쓰기 (중/영)	자연스러운 문장이 되도록 글을 다시 쓰고, 딱딱한 표현을 제거합니다.
/learn	낯선 도메인 탐색	6단계 리서치 파이프라인: 수집 → 소화 → 개요 → 작성 → 정제 → 자체 검토.
/read	URL 또는 PDF	인용이나 참조를 위한 간결한 요약이나 깔끔한 Markdown을 반환합니다.
/health	에이전트 자체 감사	LLM 환경의 상태, 예산 사용량 및 유지 관리 가능성을 점검합니다.

설치 및 사용법

• 단일 npx 명령어로 설치합니다. 스킬은 ~/.agents/skills에 배치되어 호환되는 모든 에이전트에서 사용할 수 있게 됩니다.
• GUI 기반 도구(Claude Desktop, Codex 플러그인 마켓플레이스 등)의 경우 ZIP 릴리스를 업로드할 수 있습니다.
• 스킬은 수동으로 체인화(/think → /check)하거나, 지속적인 지침 가드(예: 영어 오류 수정, 안티 패턴 체크, 라우팅 힌트)를 추가하는 선택적 규칙과 결합할 수 있습니다.

상태 표시줄 및 예산 인식
Waza는 Claude Code용 작은 상태 표시줄 스크립트를 제공하여 모델의 컨텍스트 창 사용량과 5시간/7일 할당량을 표시하여 제한 내에서 작업할 수 있도록 돕습니다. Codex는 유사한 지표에 대한 기본 지원을 제공합니다.

범위 및 제한
이 스킬들은 범용적이며 프로젝트별 코드를 포함하지 않습니다. 런타임에 /check는 대상 저장소의 공개 부분(README, package.json, Makefile, CI 설정)을 읽어 프로젝트를 인식하지만, 개인 자격 증명에는 절대 접근하지 않습니다.

다른 프로젝트와의 관계
Waza는 저자의 3부작 중 일부입니다: Kaku(코드 생성), Waza(습관 훈련 스킬), Kami(문서 배포). 원시 코드 합성이 아닌 워크플로우 계층에만 순수하게 집중합니다.

대상 사용자

• 이미 Claude, Codex, Cursor, Gemini-CLI 등을 사용 중이며 재현 가능하고 규율 있는 AI 지원을 원하는 개발자.
• 사용자 지정 플러그인 프레임워크를 구축하지 않고도 AI 강화 엔지니어링 습관을 표준화하려는 팀.
• 사용자 지정 규칙으로 확장 가능한 경량 8가지 스킬 세트를 찾는 모든 사람.

라이선스
MIT – 자유롭게 사용, 수정 및 기여 가능.

---

위의 모든 정보는 저장소의 README에서 직접 가져왔습니다.