コードを書いていると、気づいたら「なんとなく動くコード」になっていた。設計を深く考える前に実装を始め、バグが出たら再起動で済ませ、仕上げは勢いで押し切る。AIを使っても、この傾向はむしろ強くなりがちです。
Waza は、Claude Code(AIエージェント)に追加できるオープンソースのスキル集です。GitHubスターは5,600超。8つのスキルを通じて、優れたエンジニアが当たり前にやっている「構造化された動き方」をClaudeに実行させます。
詳細な使い方や全スキルの一覧は、Waza(技)スキルガイドを確認してください。
Wazaとは
Waza(技) は日本語の武道用語で、繰り返し練習して自然に身につく技術を意味します。
Claude Codeは高い能力を持ちますが、構造なしに使うと出力の質にばらつきが出ます。Wazaは「コードを書く前に設計を検証する」「マージ前に差分を体系的に見る」「バグの根本原因が確定するまで直さない」といった習慣をスキルとして定義し、Claudeに一貫して実行させます。
制作者は tw93/Waza(PakeやMiaoYanなどのツールも作っている人)です。

特に使えるスキル
1. /think — コードを書く前に設計を検証する
コードを一行も書かずに、まず構造を整えます。問題を問い直し、2〜3案を比較検討してから実装に入るため、「とりあえず作ってみる」サイクルを防ぎます。
承認が出るまで実装フェーズには進みません。タスクの深度をLightweight / Standard / Deepに分類し、依存関係・テストカバレッジ・リスクを確認してから承認を求めます。TBD・TODOは承認プランに含められないルールになっています。
/think
新機能追加やアーキテクチャを決める前に使うのが基本の使い方です。
2. /check — マージ前の自動レビュー
実装後、マージ・リリースの直前に使います。差分を読んで問題を見つけ、安全な修正は自動適用、判断が必要なものはまとめて確認を求めます。
修正は4種類に分類されます。
| 分類 | 内容 |
|---|---|
safe_auto | 即時自動修正(タイポ・import漏れ) |
gated_auto | まとめて確認(nullチェック追加など) |
manual | 人間が判断(アーキテクチャ変更) |
advisory | 情報として記録 |
差分が500行超・認証や課金・データ変更を含む場合は「敵対的レビュー」モードが発動します。
/check
3. /hunt — 体系的なバグ追跡
バグや予期しない動作が起きたときに使います。根本原因が確定するまで修正は適用しません。「とりあえず直す」「再起動したら直った」は禁止です。
バグを確実に再現できる最小ケースを作り、原因候補を証拠で絞り込み、「これが原因である」と言える証拠を示してからFIXを適用します。修正前に失敗する回帰テストも自動で追加します。
/hunt
4. /learn + /write — 調査記事を書く
複数の情報源を収集して構造化ドキュメントを作り(/learn)、自然な文体に整える(/write)という2ステップで使います。
/write は日本語・中国語・英語に対応しています。テキストの言語を自動判定して、それぞれのルールセットを読み込みます。
日本語の場合、「〜することができます」「いかがでしたか?」「本記事では〜について解説します」といったAI定番フレーズを除去し、見出し過多・箇条書き過多の構造問題も指摘します。familyai.jp向け(温かみのある個人ブログ)と仕事向け(課題解決型ビジネス記事)の2モードがあり、曖昧な場合は確認を求めます。
/read # ソース収集
/learn # 合成・構成
/write # 文章磨き(日本語・中国語・英語対応)
スキルの連携
スキルは手動でつないで使います(自動連鎖しません)。
新機能を作る
/think で設計を検証 → 承認後に実装を指示 → /check でレビュー → マージ
バグ修正
/hunt で根本原因を特定 → コード修正 → /check でレビュー → リリース
技術記事を書く
/read でソース収集 → /learn で構成 → /write で文体を整える
追加機能
Statusline:コンテキストウィンドウ・クォータ残量をターミナルに表示します。
curl -sL https://github.com/tw93/Waza/releases/latest/download/setup-statusline.sh | bash
Anti-Patterns:常時ガードレール(読まずに実行しない・パスを捏造しない)を適用します。
curl -sL https://github.com/tw93/Waza/releases/latest/download/setup-rule.sh | bash -s -- anti-patterns claude-code
インストール
Claude Codeで次のコマンドを実行します。
npx skills add tw93/Waza -a claude-code -g -y
8つのスキルがすべてインストールされます。プラグイン経由でインストールする場合は次のコマンドを使います。
/plugin marketplace add tw93/Waza
/plugin install waza@waza
まとめ

| 場面 | スキル |
|---|---|
| まず作ってみようを防ぎたい | /think |
| とりあえず動くを防ぎたい | /check |
| なんか直ったを防ぎたい | /hunt |
| 知らない技術を体系的に調べたい | /learn |
| 日本語・中国語・英語の文体をAI臭なく整えたい | /write |
| Claude Codeの設定を見直したい | /health |
「AIを使えば速く作れる」から「AIと一緒に正しく作れる」へ。それがWazaの目指すところです。設計に迷ったら /think、実装後の見直しなら /check。コマンドを打つだけで、Claudeの動き方が少し変わります。