AI Skills - Waza:是什么

2026-05-06

关于环境:Waza 最初是为 Claude Code 设计的技能包,本系列的演示环境是 OpenCode(开源的 AI 编程终端)。Waza 的技能在两个工具中都能正常工作,差异主要体现在配置文件路径和部分插件机制上,文中会标注两者的区别。

技(わざ)的含义

Waza 这个项目名来自日本武道术语"技"(わざ):一个动作反复练习直到成为本能,不再需要思考就能自然施展。在 AI 编程的语境下,这个比喻是直接的——好的工程师不需要 AI 教他怎么写代码,他们需要的是把已经内化的习惯(先想再写、审查后再发、找到根因再修)变成 AI 也能遵循的流程。

这个项目的全称是 tw93/Waza,MIT 协议开源,目前在 GitHub 上有 4.5k stars。作者 tw93 是一位资深工程师,同时也是 PakeMole 等知名开源项目的作者。

Waza 的 README 里有一句话概括了它的全部立场:

AI is more capable than most engineers at raw output. But without structure, that capability drifts into generic, imprecise work.

AI 在原始输出能力上超过大多数工程师。但如果没有结构,这种能力就会漂移到泛泛而谈、不够精确的工作上。Waza 要做的,就是给 AI 加上这层结构。

三部曲家族

Waza 不是孤立的项目。作者把它设计成三件套的一部分:

  • Kaku(書く)— 写代码。一个基于 WezTerm 深度定制的终端,专为 AI 编程场景优化,macOS 独占,4.9k stars。
  • Waza(技)— 练习惯。就是你现在在读的这个项目。8 个技能覆盖工程习惯的方方面面。
  • Kami(紙)— 出文档。一个文档设计系统,暖 parchment 底色、墨水蓝强调、衬线字体,8 种文档模板,4.6k stars。

作者给它们的拟人关系是:Kaku 是爸爸,Waza 是姐姐,Kami 是妹妹。对应的工作流是:在 Kaku 终端里写代码,用 Waza 技能规范流程,最后用 Kami 产出漂亮的文档。

三个项目的设计理念一脉相承:克制、单一职责、让 AI 发挥长处而不是替它做所有决定。

八个技能一览

Waza 包含 8 个技能,每个对应一个工程习惯。在支持技能系统的 AI 编程工具(Claude Code、OpenCode、Codex 等)里通过命令触发:

技能命令核心职责
Think/think建新功能前想清楚方案,压力测试设计
Design/design做前端 UI,出有观点的界面
Check/check合并前审查 diff,跑验证
Hunt/hunt系统化调试,先找根因再修
Write/write改稿润色,去掉 AI 腔
Learn/learn深入一个陌生领域,出可发布文章
Read/read抓取 URL 或 PDF 为干净 Markdown
Health/health审计 AI 编程工具的六层配置

每个技能都遵循相同的设计模式:一个 SKILL.md 定义语义和边界,references/ 目录放按需加载的参考材料,scripts/ 目录放确定性脚本。技能之间不互相依赖,不连锁自动触发,完成后就停下来等你决定下一步。

额外能力

除了 8 个核心技能,Waza 还附带三个可选的外围工具:

状态栏 — 在终端底部显示上下文窗口使用率、5 小时配额和 7 天配额,用颜色编码(绿 <70%、黄 70–85%、红 >85%)。一行命令安装,不占 context。

英语纠错 — 一个可选的 rules/english.md,当你的 prompt 里有英语错误时,AI 会在回复末尾附加一句轻量的 😇 修正提示。纯中文 prompt 不受影响。

反模式护栏 — 一个可选的 rules/anti-patterns.md,覆盖所有技能的通用行为规则:不读代码就行动、幻觉路径、scope creep、未经请求的摘要。不针对某个技能,跨 session 全局生效。

安装方式

Waza 支持四种安装途径,覆盖不同的使用场景:

npx skills(通用方式,推荐)

npx skills add tw93/Waza -g -y

全局安装后,在 Claude Code、OpenCode、Codex 等工具里都可以直接使用。如果只想装某个技能(比如只要 /think):

npx skills add tw93/Waza --skill think -g -y

Claude Code 插件市场(仅 Claude Code)

/plugin marketplace add tw93/Waza
/plugin install waza@waza

Claude Desktop(仅 Claude Code)

releases 页面 下载 waza.zip,打开 Customize > Skills > "+" > Create skill,上传 ZIP。

更新

npx skills update -g -y

Claude Code 插件市场安装的用 claude plugin update <skill>。本系列使用的 OpenCode 直接用 npx skills update 更新即可。


这是系列第一篇。下一篇讲为什么需要 Waza:AI 编程中的结构缺失问题、克制原则的设计哲学、以及它和其他技能包(Superpowers、gstack)的区别。

https://blog.logfun.xyz/blog/feed.xml