/ 目录 / 演练场 / Waza (技)
● 社区 tw93 ⚡ 即开即用

Waza (技)

作者 tw93 · tw93/Waza

将高级工程师习惯封装为 Claude Code skill——小提交、紧凑重构、专注调试、认真审查。你懂得这些道理,现在让它们可重复执行。

Waza(日文「技」——「技艺」)是 tw93 策划的一套工程纪律 skill,tw83 是 eSheep / Pake / Waza 生态的维护者。每个 skill 封装一个具体的习惯:「小而原子的提交」、「红-绿-重构」、「系统化二分查找」、「带检查清单的代码审查」。这些不是华丽的新功能——而是那些将高级工程师的输出与初级工程师区分开的小纪律,自动化执行。

为什么要用

核心特性

实时演示

实际使用效果

就绪

安装

选择你的客户端

~/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 review 很痛苦,因为那个提交根本没法审。

前置条件
  • 已安装 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. 逐 hunk 走查
    Use waza review skill on PR #123. Walk the diff hunk by hunk; check: correctness, naming, error handling, tests, security.✓ 已复制
    → 逐 hunk 备注;发现的任何问题浮出
  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 的 skill 集专注于 Web 前端;Waza 面向通用工程

更多

资源

📖 阅读 GitHub 上的官方 README

🐙 查看未解决的 issue

🔍 浏览全部 400+ MCP 服务器和 Skills