SkillMap

Oct 16, 2026

用 Waza 装上八个工程习惯 Skill

Waza 把 tw93 的八个工程习惯做成 skill——用 /think 做规划、/hunt 查根因、/check 做审查——每个 skill 都写明产出目标、红线和验证方式。

#tutorial#engineering#best-practices

上来就写代码的 agent，产出的方案没人审过，修的 bug 也只治了表面。Waza——tw93 出品、7k 星的仓库——把八个工程习惯做成 skill，让压力测试、根因排查和自我审查发生在代码前后，而不是从未发生。每个 skill 都写明产出目标、红线和验证方式，然后退后一步，把路径选择交还给模型。

为什么这个 Skill 重要

Waza（技，日语武道术语，指练到成为本能的招式）刻意把 skill 数量做小：八个习惯，每个只做一件事，触发条件清晰。README 写明这些 skill 来自真实项目，经 7 个项目 300 多个会话打磨，每条避坑记录都对应一次真实翻车。仓库把自己定位为轻量路线——点名 Superpowers 和 gstack 「强大但笨重」——并押注模型越强，这种克制越有复利。

八个 skill，摘自 README 自己的表格：

  • /think — 在动手构建任何新东西之前，质疑问题本身，产出一份决策完备的方案。
  • /ui — 产出有辨识度的前端界面，靠截图驱动的审美迭代。
  • /check — 任务完成后、合并或发布前，对照项目约束审查 diff。
  • /hunt — 系统性调试；任何修复落地前先确认根因。
  • /write — 把中英文文案改写得自然，砍掉僵硬的公式化表达。
  • /learn — 面向陌生领域的六阶段研究流程。
  • /read — 把任意 URL 或 PDF 变成简明摘要或干净的 Markdown。
  • /health — 体检你的 agent 配置（Codex、Claude Code、项目指令、验证器输出）。

安装

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

skill 会装进共享目录 ~/.agents/skills。Claude Code 以符号链接方式接入；读取该目录的 Codex、Cursor、Gemini CLI、Copilot、Amp、Kimi Code CLI 等 agent 会把这八个 skill 识别为 /check、/think 等。使用私有 skills 目录的 agent，把它的 id 加在 -a 后面即可。用 npx skills update -g -y 更新，用 npx skills remove tw93/Waza -g 卸载。

README 也提供了宿主插件的安装方式——Claude Code 中 skill 以 /waza:check 命名空间出现：

# Claude Code (update: claude plugin update waza)
/plugin marketplace add tw93/Waza
/plugin install waza@waza

# Codex (update: codex plugin marketplace upgrade waza, then codex plugin add waza@waza)
codex plugin marketplace add tw93/Waza
codex plugin add waza@waza

Claude Desktop 通过 Customize > Skills 上传 waza.zip 发布附件；Pi 用户可以运行 pi install npm:@tw93/waza。

实战：不靠猜测修复一个回归

  1. 描述 bug 并调用调试 skill：
/hunt 用户反馈登录页在 Chrome 125 之后间歇性白屏，控制台有一个 undefined 报错。
先定位根因，确认之前不要改任何代码。
  1. /hunt 驱动系统性调试——复现、收窄、确认根因，然后才允许修复落地。README 给这个 skill 划定的范围是「任何 bug、回归或意外行为」，对「以前明明是好的」的场景格外适用。
  2. 应用修复，再运行 /check 对照项目约束审查 diff。这个 skill 会在运行时读取仓库的公开上下文——README、package manifest、Makefile、CI workflow——从而具备项目感知；私有路径、凭据和 token 一律不碰。
  3. 让 /check 完成你批准的收尾动作：README 列出的按需动作包括发版（release）、发布（publish）、push 和 issue 跟进。

其他工作同样可以串起来：/think 敲定方案，批准后实现，合并前 /check；或者 /read 抓取资料，/learn 归纳，/write 打磨。每个 skill 都停在请求的产出上——只有你明确授权的流程才会连续执行，不会逐步向你要确认。

技巧

  • 可选规则（English coaching、anti-patterns、waza-routing、clarity）与 skill 相互独立——只装 Waza 不会启用它们；需要用安装脚本按条启用。
  • 随仓库附赠一个极简的 Claude Code statusline：上下文窗口、5 小时配额和 7 天配额，按用量着色。
  • Codex 有原生 statusline 项，README 给出了对应的 [tui] 配置块。
  • /hunt 确认根因后把它记录下来——每个 skill 文件夹里的避坑记录都来自真实翻车，你的翻车也可以这样沉淀。

何时不用这个 Skill

八个习惯是刻意设定的上限：领域专用打法（比如科学计算或移动端发布工程）需要各自的 skill；已经标准化到更重框架的团队会觉得 Waza 太薄——这是设计选择，不是缺陷。可选规则会改动 agent 的持久指令，安装前请先通读每条规则文件。

查看 排行榜 了解更多 skill。