Waza（技, わざ）是日本武术里的“技”：反复练习，直到动作变成本能。
好的工程师不只是写代码。他们会想清需求，审查自己的工作，系统性调试，设计有明确意图的界面，并阅读一手资料。他们写得清楚，也通过产出而不是消费内容来学习新领域。
AI 在原始产出能力上已经强过大多数工程师。但没有结构时，这种能力很容易滑向泛泛而谈和不精确的工作。Waza 把它收束到精确的工程习惯里：八个 skills 先设清目标和约束，再让模型做它最擅长的事。
三部曲的一部分：Kaku（書く）写代码，Waza（技）训练习惯，Kami（紙）交付文档。可以把它们想成一家人：Kaku 是爸爸，Waza 是姐姐，Kami 是妹妹。
每个工程习惯都对应一个安装好的 skill。在 Claude Code 里输入 slash command。在 Codex 里按名称调用已安装的 skill，并沿用同一套 playbook。
| Skill | 何时使用 | 作用 |
|---|---|---|
/think |
构建任何新东西之前 | 挑战问题、压力测试设计，并产出另一个 agent 可以直接执行的决策完备计划。 |
/design |
构建前端界面 | 产出有辨识度的 UI，包括基于截图的审美迭代，方向明确，而不是套用泛化默认值。 |
/check |
任务完成后、合并或发布前 | 审查 diff，提炼项目特定约束，处理已批准的 release/publish/push/reaction 收尾，并用证据验证。 |
/hunt |
任何 bug、回归或异常行为 | 系统性调试。先确认 root cause，再应用任何 fix，尤其适用于以前能工作的东西。 |
/write |
写作或编辑 prose | 重写中文和英文 prose，使其自然，删掉僵硬、模板化的表达。 |
/learn |
深入陌生领域 | 六阶段研究 workflow：收集、消化、拟提纲、填充、精修，然后自审并准备发布。 |
/read |
任何 URL 或 PDF | 按平台特性路由读取 URL 和 PDF。普通读取返回简洁总结；当用户要求转换、引用、保存或供下游工作使用时输出 Markdown。 |
/health |
审计 Agent Health | 检查 Codex、Claude Code、项目指令、verifier 输出和 AI maintainability，在深度检查前做预算感知的摘要扫描。 |
每个 skill 都是一个文件夹，里面有 reference docs、helper scripts，以及来自真实失败的 gotchas。
大多数用户应该全局安装 Waza，这样每个项目都能使用同一组 skills。
Claude Code
npx skills add tw93/Waza -a claude-code -g -y这会安装 /think、/design、/check、/hunt、/write、/learn、/read 和 /health。只安装单个 skill 可使用 npx skills add tw93/Waza --skill think -a claude-code -g -y。
Codex
npx skills add tw93/Waza -a codex -g -y只安装单个 skill 可使用 npx skills add tw93/Waza --skill think -a codex -g -y。Codex sessions 可以按名称调用已安装的 skills，也可以链接到 npx skills path tw93/Waza 显示的已安装 SKILL.md 路径。
Antigravity
npx skills add tw93/Waza -a antigravity -g -y
npx skills add tw93/Waza -a antigravity-cli -g -y桌面应用使用 antigravity，终端 agent 使用 antigravity-cli。两者都会通过 skills installer 使用 Waza 标准的 skills/<name>/SKILL.md 布局。
OpenCode
npx skills add tw93/Waza -a opencode -g -y安装后，OpenCode 会通过原生 skill tool 加载 Waza。当任务匹配 think、design、check、hunt、write、learn、read 或 health 时，按名称调用对应 skill。
Claude Code plugin marketplace（单 skill 条目需要 Claude Code v2.1.143+）
/plugin marketplace add tw93/Waza
/plugin install waza@waza这会安装全部八个 skills。在 Claude Code v2.1.143 或更新版本里，可用 /plugin install waza-<name>@waza 只安装单个 skill，例如 waza-think@waza。
Claude Desktop
下载 waza.zip，打开 Customize > Skills > "+" > Create skill，然后上传 ZIP。
Pi coding agent
pi install npm:@tw93/wazaPi 可以从仓库或已发布的 @tw93/waza npm package 加载 Waza 标准的 skills/<name>/SKILL.md 布局；该 package 暴露了指向 ./skills 的 pi.skills metadata。/health 会把 Pi settings、configured packages 和 local skill roots 与 Claude Code、Codex 一起审计。
更新
npx skills update -g -yMarketplace 安装使用 claude plugin update <skill>。Claude Desktop 用户可以用最新的 waza.zip 替换旧 skill。
Pi 用户可以运行 pi update npm:@tw93/waza，或用 pi update --extensions 更新全部已安装的 Pi packages。
如果想收到新版本通知，watch Waza 的 GitHub Releases。
Waza 把通用程序员习惯保留在公开 skill 内。/check 通过读取目标仓库的公开上下文和用户任务约束，变得 project-aware。
- Project commands 来自 README、package manifests、Makefiles、CI workflows 和用户明确指令。
- Project hard stops 包括 generated artifacts、protected files、version synchronization、release assets 和领域特定 safety risks。
- Public docs 和示例不得包含 credentials、certificate paths、private key filenames、tokens 或个人机器细节。
review context template 见 skills/check/references/project-context.md。
Skills 被设计成可以串联，但切换是手动的。每个 skill 完成自己的任务后都会停下，等待你决定下一步。
常见 workflows：
- 设计一个功能：
/think→ approve → 说 "implement X" →/check→ merge - 交付一个 fix：
/hunt→ fix →/check→ release/publish/push/issue follow-through - 研究并写作：
/read（fetch sources）→/learn（synthesize）→/write（polish） - 调试并验证：
/hunt（find root cause）→ fix →/check（review changes）
每个箭头都代表一次手动用户动作。Skills 不会自动互相触发。
Claude Code 的极简 statusline：context window、5-hour quota 和 7-day quota。按使用量着色，没有进度条，没有噪音。
curl -sL https://github.com/tw93/Waza/releases/latest/download/setup-statusline.sh | bashCodex 有原生 statusline items。添加到 ~/.codex/config.toml：
[tui]
status_line = ["model-with-reasoning", "current-dir", "context-used", "five-hour-limit", "weekly-limit"]
status_line_use_colors = trueCodex 显示剩余额度；上面的 Claude Code statusline 显示已用百分比（upstream 还没有暴露 five-hour-used / weekly-used）。
用于英语练习的可选 rule。当你的 prompt 包含英文错误时，agent 会追加一条简短的 😇 correction；纯中文 prompts 不会被改动。
# Claude Code
curl -sL https://github.com/tw93/Waza/releases/latest/download/setup-rule.sh | bash -s -- english claude-code
# Codex
curl -sL https://github.com/tw93/Waza/releases/latest/download/setup-rule.sh | bash -s -- english codex可选的 always-on guardrails，用于跨 skill 行为：读完再行动，不幻觉路径，不 scope creep，不主动追加总结。它不绑定具体 skill，适用于每个 session。
curl -sL https://github.com/tw93/Waza/releases/latest/download/setup-rule.sh | bash -s -- anti-patterns claude-codeCodex 用户把 claude-code 换成 codex。Curl URLs 使用最新 GitHub release asset；如果想使用 bleeding-edge scripts，先设置 WAZA_REF=main 再运行命令。
可选 pointer，用来告诉 host：当请求匹配触发条件时优先使用 Waza skills。它对 Codex、Pi 和其他不会根据 skill description 自动路由的 agents 很有用。Claude Code 已经会通过 descriptions 路由，所以这里同样是 opt-in。
curl -sL https://github.com/tw93/Waza/releases/latest/download/setup-rule.sh | bash -s -- waza-routing claude-codeCodex 用户把 claude-code 换成 codex。
npx skills remove tw93/Waza -g
rm -f ~/.claude/statusline.sh
rm -f ~/.claude/rules/english.md
rm -f ~/.claude/rules/anti-patterns.md
rm -f ~/.claude/rules/waza-routing.mdClaude Desktop 用户从 Customize > Skills 删除 Waza。Codex rule installs 则从 ~/.codex/AGENTS.md 中删除带标记的 Waza blocks。
Superpowers 和 gstack 这样的工具很厉害，但也很重：skills 太多、配置太多、学习曲线太陡。
作者写下的每条 rule 也是一个上限。模型只能做指令允许它做的事。Waza 反过来：每个 skill 只设清目标和真正重要的约束，然后退后一步。随着模型变强，这种克制会产生复利。
八个 skills，对应真正重要的习惯。每个只做一件事，有清晰 trigger，并且不挡路。它们来自真实项目，在 7 个项目的 300+ sessions 中打磨。每个 gotcha 都能追溯到一次真实失败。
/health skill 源自 这篇文章 描述的六层 Claude Code framework，现在覆盖 Codex、Claude Code、Pi、verifier surfaces 和 AI maintainability。
- 如果 Waza 帮到了你，可以分享给朋友，或给它一个 star。
- 有想法或 bug？欢迎开 issue 或 PR，也欢迎贡献你最喜欢的 AI model。
- 我有两只猫，TangYuan 和 Coke。如果你觉得 Waza 让生活更开心，可以给它们投喂罐头 🥩。
MIT License。欢迎使用 Waza，也欢迎贡献。