## 为什么 Waza (技, わざ) 是日本武术中“技术”的术语：指经过反复练习直至成为本能的动作。 优秀的工程师绝不仅仅是编写代码。他们会深入思考需求，审查自己的工作，系统性地调试，设计出充满意图的接口，并阅读一手资料。他们能清晰表达，通过产出（而非仅仅消费内容）来学习新领域。 在纯输出能力方面，AI 已经超越了大多数工程师。但如果缺乏结构，这种能力就会 drifted into 泛泛而谈、缺乏精准度的工作中。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) | 构建前端界面时 | 打造具有辨识度的 UI，包括基于截图的美学迭代，提供确定的设计方向而非通用的默认样式。 | | [`/check`](skills/check/SKILL.md) | 任务完成后，合并或发布前 | 审查 diff，提取项目特定的约束条件，处理已批准的发布/推送/回应等后续工作，并提供证据进行验证。 | | [`/hunt`](skills/hunt/SKILL.md) | 遇到任何 bug、回归问题或异常行为时 | 系统性调试。在应用任何修复之前确认根本原因，尤其是针对过去曾正常工作的功能。 | | [`/write`](skills/write/SKILL.md) | 撰写或编辑文本时 | 重写文本，使其在中文和英文中听起来自然流畅。去除生硬、公式化的表达。 | | [`/learn`](skills/learn/SKILL.md) | 深入 unfamiliar 领域时 | 六阶段研究工作流：收集、消化、列出大纲、填充内容、优化，然后自我审查并发布。 | | [`/read`](skills/read/SKILL.md) | 阅读任意 URL 或 PDF 时 | 将内容获取为纯净的 Markdown，并支持特定平台的路由。针对 GitHub、PDF、微信和飞书进行了特殊处理。 | | [`/health`](skills/health/SKILL.md) | 审计 Claude Code 配置时 | 检查 CLAUDE.md、规则、技能、hooks、MCP 和行为，在进行深度检查前先执行感知预算的摘要扫描。 | 每个技能都是一个包含参考文档、辅助脚本和来自真实失败案例的注意事项的文件夹。 ## 安装和更新 大多数用户应该全局安装 Waza，这样同样的技能就能在每个项目中使用。 **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 ``` **Claude Code 插件市场** 通过 `waza` 包安装所有技能，或者通过 `waza-` 条目仅安装其中一个： ``` /plugin marketplace add tw93/Waza /plugin install waza@waza /plugin install waza-think@waza ``` **Codex** ``` npx skills add tw93/Waza -a codex -g -y ``` 使用 `--skill` 仅安装其中一个： ``` npx skills add tw93/Waza --skill think -a codex -g -y ``` **Codex 内联链接调用** 使用 `npx skills add tw93/Waza -a codex -g -y` 安装后，Codex 会话可以通过内联 Markdown 链接引用技能。标准安装路径为 `~/.claude/skills/waza/skills//SKILL.md`： ``` [$check](~/.claude/skills/waza/skills/check/SKILL.md) — review before ship [$hunt](~/.claude/skills/waza/skills/hunt/SKILL.md) — diagnose the regression [$think](~/.claude/skills/waza/skills/think/SKILL.md) — plan before build ``` **Claude Desktop** 下载 [waza.zip](https://github.com/tw93/Waza/releases/latest/download/waza.zip)，打开 Customize > Skills > "+" > Create skill，然后上传 ZIP 文件。 **更新** ``` npx skills update -g -y ``` 通过市场安装的使用 `claude plugin update `。Claude Desktop 用户可以使用最新的 [waza.zip](https://github.com/tw93/Waza/releases/latest/download/waza.zip) 替换旧技能。 **兼容性** `/health` 仅限 Claude Code 使用。它默认执行摘要审计，以避免在首次运行时耗尽配额；当你需要完整的会话提取和 inspector 子 Agent 时，可以要求执行深度或全面健康审计。其他技能被编写为使用宿主环境的原生提问、搜索、获取和 Agent 机制。当宿主支持时，`/check` 会运行并行的专业审查器；否则它会以内联方式执行相同的检查。 ## 项目上下文 Waza 将通用的程序员习惯保留在公共技能中。`/check` 通过读取目标仓库的公共上下文和用户的任务约束来具备项目感知能力。 - 项目命令来源于 README 文件、包清单、Makefiles、CI 工作流以及明确的用户指令。 - 项目硬性限制包括生成的构建产物、受保护的文件、版本同步、发布资产以及特定领域的安全风险。 - 公共文档和示例不得包含凭证、证书路径、私钥文件名、token 或个人机器详细信息。 参见 [`skills/check/references/project-context.md`](skills/check/references/project-context.md) 以查看审查上下文模板。 ## 链式组合技能 技能被设计为可以链式组合，但过渡是手动的。每个技能在完成任务后会停止，并等待你决定下一步。 **常见工作流：** - **设计一个功能**: `/think` → 批准 → 说 "implement X" → `/check` → 合并 - **发布一个修复**: `/hunt` → 修复 → `/check` → 发布/推送/处理后续 issue - **研究与写作**: `/read` (获取资料) → `/learn` (综合分析) → `/write` (润色) - **调试与验证**: `/hunt` (找到根本原因) → 修复 → `/check` (审查更改) 每个箭头都代表一次手动的用户操作。技能之间不会自动互相触发。 ## 附加功能 ### 状态栏 为 Claude Code 提供的一个极简状态栏：上下文窗口、5小时配额和7天配额。

颜色编码：低于 70% 时为绿色，70-85% 时为黄色，高于 85% 时为红色（针对上下文）；针对配额阈值分别为蓝色、洋红色和红色。没有进度条，没有视觉干扰。 ``` curl -sL https://raw.githubusercontent.com/tw93/Waza/main/scripts/setup-statusline.sh | bash ``` ### 英语辅导 用于英语练习的可选规则。当你的提示中包含英语错误时，Agent 会附加一个简短的 😇 纠正；纯中文提示则保持不变。

``` # Claude Code curl -sL https://raw.githubusercontent.com/tw93/Waza/main/scripts/setup-english-coaching.sh | bash -s -- claude-code # Codex curl -sL https://raw.githubusercontent.com/tw93/Waza/main/scripts/setup-english-coaching.sh | bash -s -- codex ``` ### 反模式 针对跨技能行为的可选常驻护栏：先阅读再行动，禁止捏造路径，防止范围蔓延，拒绝主动提供的总结。与具体技能无关，适用于每个会话。 ``` # Claude Code curl -sL https://raw.githubusercontent.com/tw93/Waza/main/scripts/setup-anti-patterns.sh | bash -s -- claude-code # Codex curl -sL https://raw.githubusercontent.com/tw93/Waza/main/scripts/setup-anti-patterns.sh | bash -s -- codex ``` ## 卸载 ``` # 移除所有 skills npx skills remove tw93/Waza -g # 移除 Claude Desktop skill # 打开 Customize > Skills，找到 Waza，点击 "..." > Delete # 移除 statusline rm -f ~/.claude/statusline.sh # 然后从 ~/.claude/settings.json 中移除 statusLine 键 # 移除 English Coaching (Claude Code) rm -f ~/.claude/rules/english.md # 移除 English Coaching (Codex)：从 ~/.codex/AGENTS.md 中移除 Waza English Coaching 标记块 # 移除 Anti-Patterns (Claude Code) rm -f ~/.claude/rules/anti-patterns.md # 移除 Anti-Patterns (Codex)：从 ~/.codex/AGENTS.md 中移除 Waza Anti-Patterns 标记块 ``` ## 背景 像 Superpowers 和 gstack 这样的工具令人印象深刻，但它们太重了。技能太多，配置太多，对于只想把事情做好的工程师来说，学习曲线太陡峭了。 还有一个更微妙的问题。作者写的每一条规则都会成为一个天花板。模型只能做指令所说的事情，无法走得更远。Waza 走了相反的方向。每个技能设定了清晰的目标和关键约束，然后退居幕后。随着模型的改进，这种克制会带来复利回报。 针对真正重要的习惯提供了八项技能。每个技能只做一件事，有明确的触发条件，并且不造成干扰。刻意追求不完备，只把正确的事情做好。 从真实项目中的模式构建，并通过实际使用不断打磨。每一个注意事项都可以追溯到一个真实的失败：一条花了四轮才找到的错误代码路径，一次在构建产物上传前就发布的版本，一台没有阅读错误日志就重启了八次的服务器。30 天，300 多个会话，7 个项目，500 个小时。 `/health` 技能基于[这篇文章](https://tw93.fun/en/2026-03-12/claude.html)中描述的六层框架。 ## 支持 - 如果 Waza 帮助了你，请向朋友[分享它](https://twitter.com/intent/tweet?url=https://github.com/tw93/Waza&text=Waza%20-%20Claude%20Code%20skills%20for%20the%20complete%20engineer.)或点个 star。 - 有想法或发现了 bug？欢迎提交 issue 或 PR，贡献你最好的 AI 模型。 - 我有两只猫，TangYuan 和 Coke。如果你认为 Waza 让你的生活更愉快，你可以给它们喂 猫罐头 🥩。

## 许可证 MIT License。欢迎自由使用 Waza 并参与贡献。

标签：AI提示工程, AI编程助手, Claude, Cutter, CVE检测, DLL 劫持, DNS解析, LLM技能, MITM代理, NLP, Prompt, 代码审查, 大语言模型, 威胁情报, 开发习惯, 开发者工具, 开源项目, 提示词框架, 数据管道, 横向移动, 界面设计, 系统设计, 编程规范, 网络调试, 自动化, 调试, 软件工程, 防御加固, 需求分析