/ ディレクトリ / プレイグラウンド / Waza (技)
● コミュニティ tw93 ⚡ 即起動

Waza (技)

作者 tw93 · tw93/Waza

Claude Codeスキルとしてパッケージ化されたシニアエンジニアの習慣 — 小さなコミット・引き締まったリファクタリング・集中したデバッグ・意図的なレビュー。知っているのに繰り返せるようにしたこと。

Waza(日本語の「技」)は、tw93(eSheep / Pake / Wazaエコシステムのメンテナー)による、キュレートされたエンジニアリング規律スキルセットです。各スキルは特定の習慣をエンコードしています:「小さな原子的コミット」「レッド-グリーン-リファクター」「システマティックなビセクト」「チェックリスト付きコードレビュー」。派手な機能ではありません — シニア開発者の成果物をジュニアと分けるような小さな規律で、自動的に適用されます。

なぜ使うのか

主な機能

ライブデモ

実際の動作

準備完了

インストール

クライアントを選択

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "waza-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/tw93/Waza",
        "~/.claude/skills/waza"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config を開く。保存後、アプリを再起動。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "waza-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/tw93/Waza",
        "~/.claude/skills/waza"
      ],
      "_inferred": true
    }
  }
}

Cursor は Claude Desktop と同じ mcpServers スキーマを使用。プロジェクト設定はグローバルより優先。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "waza-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/tw93/Waza",
        "~/.claude/skills/waza"
      ],
      "_inferred": true
    }
  }
}

Cline サイドバーの MCP Servers アイコンをクリックし、"Edit Configuration" を選択。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "waza-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/tw93/Waza",
        "~/.claude/skills/waza"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop と同じ形式。Windsurf を再起動して反映。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "waza-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/tw93/Waza",
        "~/.claude/skills/waza"
      ]
    }
  ]
}

Continue はマップではなくサーバーオブジェクトの配列を使用。

~/.config/zed/settings.json
{
  "context_servers": {
    "waza-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/tw93/Waza",
          "~/.claude/skills/waza"
        ]
      }
    }
  }
}

context_servers に追加。保存時に Zed がホットリロード。

claude mcp add waza-skill -- git clone https://github.com/tw93/Waza ~/.claude/skills/waza

ワンライナー。claude mcp list で確認、claude mcp remove で削除。

ユースケース

実用的な使い方: Waza (技)

Claudeが1つの巨大なブロブではなく、小さな原子的コミットを書くようにする

👤 ClaudeのPRが600行変更の1コミットになってしまう人 ⏱ ~30 min intermediate

使うタイミング: コミットがレビュー不能でPRレビューが苦痛な場合。

前提条件
  • スキルのインストール — git clone https://github.com/tw93/Waza ~/.claude/skills/waza
フロー
  1. コミットを計画する
    Use waza commit skill. Plan the work as a sequence of atomic commits before writing any code.✓ コピーしました
    → 番号付きコミット計画;それぞれが1行サマリー
  2. 一度に1つ実行する
    Make commit 1. Stop. Show me the diff and message.✓ コピーしました
    → 単一の小さいコミット;メッセージが規約に従っている
  3. 続けるか計画を修正する
    Continue with the next commit, or revise the plan if step 1 changed your understanding.✓ コピーしました
    → 次のコミットまたは修正された計画

結果: 実際にレビューできるPR。

注意点
  • 計画が細かすぎる(些細な変更に10コミット) — スキルのデフォルトはPRあたり3〜7コミットを目標にします;上書きには--target Nを渡してください
組み合わせ: github

価値あるリファクタリングにレッド-グリーン-リファクターを適用する

👤 レガシーコードをリファクタリングする開発者 ⏱ ~90 min intermediate

使うタイミング: リファクタリングしたい;でも何も壊したくない場合。

フロー
  1. テストでカバーする
    Use waza refactor skill on /src/<module>.ts. First step: characterize current behavior with tests.✓ コピーしました
    → 現在の動作のテスト;パス状態
  2. リファクタリングする
    Now refactor incrementally. Tests must stay green at every step.✓ コピーしました
    → リファクタリングコミットのシリーズ、すべてグリーン

結果: 壊れていないという証拠付きのクリーンなコード。

注意点
  • 「現在の動作のテスト」に既存のバグが含まれる — スキルは疑わしいテストにフラグを立てます;それらを別途マークしてリファクタリングしてください

PRに構造化コードレビューを実行する

👤 一貫性を望むレビュアー ⏱ ~30 min beginner

使うタイミング: 自分が書かなかったPRをレビューする — 見落としが出やすい場合。

フロー
  1. 差分を確認する
    Use waza review skill on PR #123. Walk the diff hunk by hunk; check: correctness, naming, error handling, tests, security.✓ コピーしました
    → ハンクごとのノート;問題が表面化
  2. サマリーを書く
    Write the review summary — 3 strengths, 3 concerns, 1 question.✓ コピーしました
    → 投稿スタイルのサマリー

結果: 「LGTM」劇場ではなく、実際に何かを発見するレビュー。

注意点
  • より大きな問題があるのにスタイルにこだわる — 重大度順に並び替えます;その順序を信頼してください
組み合わせ: github

組み合わせ

他のMCPと組み合わせて10倍の力を

waza-skill + github

エンドツーエンドのPRライフサイクルのためにGitHub MCPとペア

Plan, commit, push, open PR, request review — chain waza commit + github.✓ コピーしました
waza-skill + ccpm-skill

CCPMがissueライフサイクルを、WazaがワークツリーのエンジニアリングRのを担当する

/start issue 42, then run waza commit.plan inside the worktree.✓ コピーしました

ツール

このMCPが提供する機能

ツール入力呼び出すタイミングコスト
commit.plan task_description 非自明な作業の開始時 0
refactor.tdd path, target 安全網付きのリファクタリング 0
debug.systematic symptom, context 推測に抵抗するバグ 0
review.checklist pr_url PRをレビューする 0

コストと制限

運用コスト

APIクォータ
N/A
呼び出しあたりのトークン
軽量 — スキルは短いMarkdown
金額
無料
ヒント
習慣は積み重なります — 詰まったときだけでなく、一貫して適用してください

セキュリティ

権限、シークレット、影響範囲

認証情報の保管: なし
データ送信先: ローカル

トラブルシューティング

よくあるエラーと対処法

単一で良いのにスキルがコミットを分割し続ける

変更の最小単位は様々です;キャリブレーションのためにサンプルPRを提供してください

リファクタリングテストのカバレッジが少なすぎる

スキルは触れたモジュールのカバレッジが30%未満のとき警告します — 手動でシードを追加してください

代替案

Waza (技) 他との比較

代替案代わりに使う場面トレードオフ
wshobson/agents習慣スキルではなくロールベースのエージェント(フロントエンド・バックエンド)が欲しい場合形状が異なる;両方良い — 異なる抽象レベル
addyosmani/agent-skills特にweb-perf/a11yの深みが欲しい場合Addyのセットはwebフロントエンド;Wazaは一般的なエンジニアリング

その他

リソース

📖 GitHub の公式 README を読む

🐙 オープンな issue を見る

🔍 400以上のMCPサーバーとSkillsを見る