スキル一覧

それぞれのエンジニアリング習慣が独立したスキルとして用意されており、各スキルはリファレンスドキュメント、補助スクリプト、実運用で得た回避策を同梱したディレクトリです。Claude Code ではスラッシュコマンドを入力し、Codex ではスキル名を指定して呼び出します。

スキル	トリガーのタイミング	役割
/think	新しいコードを書く前	要件と設計を検証し、そのまま実装可能な意思決定済みの計画を作成
/ui	フロントエンドUI構築時	デフォルトのテンプレートに頼らず明確なデザインの方向性でUIを作り、スクリーンショットを使ったビジュアルの反復にも対応
/check	実装完了後・マージやリリース前	プロジェクト規約に基づいて差分をレビューして結果を検証し、承認されたリリースやメンテナー作業を実行
/hunt	バグやデグレの発生時	修正前に根本原因を特定し、以前は動いていた機能が壊れた場合は特に徹底
/write	文章の執筆や推敲時	中国語・英語の文章を自然にリライトし、機械的なAI感を排除
/learn	未知の分野の調査時	収集・要約・構成・執筆・推敲・レビューの6段階で体系的にリサーチ
/read	WebリンクやPDFの閲覧時	要点を簡潔にまとめるか、引用や保存に適したクリーンなMarkdownを出力
/health	エージェント設定の監査時	Codex、Claude Code、プロジェクト指示、検証出力、AI による保守性をチェックし、トークン消費を抑えた概要から詳細診断へ進む

インストール

Claude Code、Codex、Cursor、その他のエージェント

npx skills add tw93/Waza -a claude-code codex cursor -g -y

スキルは共通の ~/.agents/skills ディレクトリに保存されます。Claude Code はシンボリックリンク経由で連携し、Codex、Cursor、Gemini CLI、Copilot、Amp、Kimi Code CLI など、このディレクトリを読み込む各エージェントで自動的に利用可能になります。専用ディレクトリを持つエージェントは -a の後にID（例：antigravity-cli、qwen-code）を指定してください。更新は npx skills update -g -y で行います。AIエージェントに直接インストールを依頼することも可能です：

https://github.com/tw93/Waza/blob/main/llms.txt を読んで Waza をインストールして

ホストのプラグイン機能を利用する場合（スキル名に名前空間が付きます：/waza:check）：

# Claude Code（更新：claude plugin update waza）
/plugin marketplace add tw93/Waza
/plugin install waza@waza

# Codex（更新：codex plugin marketplace upgrade waza、その後 codex plugin add waza@waza）
codex plugin marketplace add tw93/Waza
codex plugin add waza@waza

Claude Desktop：waza.zip をダウンロードし、Customize > Skills > "+" > Create skill からZIPをアップロードします。更新時はカードの "..." から Replace を選択し、最新のZIPを再度アップロードしてください。

Pi：pi install npm:@tw93/waza、更新は pi update npm:@tw93/waza で行います。

スキルの連携

スキルの組み合わせは自由です。各スキルは要求された成果物を生成すると停止しますが、明確に承認されたワークフローであれば確認を挟まずにスムーズに次のステップへ引き継がれます。

一般的なワークフロー：

• 新機能の開発：/think で設計を固め、承認後に実装し、/check でレビューしてマージ
• 不具合の修正：/hunt で原因を特定し、修正してから /check で変更差分をレビューし、必要に応じてリリース
• 調査と執筆：/read で資料を集め、/learn で体系化し、/write で文章を磨く

要件から振り返りまで、各段階で守るルールは AI コーディングルール にまとめています。

プロジェクトコンテキスト

Waza は汎用的なエンジニアリングの型のみを提供します。/check は実行時に対象リポジトリの公開情報（README、パッケージ定義、Makefile、CI設定）とタスク要件を読み取り、非公開のパスや認証情報、トークンは読みません。レビュー用コンテキストのテンプレートは skills/check/references/project-context.md を参照してください。

追加ツールとルール

curl の URL は最新の GitHub リリースアセットを使います。main の最新スクリプトを使いたい場合は、コマンドの前に WAZA_REF=main を指定してください。

ステータスライン

Claude Code 向けのミニマルなステータスライン：コンテキストウィンドウ、5時間制限、7日間制限の使用率を色分け表示し、プログレスバーや余計なノイズはありません。

(
  set -e
  WAZA_STATUSLINE_SCRIPT="$(mktemp -t waza-statusline.XXXXXX)"
  trap 'rm -f "$WAZA_STATUSLINE_SCRIPT"' EXIT
  curl -fL https://github.com/tw93/Waza/releases/latest/download/setup-statusline.sh -o "$WAZA_STATUSLINE_SCRIPT"
  # 実行前に内容を確認：less "$WAZA_STATUSLINE_SCRIPT"
  bash "$WAZA_STATUSLINE_SCRIPT"
)

Codex は標準でステータスライン表示に対応しています。~/.codex/config.toml に追加してください：

[tui]
status_line = ["model-with-reasoning", "current-dir", "context-used", "five-hour-limit", "weekly-limit"]
status_line_use_colors = true

Codex は残りの枠を、上の Claude Code ステータスラインは使用済みの割合を表示します（上流がまだ five-hour-used / weekly-used を提供していないため）。

オプションルール

オプションルールは、エージェントの永続的な指示にインストールすると、スキルを呼び出していないときにも適用されます。Waza のスキルをインストールするだけでは有効になりません。必要なものをコピーして実行してください（Codex や Antigravity では claude-code を codex または antigravity-cli に置き換えます）：

(
  set -e
  WAZA_RULE_SCRIPT="$(mktemp -t waza-rule.XXXXXX)"
  trap 'rm -f "$WAZA_RULE_SCRIPT"' EXIT
  curl -fL https://github.com/tw93/Waza/releases/latest/download/setup-rule.sh -o "$WAZA_RULE_SCRIPT"
  # 実行前に内容を確認：less "$WAZA_RULE_SCRIPT"

  # 英語コーチング：プロンプトに英語の誤りがあると、末尾に短い 😇 の訂正を追加
  bash "$WAZA_RULE_SCRIPT" english claude-code

  # アンチパターン：スキル横断で常に効くガードレール（読んでから動く、範囲を広げない、頼まれていない要約をしない）
  bash "$WAZA_RULE_SCRIPT" anti-patterns claude-code

  # ルーティングヒント：Claude 以外のホストに、トリガーに合うリクエストでは Waza スキルを優先させる
  bash "$WAZA_RULE_SCRIPT" waza-routing claude-code

  # 明快な日常回答：用語の統一、条件の明示、不確かさの保持
  bash "$WAZA_RULE_SCRIPT" clarity claude-code
)

Clarity は ASD-STE100 のわかりやすい文章の原則を取り入れていますが、制限英語の文法を押し付けたり、あなたの文体を変えたりはしません。更新するにはコマンドを再実行し、新しいセッションを開始してください。Codex は ~/.codex/AGENTS.md にマーク付きブロックを追加し、Claude Code と Antigravity はルールファイルをインストールします。ほかのツールでは、ルールを各ツールの永続的なカスタム指示にコピーしてください。

開発の背景

Waza（技、わざ）は武道の用語で、本能になるまで繰り返し練習した技を指します。優れたエンジニアはコードを書くだけではありません。要件を突き詰めて検証し、根本原因までデバッグし、自分の差分をレビューし、一次情報を読みます。AI はこれらすべてをこなせますが、構造がなければ出力は汎用的で不正確なものに流れていきます。Waza の各スキルは、目指す成果、越えてはいけない一線、結果の検証方法だけを示し、進め方はモデルに任せます。モデルが賢くなるほど、この抑制が効いてきます。

Superpowers や gstack のようなツールは強力ですが重く、スキルも設定も多すぎます。Waza は小さく保ち、本当に大事な習慣に絞った 8 つのスキルだけを置いています。どれも役割は一つで、呼び出すタイミングもはっきりしています。7 つのプロジェクトと 300 以上のセッションで磨いてきたもので、どの回避策も実際の失敗に由来します。/health スキルはこの記事で紹介した Claude Code の 6 層フレームワークから生まれました。

Kaku（書く）がコードを書き、Waza（技）が習慣を鍛え、Kami（紙）がドキュメントを仕上げる、という三部作です。家族にたとえると、Kaku は父、Waza は姉、Kami は妹です。

アンインストール

npx skills remove tw93/Waza -g
rm -f ~/.claude/statusline.sh
rm -f ~/.claude/rules/english.md
rm -f ~/.claude/rules/anti-patterns.md
rm -f ~/.claude/rules/waza-routing.md
rm -f ~/.claude/rules/clarity.md

ステータスラインを導入していた場合は、~/.claude/settings.json から statusLine エントリも削除してください。Claude Desktop では Customize > Skills から Waza を削除してください。Codex にルールをインストールした場合は、~/.codex/AGENTS.md から Waza のマーク付きブロックを削除してください。Antigravity では ~/.gemini/antigravity-cli/rules/ から該当するルールファイルを削除してください。ほかのツールにコピーしたルールは、各ツールのカスタム指示から削除してください。ルールを削除したら新しいセッションを開始してください。

サポート

• 私が作った有料の Mac クリーナー Mole for Mac を使っていただくのが、いちばん直接的な支援になります
• Waza が役に立った場合は、Star を付けたり、共有したり、SCOPE.md を読んだうえで Issue や PR を送ったりしていただけるとうれしいです
• 飼い猫の「湯円（TangYuan）」と「コーラ（Coke）」に おやつ 🥩 をご馳走することもできます

スポンサー一覧 🐱

ライセンス

MIT License. Please feel free to use and contribute to the development.