/ 目錄 / 演練場 / Waza (技)
● 社群 tw93 ⚡ 即開即用

Waza (技)

作者 tw93 · tw93/Waza

將資深工程師的習慣封裝成 Claude Code skill——小型提交、精準重構、專注除錯、謹慎審查。你已知道的事,讓它變得可重複。

Waza(日語「技」——技術)是由 tw43 精心策管的工程紀律 skill 集,他是 eSheep / Pake / Waza 生態系的維護者。每個 skill 都編碼了一個特定習慣:「小型原子提交」、「紅綠重構」、「系統性 bisect」、「帶核查清單的程式碼審查」。這些不是花哨的功能——它們是將資深開發者的產出與初級開發者區分開來的小紀律,自動化地執行。

為什麼要用

核心特性

即時演示

實際使用效果

就緒

安裝

選擇你的客戶端

~/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 撰寫小型原子提交,而非一個巨大的 blob

👤 Claude PR 最終變成「1 個提交改了 600 行」的任何人 ⏱ ~30 min intermediate

何時使用: PR 審查是噩夢,因為提交根本無法審查。

前置條件
  • 已安裝 Skill — 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.✓ 已複製
    → 編號的提交計畫;每條都是一行摘要
  2. 逐一執行
    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 個提交) — Skill 預設目標為每個 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.✓ 已複製
    → 一系列重構提交,全部保持綠燈

結果: 更乾淨的程式碼,並有證明它沒有破壞任何東西。

注意事項
  • 「涵蓋當前行為的測試」包含了現有的 bug — Skill 標記看起來可疑的測試;將這些另外標記並分開重構

對 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」式的形式審查。

注意事項
  • 存在更大問題時,Skill 卻在挑剔風格 — 依嚴重性重新排序;信任順序
搭配使用: github

組合

與其他 MCP 搭配,撬動十倍槓桿

waza-skill + github

與 GitHub MCP 搭配實現端對端 PR 生命週期

Plan, commit, push, open PR, request review — chain waza commit + github.✓ 已複製
waza-skill + ccpm-skill

CCPM 負責 Issue 生命週期,Waza 負責其中的工程紀律

/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 靠猜測解決不了的 bug 0
review.checklist pr_url 審查 PR 0

成本與限制

運行它的成本

API 配額
不適用
每次呼叫 Token 數
輕量——skill 是短 Markdown
費用
免費
提示
習慣是複利的——持續運用,而非只在卡住時才用

安全

權限、密鑰、影響範圍

憑證儲存:
資料出站: 本地

故障排查

常見錯誤與修復

單一提交就足夠時,Skill 仍持續拆分

最小變更單元因人而異;傳入一個範例 PR 進行校準

重構測試覆蓋太少

Skill 在觸及模組的覆蓋率低於 30% 時發出警告——手動補充種子測試

替代方案

Waza (技) 對比其他方案

替代方案何時用它替代權衡
wshobson/agents你想要基於角色的 Agent(前端、後端)而非習慣 skill形狀不同;兩者都好——不同的抽象層次
addyosmani/agent-skills你特別想要 Web 效能/無障礙性的深度Addy 的集合針對 Web 前端;Waza 是通用工程

更多

資源

📖 閱讀 GitHub 上的官方 README

🐙 查看未解決的 issue

🔍 瀏覽全部 400+ MCP 伺服器和 Skills