## 为什么 Waza (技, わざ) 是日本武术中指代“技术”的术语：一种经过反复练习直至成为本能的招式。 优秀的工程师不仅仅会写代码。他们会深入思考需求，审查自己的工作，系统地进行调试，设计出充满意图的接口，并阅读第一手资料。他们表达清晰，通过产出而非消费内容来学习新领域。 在原始产出方面，AI 比大多数工程师都更强大。但如果没有结构，这种能力就会流于平庸和粗糙。Waza 将其引导至精准：八项技能设定明确的目标和约束，然后让模型发挥其最大优势。 它是三部曲的一部分：[Kaku](https://github.com/tw93/Kaku) (書く) 编写代码，[Waza](https://github.com/tw93/Waza) (技) 训练习惯，[Kami](https://github.com/tw93/Kami) (紙) 发布文档。可以把它们看作一家人：Kaku 是爸爸，Waza 是姐姐，Kami 是妹妹。 ## 技能 每种工程习惯都对应一个已安装的技能。在 Claude Code 中，输入斜杠命令。在 Codex 中，通过名称调用已安装的技能并遵循相同的操作流程。 | 技能 | 何时使用 | 功能 | | :--- | :--- | :--- | | [`/think`](skills/think/SKILL.md) | 在构建任何新内容之前 | 挑战问题，对设计进行压力测试，并生成一个决策完备的计划，可供其他 agent 执行。 | | [`/design`](skills/design/SKILL.md) | 构建 frontend 接口时 | 生成独特的 UI，包括基于截图的审美迭代，坚持确定的方向而非通用的默认设置。 | | [`/check`](skills/check/SKILL.md) | 任务完成后，合并或发布之前 | 审查 diff，提取项目特定的约束，处理已批准的发布/推送/响应跟进，并以证据进行验证。 | | [`/hunt`](skills/hunt/SKILL.md) | 遇到任何 bug、回归或异常行为时 | 系统性调试。在应用任何修复之前确认根本原因，尤其是对于曾经正常工作的功能。 | | [`/write`](skills/write/SKILL.md) | 撰写或编辑文章时 | 重写文章，使其在中英文中听起来自然流畅。删减生硬、公式化的表达。 | | [`/learn`](skills/learn/SKILL.md) | 深入不熟悉的领域时 | 六阶段研究工作流：收集、消化、拟定大纲、填充内容、润色，然后自我审查并发布。 | | [`/read`](skills/read/SKILL.md) | 阅读任何 URL 或 PDF 时 | 通过平台特定的路由读取 URL 和 PDF。普通读取返回简明摘要；当被要求转换、引用、保存或用于后续工作时，使用 Markdown 输出。 | | [`/health`](skills/health/SKILL.md) | 审计 Agent 健康状况时 | 在深度检查之前，以预算感知的摘要方式检查 Codex、Claude Code、项目指令、验证器输出和 AI 可维护性。 | 每个技能都是一个文件夹，其中包含参考文档、辅助脚本以及从真实失败中总结出的避坑指南。 ## 安装与更新 大多数用户应该全局安装 Waza，这样就可以在每个项目中使用相同的技能。 **Claude Code** ``` npx skills add tw93/Waza -a claude-code -g -y ``` 这会安装 `/think`、`/design`、`/check`、`/hunt`、`/write`、`/learn`、`/read` 和 `/health`。你也可以使用 `npx skills add tw93/Waza --skill think -a claude-code -g -y` 仅安装其中一个。 **Codex** ``` npx skills add tw93/Waza -a codex -g -y ``` 使用 `npx skills add tw93/Waza --skill think -a codex -g -y` 仅安装其中一个。Codex 会话可以通过名称调用已安装的技能，或者链接到由 `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`。两者都通过技能安装器使用 Waza 标准的 `skills//SKILL.md` 布局。 **OpenCode** ``` npx skills add tw93/Waza -a opencode -g -y ``` OpenCode 在安装后通过其原生的技能工具加载 Waza。当任务匹配 `think`、`design`、`check`、`hunt`、`write`、`learn`、`read` 或 `health` 时，通过名称调用这些技能。 **Claude Code 插件市场** (单技能安装需要 Claude Code v2.1.143+) ``` /plugin marketplace add tw93/Waza /plugin install waza@waza ``` 这会安装全部八个技能。在 Claude Code v2.1.143 或更高版本上，使用 `/plugin install waza-@waza`（例如 `waza-think@waza`）仅安装其中一个。 **Claude Desktop** 下载 [waza.zip](https://github.com/tw93/Waza/releases/latest/download/waza.zip)，打开 Customize > Skills > "+" > Create skill，然后上传该 ZIP 文件。 **Pi 编程 Agent** ``` pi install npm:@tw93/waza ``` Pi 可以从代码库或已发布的 `@tw93/waza` npm 包加载 Waza 标准的 `skills//SKILL.md` 布局，该包暴露了指向 `./skills` 的 `pi.skills` 元数据。`/health` 会连同 Claude Code 和 Codex 一起，审计 Pi 设置、已配置的包以及本地技能根目录。 **更新** ``` npx skills update -g -y ``` 市场安装使用 `claude plugin update `。Claude Desktop 用户可以使用最新的 [waza.zip](https://github.com/tw93/Waza/releases/latest/download/waza.zip) 替换旧技能。 Pi 用户可以运行 `pi update npm:@tw93/waza`，或运行 `pi update --extensions` 更新所有已安装的 Pi 包。 要获取新版本的消息，请关注 Waza 的 [GitHub Releases](https://github.com/tw93/Waza/releases)。 ## 项目上下文 Waza 将通用的程序员习惯保留在公共技能中。`/check` 通过读取目标代码库的公共上下文和用户的任务约束，变得具备项目感知能力。 - 项目命令来源于 README 文件、package 清单、Makefiles、CI 工作流以及明确的用户指令。 - 项目的绝对红线包括生成的制品、受保护的文件、版本同步、发布资产以及特定于领域的安全风险。 - 公共文档和示例中不得包含凭证、证书路径、私钥文件名、token 或个人机器详情。 审查上下文模板请参见 [`skills/check/references/project-context.md`](skills/check/references/project-context.md)。 ## 链式调用技能 技能被设计为可以链式调用，但过渡是手动的。每个技能在完成任务后都会停止，并等待你决定下一步。 **常见工作流：** - **设计一个功能**：`/think` → 批准 → 输入 "implement X" → `/check` → 合并 - **发布一个修复**：`/hunt` → 修复 → `/check` → 发布/推送/问题跟进 - **研究与写作**：`/read`（获取资源）→ `/learn`（综合）→ `/write`（润色） - **调试与验证**：`/hunt`（找到根本原因）→ 修复 → `/check`（审查更改） 每个箭头都代表一个手动的用户操作。技能之间不会自动相互触发。 ## 附加功能 ### 状态栏 为 Claude Code 提供的极简状态栏：上下文窗口、5 小时配额和 7 天配额。按使用量进行颜色编码，没有进度条，没有干扰信息。

``` curl -sL https://github.com/tw93/Waza/releases/latest/download/setup-statusline.sh | bash ``` **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`）。 ### 英语辅导 用于英语练习的可选规则。当你的 prompt 中包含英语错误时，agent 会附加一个简短的 😇 纠正；纯中文的 prompt 保持不变。

``` # 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 ``` ### 反面模式 针对跨技能行为的可选常驻护栏：阅读后再行动，无虚构路径，无范围蔓延，无主动提供摘要。不限定特定技能，适用于每个会话。 ``` curl -sL https://github.com/tw93/Waza/releases/latest/download/setup-rule.sh | bash -s -- anti-patterns claude-code ``` 对于 Codex，使用 `codex` 代替 `claude-code`。Curl URL 使用最新的 GitHub 发布资产。如果你想要最前沿的脚本，请在命令前设置 `WAZA_REF=main`。 ### 路由提示 可选的指针，用于告知宿主环境在请求匹配触发条件时优先使用 Waza 技能。对于 Codex、Pi 和其他不会从技能 `description` 自动路由的 agent 非常有用。Claude Code 已经通过描述进行路由，因此即便在那里这也是可选的。 ``` curl -sL https://github.com/tw93/Waza/releases/latest/download/setup-rule.sh | bash -s -- waza-routing claude-code ``` 对于 Codex，使用 `codex` 代替 `claude-code`。 ## 卸载 ``` 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 的块。 ## 背景 像 Superpowers 和 gstack 这样的工具令人印象深刻但过于沉重：技能太多，配置太多，学习曲线太陡峭。 作者编写的每一条规则也是一个天花板。模型只能做指令所规定的事情。Waza 反其道而行之：每个技能都设定了明确的目标和关键约束，然后退居幕后。随着模型的改进，这种克制会产生复利效应。 八项针对真正重要习惯的技能。每一项只做一件事，都有明确的触发条件，且不产生干扰。基于真实项目构建，经过跨 7 个项目的 300 多次会话 refining。每一个避坑指南都可以追溯到一次真实的失败。 `/health` 技能源自[这篇文章](https://tw93.fun/en/2026-03-12/claude.html)中描述的六层 Claude Code 框架，现在涵盖了 Codex、Claude Code、Pi、验证器接口和 AI 可维护性。 ## 支持 - 支持我最直接的方式是购买 [Mole for Mac](https://mole.fit)，这是我付费的 Mac 清理应用。 - 如果 Waza 帮助到了你，请向朋友[分享它](https://twitter.com/intent/tweet?url=https://github.com/tw93/Waza&text=Waza%20-%20AI%20coding%20skills%20for%20the%20complete%20engineer.)或给它点个 Star。 - 有想法或发现 Bug？欢迎提交 Issue 或 PR，期待你贡献最好的 AI 模型。 - 我有两只猫，汤圆和可乐。如果你认为 Waza 给你的生活带来了愉悦，你可以给它们买点 猫罐头 🥩。

These lovely people already did 🐱

## 许可证 MIT 许可证。随时欢迎使用 Waza 并参与贡献。

标签：AI助手, AI智能体, Claude, Cutter, CVE检测, MITM代理, SOC Prime, 开发工具, 提示词工程, 策略决策点, 防御加固