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は作者による三部作の一部です：Kaku（コード生成）、Waza（習慣ドリルスキル）、Kami（ドキュメント出荷）。生のコード合成ではなく、ワークフローレイヤーに純粋に焦点を当てています。

対象ユーザー

• Claude、Codex、Cursor、Gemini-CLIなどを既に使用しており、再現可能で規律あるAI支援を求める開発者。
• カスタムプラグインフレームワークを構築せずに、AI強化されたエンジニアリング習慣を標準化したいチーム。
• カスタムルールで拡張可能な、軽量な8つのスキルセットを探しているすべての人。

ライセンス
MIT – 自由に使用、修正、貢献できます。

---

上記のすべての情報は、リポジトリの README から直接引用しています。