Skill Waza 把工程习惯封装成AI编程助手技能

AI 有做对每件工程事的原始能力——压测需求、定位根因、审自己的 diff、读一手资料——但没有结构时，输出会漂成泛泛而松散的产物。好的工程师不只是写代码，他们会先质疑需求、调试到根因、审查改动、读原始来源。
Waza（技/わざ）的想法是：把这些“练到成本能”的工程习惯，固化成一组带明确产出、红线与验证方式的 skill，让模型选路径但守住质量，而不是每次都重新开始。

项目基本信息

一、项目介绍

tw93/Waza 是一个 MIT 协议的开源技能包，把作者成熟的工程习惯变成 Claude Code、Codex、Cursor 等 agent 可直接调用的技能。它包含 /think（动手前压测设计）、/ui（做出有辨识度的界面）、/check（合并/发布前审 diff）、/hunt（系统化 debug，根因确认才修）、/write（中英自然语言润色）、/learn（六阶段研究）、/read（URL/PDF 摘要）、/health（审计 agent 配置）八个技能。一份副本落在跨 agent 共享目录，各主机按名字唤起同样的 playbook。

二、核心优势

1. 八项工程习惯：覆盖规划、UI、审查、debug、写作、研究、阅读、审计。
2. 可链式：/think 定方案、实现后 /check 审查、/hunt 定位根因，流程由你决定。
3. 跨 agent：一份安装同时被 Claude Code、Codex、Cursor、Gemini CLI、Copilot 等拾取。
4. 项目感知：/check 运行时读取目标仓库公开上下文，从不碰私有路径与凭据。
5. 可选规则：英文纠错、反模式护栏、路由提示、清晰写作等规则可装进持久指令。

三、适用场景

• 功能开发：先用 /think 定方案，实现后 /check 再合并。
• 修 bug：/hunt 找根因再修，随后 /check 审查与发布。
• 调研写作：/read 抓源、/learn 综合、/write 润色。
• 审计 agent 配置与可维护性：用 /health 出预算感知的概览。

四、安装教程

Claude Code、Codex、Cursor 等一键安装（落一份到 ~/.agents/skills 并软链）：

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

更新：npx skills update -g -y。Claude Desktop 可下载 waza.zip 从设置里上传。也可走 host 插件：

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

常见报错：npx 不在 PATH 先装 Node.js；某主机私有技能目录需用 -a 指定其 id。

五、使用示例

在 agent 里直接唤起技能即可，例如规划一个功能时：

用 /think 先把“要做 X”的设计压测清楚，给我一个可交给别的 agent 实现的决策完整方案

修复缺陷时：

用 /hunt 定位这个偶现崩溃的根因，确认根因后再动手修

真实体验：每个技能停在所请求的产出上，显式授权的流程才会继续，不逼你逐步确认。

六、常见问题

Q：Waza 和 Superpowers 这类技能包有何不同？
A：Waza 强调每个技能声明产出、红线与验证方式，然后让模型自选路径；它只给通用工程习惯，/check 运行时读公开上下文变项目感知。
Q：会改我的代码吗？
A：技能本身不自动改；它产出计划/审查/建议，是否执行由你授权。
Q：协议能商用吗？
A：采用 MIT License，可自由用于团队与个人，需保留版权与许可声明。

七、总结

Waza 把“会做对工程事的本能”固化为可复用、可链式的 AI 技能，让编程助手在规划、审查、debug、写作各环节都更有结构。对想用 Claude Code/Codex/Cursor 但嫌默认输出太松的工程师，它是 MIT 协议、跨 agent、可渐进采用的高性价比技能包。