Waza 工程习惯AI技能集合

由 tw93 打造的技能集合，把工程师熟知的工程开发习惯转化为 AI 代理可执行的技能，适配 Claude Code、Codex、Cursor 等主流 AI 开发工具。共 8 个技能：/think、/ui、/check、/hunt、/write、/learn、/read、/health，每个技能只有一个职责和清晰触发条件，并附状态栏与可选规则。构建自真实项目，经 7 个项目 300+ 会话打磨，MIT 许可。

技能介绍

Waza 是由 tw93 打造的技能集合，把工程师已经熟悉的工程习惯变成 AI 代理可以执行的技能。Waza（技，わざ）是日本武术术语，指练到成为本能的一招。

作者的判断是：好工程师不只是写代码，还会压测需求、把 bug 调试到根因、审查自己的 diff、阅读一手资料。AI 有完成这一切的原始能力，但缺少结构时，产出就会漂移成泛泛而谈、不精确的工作。每个 Waza 技能都会写清结果、红线以及结果如何被验证，然后退后一步让模型自己选择路径；随着模型变强，这种克制会带来复利。

相比 Superpowers、gstack 等强大但沉重的工具（技能太多、配置太多），Waza 保持小：8 个技能，只做真正重要的习惯，每个技能只干一件事、有清晰的触发条件。它构建自真实项目，经 7 个项目 300+ 会话打磨，每个坑都来自真实失败；/health 技能源自作者文章中提出的六层 Claude Code 框架。Waza 是三部曲的一部分：Kaku（書く）写代码、Waza（技）练习惯、Kami（紙）发文档。本组合包含 9 个可安装子 Skill。

适用场景

在动手做新东西之前，需要先挑战问题、压测设计，产出一份决策完整的计划
构建前端界面，需要产出有辨识度的 UI 而不是通用默认样式
任务完成之后、合并或发布之前，需要审查 diff
遇到任何 bug、回归或非预期行为（尤其是"以前能用"的东西）
撰写或编辑文案，希望中英文读起来自然、去掉生硬套话
进入不熟悉的领域做研究，或需要读取 URL 与 PDF

核心能力

↔ 左右滑动查看完整表格

技能	何时使用	做什么
/think	在构建任何新东西之前	挑战问题、压测设计，产出一份决策完整、另一个 agent 可以直接实施的计划。
/ui	构建前端界面时	产出有辨识度的 UI，包括截图驱动的美学迭代，给出明确方向而非通用默认值。
/check	任务之后、合并或发布之前	审查 diff，提取项目特有约束，处理已批准的发布/上传/推送/反馈跟进，并用证据验证。
/hunt	任何 bug、回归或非预期行为	系统化调试。先确认根因再动手修复，尤其是"以前能用"的情况。
/write	撰写或编辑散文	重写文案，让中文和英文读起来自然，砍掉生硬、公式化的措辞。
/learn	进入不熟悉的领域	六阶段研究工作流：收集、消化、列纲、填充、精炼，然后自审并发布。
/read	任何 URL 或 PDF	按平台特定路由读取 URL 和 PDF。普通读取返回简洁摘要；当被要求转换、引用、标注、保存或喂给下游工作时输出 Markdown。
/health	审计 Agent 健康度	检查 Codex、Claude Code、项目指令、验证器输出与 AI 可维护性，先做预算感知的摘要遍历再深入检查。

每个技能是一个文件夹，包含参考文档、辅助脚本以及来自真实失败的踩坑记录。

工作方式

技能之间可以串联，但每一次衔接都是你手动触发的步骤。每个技能完成自己的任务后就停下，等你决定下一步。

常见工作流：

规划一个功能：/think → 批准 → 说"implement X" → /check → 合并
交付一个修复：/hunt → 修复 → /check → 发布/上传/推送/issue 跟进
研究与写作：/read（抓取来源）→ /learn（综合）→ /write（润色）
调试与验证：/hunt（找根因）→ 修复 → /check（审查改动）

在 Claude Code 中输入斜杠命令即可；在 Codex 中按名称调用已安装的技能，遵循同一套演练脚本。

项目上下文：Waza 只提供通用的工程习惯。/check 在运行时读取目标仓库的公开上下文（README、包清单、Makefile、CI 工作流）与你的任务约束，从而变得"懂项目"，绝不读取私有路径、凭据或 token。

安装后，一份规范副本落在共享的 ~/.agents/skills 存储（agents.md 标准目录），并把 Claude Code 软链进去，因此 Codex、Cursor、Kimi Code CLI、Amp、Cline、Antigravity CLI 以及任何读取该目录的 agent 都会自动获得 Waza。经由这些宿主路由的模型（Claude Code 兼容端点背后的 GLM 或 Kimi K2）无需额外操作；使用私有技能目录的工具需要追加自己的 agent id（例如 -a qwen-code iflow-cli antigravity-cli）。

你需要提供

一个支持 skills 的 AI 开发环境（Claude Code、Codex、Cursor、Antigravity CLI 等）
要处理的项目（Waza 提供通用习惯，项目上下文由 /check 在运行时读取）
可选：如果想让状态栏与规则生效，需要能写入 ~/.claude/、~/.codex/ 等配置目录

你会获得

8 个已安装的技能（每个技能是一个含参考文档、辅助脚本与踩坑记录的文件夹）
可选的状态栏：上下文窗口、5 小时配额、7 天配额，按用量着色，无进度条、无噪音
三个独立可选规则开关（英文纠错、反模式护栏、路由提示）

使用示例

一条命令安装全部八个技能，无提示、无报错：

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

之后用下面的命令更新：

npx skills update -g -y

原生插件方式（用于宿主原生的更新命令）：

# Claude Code: install, then `claude plugin update waza`
/plugin marketplace add tw93/Waza
/plugin install waza@waza

# Codex: install, then `codex plugin marketplace upgrade waza`
codex plugin marketplace add tw93/Waza
codex plugin add waza@waza

Claude Desktop：下载 waza.zip，然后在 Customize > Skills > "+" > Create skill 上传该 ZIP。更新时重新上传最新 ZIP。

Pi：pi install npm:@tw93/waza（更新用 pi update npm:@tw93/waza）。/health 会把 Pi 设置与 Claude Code、Codex 一起审计。

状态栏安装：

(
  set -e
  WAZA_STATUSLINE_SCRIPT="$(mktemp -t waza-statusline.XXXXXX)"
  trap 'rm -f "$WAZA_STATUSLINE_SCRIPT"' EXIT
  curl -fL https://github.com/tw93/Waza/releases/latest/download/setup-statusline.sh -o "$WAZA_STATUSLINE_SCRIPT"
  # review it first: less "$WAZA_STATUSLINE_SCRIPT"
  bash "$WAZA_STATUSLINE_SCRIPT"
)

Codex 有原生状态栏条目，加到 ~/.codex/config.toml：

[tui]
status_line = ["model-with-reasoning", "current-dir", "context-used", "five-hour-limit", "weekly-limit"]
status_line_use_colors = true

Codex 显示剩余配额；上面的 Claude Code 状态栏显示已用百分比（上游尚未暴露 five-hour-used / weekly-used）。

三个独立可选规则开关（在其他 agent 上把 claude-code 换成 codex 或 antigravity-cli）：

(
  set -e
  WAZA_RULE_SCRIPT="$(mktemp -t waza-rule.XXXXXX)"
  trap 'rm -f "$WAZA_RULE_SCRIPT"' EXIT
  curl -fL https://github.com/tw93/Waza/releases/latest/download/setup-rule.sh -o "$WAZA_RULE_SCRIPT"
  # review it first: less "$WAZA_RULE_SCRIPT"

  # English coaching: appends a short 😇 correction when your prompt has an English mistake
  bash "$WAZA_RULE_SCRIPT" english claude-code

  # Anti-patterns: always-on cross-skill guardrails (read before acting, no scope creep, no unsolicited summaries)
  bash "$WAZA_RULE_SCRIPT" anti-patterns claude-code

  # Routing hint: tells non-Claude hosts to prefer Waza skills when a request matches their triggers
  bash "$WAZA_RULE_SCRIPT" waza-routing claude-code
)

Curl 地址使用最新 GitHub release 资产；如果想要最前沿的脚本，可在命令前设置 WAZA_REF=main。

页面给出的典型提问示例：

使用Waza的/think技能帮我梳理新功能的开发需求，输出完整可执行的开发计划

调用Waza的/hunt技能帮我定位项目中现有bug的根本原因

使用Waza的/check技能帮我审查本次代码修改是否符合项目规范

其他说明

卸载：

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.md

Claude Desktop 在 Customize > Skills 中删除 Waza；Codex 的规则安装需要从 ~/.codex/AGENTS.md 中移除标记过的 Waza 区块。

许可：MIT License，可自由使用 Waza 并参与贡献。