技能

每个工程习惯对应一个独立技能，技能目录里内置参考文档、辅助脚本以及真实踩坑沉淀的避坑指南，Claude Code 输入斜杠命令即可触发，Codex 则直接按技能名调用。

技能	触发时机	它做什么
/think	动手写新代码前	深入推敲方案并压测设计，产出决策完备且能直接落地的执行计划
/ui	构建前端界面	产出有明确设计方向的界面，不套默认模板，也能拿截图反复迭代视觉
/check	任务完成后，合并或发布前	结合项目规范审查改动、验证结果，并在你授权后处理发布和维护动作
/hunt	遇到 Bug 或异常行为	动手修之前先查清根本原因，尤其是面对以前正常运行的功能
/write	撰写或修改文案	把中英文改得自然顺口，去掉生硬的套话和机器味
/learn	探索完全陌生的领域	按收集、消化、列提纲、补全、打磨、自审发布六个阶段调研，把陌生领域整理成文
/read	阅读网页链接或 PDF	提取精炼摘要，或转成方便引用归档的干净 Markdown
/health	审计 Agent 配置	检查 Codex、Claude Code、项目指令、校验输出和 AI 可维护性，先轻量概览再深入诊断

安装

Claude Code、Codex、Cursor 与其他 Agent

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

技能统一存放在 ~/.agents/skills 共享目录，Claude Code 通过软链接接入，Codex、Cursor、Gemini CLI、Copilot、Amp、Kimi Code CLI 以及其他能读这个目录的 Agent 都会自动加载这 8 个技能。有自己技能目录的 Agent 在 -a 后面写上它的 ID，比如 antigravity-cli 或 qwen-code，后续通过 npx skills update -g -y 保持更新。也可以直接告诉你的 Agent 帮你安装：

阅读 https://github.com/tw93/Waza/blob/main/llms.txt 帮我安装 Waza

宿主插件方式，如果你更习惯使用宿主自有的更新命令（技能带有命名空间前缀，如 /waza:check）：

# Claude Code（更新命令：claude plugin update waza）
/plugin marketplace add tw93/Waza
/plugin install waza@waza

# Codex（更新命令：codex plugin marketplace upgrade waza，然后 codex plugin add waza@waza）
codex plugin marketplace add tw93/Waza
codex plugin add waza@waza

Claude Desktop：下载 waza.zip，打开 Customize > Skills > "+" > Create skill 并上传压缩包，更新时点击卡片上的 "..." 选择 Replace 再上传最新的 ZIP 即可

Pi：pi install npm:@tw93/waza，通过 pi update npm:@tw93/waza 更新

技能串联

技能串联由你做主，每个技能跑完既定目标就停下，拿到明确授权后会自动接力完成整套流程，不需要在每个环节反复确认。

常见工作流：

• 做新功能：/think 想透方案，确认后动手实现，再用 /check 把关合并
• 排查修复：/hunt 查清根因，动手修复，再用 /check 审查改动，需要时一并发布
• 调研成文：/read 读取素材，/learn 消化梳理，/write 润色文字

一件事从需求到复盘的每个阶段该守什么规则，见 AI Coding 军规。

项目上下文

Waza 只沉淀通用的工程习惯，/check 运行时从目标仓库公开的 README、包清单、Makefile、CI 配置和你的任务要求里提炼约束，绝不读取私有路径、凭证或 Token，具体上下文模板可参考 skills/check/references/project-context.md。

附加工具与规则

下载脚本默认使用最新的 GitHub Release 资源，想用 main 上最新的脚本，可以在命令前加 WAZA_REF=main。

状态栏

Claude Code 极简状态栏：显示上下文窗口、5 小时配额与 7 天配额，按用量着色，没有进度条，没有视觉噪音。

(
  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"
  # 可以先检查脚本内容：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 的持久化指令后生效，只安装技能默认不会开启，按需复制执行即可（在对应 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"
  # 可以先检查脚本内容：less "$WAZA_RULE_SCRIPT"

  # 英文写作教练：Prompt 中有英文表达错误时，在结尾追加一条简短的 😇 纠错建议
  bash "$WAZA_RULE_SCRIPT" english claude-code

  # 行为防错守则：全局常驻约束（先看再改、不随意扩大范围、不主动输出冗余总结）
  bash "$WAZA_RULE_SCRIPT" anti-patterns claude-code

  # 技能路由提示：提示非 Claude 宿主在命中对应场景时优先调用 Waza 技能
  bash "$WAZA_RULE_SCRIPT" waza-routing claude-code

  # 日常清晰表达：术语统一、条件明确、保留不确定性
  bash "$WAZA_RULE_SCRIPT" clarity claude-code
)

Clarity 借鉴了 ASD-STE100 的清晰写作原则，不会强加受控英文语法，也不会改变你的个人表达风格，重新运行命令即可更新，开一个新会话后生效。Codex 会在 ~/.codex/AGENTS.md 写入标记块，Claude Code 与 Antigravity 则安装为规则文件，其他工具把规则复制进各自的自定义指令即可

为什么做 Waza

Waza（技，わざ）在日本武术里指招式，是一个动作反复练到变成本能的那种功夫。好工程师不只是写代码，动手前会反复推敲需求，排查时会追到根因，提交前会自己过一遍 diff，查资料也会回到一手来源。这些事 AI 都能做，但没有结构约束，输出就会滑向泛泛而谈、不够精确。每个 Waza 技能只写清要什么结果、哪些红线不能碰、结果怎么验证，具体路径交给模型自己选，模型越强，这份克制就越值钱。

Superpowers、gstack 这类工具很强，但也很重，技能太多，配置也太多。Waza 只留 8 个技能，每个只管一件事、触发条件清楚，都是在 7 个项目、300 多次真实会话里磨出来的，每条避坑指南都对应一次真实翻车。/health 技能就是从这篇文章里讲的 Claude Code 六层框架长出来的。

Waza 和另外两款工具组成三部曲，Kaku（書く）负责写代码，Waza（技）负责磨习惯，Kami（紙）负责出文档，可以把它们看成一家人，Kaku 是爸爸，Waza 是姐姐，Kami 是妹妹。

卸载

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
rm -f ~/.claude/rules/clarity.md

状态栏还需从 ~/.claude/settings.json 删掉 statusLine 条目，Claude Desktop 直接在 Customize > Skills 中删除 Waza，装过 Codex 规则的，从 ~/.codex/AGENTS.md 删掉对应的 Waza 标记块，Antigravity 从 ~/.gemini/antigravity-cli/rules/ 删除对应规则文件，其他工具从自定义指令中移除即可，移除后开启新会话生效。

支持

• 最直接的支持方式是购买 Mole for Mac，这是我开发的 Mac 清理应用
• 如果 Waza 对你有帮助，欢迎点个 Star，分享给朋友，或者在读过 SCOPE.md 后提交 Issue 与 PR
• 我养了两只猫，汤圆和可乐，如果 Waza 帮到了你，可以给她们加个 罐头 🥩

已经赞助过的可爱朋友们 🐱

许可证

MIT License. Please feel free to use and contribute to the development.