Waza 是什么?

Waza(技,わざ,日语「招式/技艺」)是开发者 tw93 出品的一组 Claude Code / Codex 技能,把「优秀工程师早已内化的工程习惯」做成 AI 可直接运行的技能。它包含八个技能——/think(先想清楚再动手)、/design(做有辨识度的前端界面)、/check(合并/发布前审查改动)、/hunt(系统化排查 bug)、/write(把中英文写得自然)、/learn(六阶段研究学习)、/read(把网页/PDF 抓成干净 Markdown)、/health(审计 agent 健康度)。每个技能是一个含参考文档、辅助脚本与「真实踩坑经验」的文件夹。它是 tw93「三件套」之一:Kaku 写代码、Waza 练习惯、Kami 出文档。MIT 开源,约 5k 星。

⭐ 5,250 Stars 🍴 310 Forks Python 作者: tw93
来源:README Why/Skills 表、GitHub meta(tw93/Waza,Python,MIT) 查看 GitHub 仓库 →

为什么值得关注

AI 的原始产出能力已超过多数工程师,但缺乏结构时容易漂成「通用、不精确」的工作。Waza 的思路是:用工程师熟知的习惯(先思考、自审、系统调试、刻意的接口设计、读一手资料、靠产出来学习)给 AI 设清目标与约束,再让模型发挥所长,把能力收束成精度。它出自以 Pake 等项目知名的 tw93、是结构清晰的「三件套」之一,技能实用、安装便捷(npx skills / 插件市场 / Claude Desktop / Codex / Pi 多端),并强调隐私优先与真实失败经验沉淀,因此在 Claude Code 技能生态里受到关注(约 5,000 星,迭代活跃)。

来源:README Why、Install、GitHub meta(stars 4997、created_at 2026-03-12、pushed_at 2026-05-22)

核心功能

/think 与 /design

/think 在动手做新东西前质询问题、压力测试设计,产出另一个 agent 就能据以实现的「决策完整」方案;/design 做有辨识度的前端界面,含截图驱动的审美迭代,并给出明确方向而非通用默认。

来源:README Skills 表(think/design)
/check 与 /hunt

/check 在任务后、合并/发布前审查 diff、提取项目特定约束、按授权完成 release/publish/push/回应等收尾并以证据验证;/hunt 做系统化调试,在任何修复前先确认根因(尤其是「以前能用现在不行」时)。

来源:README Skills 表(check/hunt)
/write 与 /learn

/write 把文字改写得中英文都自然、去掉生硬套话;/learn 用六阶段研究流程(收集→消化→列纲→填充→精修→自审发布)系统钻研陌生领域。

来源:README Skills 表(write/learn)
/read 与 /health

/read 把任意 URL 或 PDF 抓成干净 Markdown,对 GitHub/PDF/微信/飞书有专门路由,隐私优先(默认本地提取器,--use-proxy 才用 defuddle.md / r.jina.ai 处理重 JS 页面);/health 审计 agent 健康度——检查 Codex、Claude Code、项目指令、verifier 输出与 AI 可维护性,先做预算感知的摘要,再按需深查。

来源:README Skills 表(read/health)、Compatibility 段
可链式组合、项目感知、多端安装

技能设计为可手动链式串联(如 /think→实现→/check,或 /read→/learn→/write),但转场需用户决定、不自动触发;/check 通过读目标仓库公开上下文与用户约束变得项目感知。支持 Claude Code、Codex、Claude Desktop、插件市场、Pi 多端安装。

来源:README Chaining Skills/Project Context/Install 段

技术架构

Waza 是一个以技能定义为主、配 Python 辅助脚本的 Claude Code/Codex 技能合集。核心在 skills/ 下按技能名分八个文件夹(think/design/check/hunt/write/learn/read/health),每个含 SKILL.md(技能 playbook)、references/(参考文档,如 check 的 project-context.md 审查模板)、helper 脚本与真实失败经验记录;另有 skills/RESOLVER.md 等。仓库根部有 .claude-plugin(插件市场配置)、AGENTS.md/CLAUDE.md(agent 指令)、Makefile、package.json、VERSION,并配 GitHub Actions 测试。技能本质是可移植的指令文件,由宿主代理(Claude Code/Codex/Pi/Claude Desktop)加载;安装走 npx skills、插件市场或上传 zip。/check 在运行时读目标仓库的 README/manifest/Makefile/CI 等推断项目命令与硬性约束,从而做到项目感知。

来源:README Skills/Project Context/Install、仓库目录(skills/* 八个、.claude-plugin、AGENTS.md、Makefile、VERSION)

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) npx skills(安装/更新)npx skills(安… Claude Code 插件市场Claude Code 插… 宿主代理:Claude Code、Codex、Claude Desktop、Pi宿主代理:Claud… 可选 defuddle.md / r.jina.ai(/read 的 --use-proxy)可选 defuddle.… /think 与 /design /check 与 /hunt /write 与 /learn /read 与 /health 可链式组合、项目感知、多端安装可链式组合、项目感知、… Waza 项目本体 核心功能 关键依赖

中心为项目本体,内环 = 核心功能模块,外环 = 关键技术依赖;按 deep.json 中的 core_features 与 tech_stack.key_deps 自动生成

技术栈

语言Markdown 技能定义(SKILL.md)为主 + Python 辅助脚本框架Agent Skills(Claude Code / Codex / Pi 等规范)
npx skills(安装/更新)Claude Code 插件市场宿主代理:Claude Code、Codex、Claude Deskto…可选 defuddle.md / r.jina.ai(/read 的 -…
纯仓库分发,无服务端;多端安装(npx/插件市场/zip),可全局或单技能安装
来源:README Install/Update/Skills(read 的代理选项)、仓库结构

快速上手

推荐全局安装让所有项目都能用。Claude Code:`npx skills add tw93/Waza -a claude-code -g -y`(一次装全部八个;单装用 --skill think)。Codex:`npx skills add tw93/Waza -a codex -g -y`,会话里按名调用或链接到 `npx skills path tw93/Waza` 显示的 SKILL.md。插件市场(Claude Code v2.1.143+):`/plugin marketplace add tw93/Waza` 然后 `/plugin install waza@waza`(单技能 `/plugin install waza-think@waza`)。Claude Desktop:下载 waza.zip,在 Customize>Skills 上传。更新:`npx skills update -g -y`。装好后在 Claude Code 用斜杠命令(如 /think、/check)、在 Codex 按名调用并照同一 playbook 执行。
来源:README Install and Update 段

使用场景

适合用 Claude Code/Codex 做工程的人,把成熟工程习惯固化进 AI 工作流:动手前用 /think 把需求与设计想透并产出可实施方案、做前端用 /design 拿到有辨识度的界面、合并发布前用 /check 审查改动并安全收尾、遇 bug 用 /hunt 先定位根因再改、写文档/文案用 /write 去套话、钻研新领域用 /learn、抓网页或 PDF 用 /read、定期用 /health 体检 agent 配置。常见可手动链式:/think→实现→/check、/hunt→修→/check、/read→/learn→/write。也可作为「如何写高质量工程类 skill」的范例。

来源:README Skills/Chaining Skills、Why

优势与局限

优势

  • 选题精准:把「先思考、自审、系统调试、读一手资料、靠产出学习」等公认好习惯做成可运行技能,给 AI 设清目标与约束、提升产出精度。
  • 做工扎实:每个技能含参考文档、辅助脚本与真实踩坑记录,/check 还能读仓库上下文做到项目感知,/read 隐私优先。
  • 多端、易装、可组合:Claude Code/Codex/Desktop/Pi 多端,npx 或插件市场一键安装,可全局或单技能,并能手动链式串联。
  • 出自口碑开发者 tw93、MIT 开源、有测试与版本管理,是结构清晰「三件套」的一员。

局限

  • 效果是提示/流程层引导,最终质量仍取决于底层模型与输入,不保证每次都达标。
  • 链式转场需用户手动决定、技能不自动互相触发,复杂流程仍要人来编排。
  • 部分能力有平台差异(如 /health 的运行时审计目前聚焦 Codex 与 Claude Code,Pi 覆盖待补;插件市场单技能需较新版本)。
  • 强绑定 Claude Code/Codex 等代理的技能机制,迁移到其它平台需适配。
来源:README Chaining Skills/Compatibility/Install、技能为指令文件的本质

最新版本

项目以 GitHub Releases 发版(含 waza.zip 供 Claude Desktop 上传)、并经 npx skills 与插件市场分发,配 CI 测试与 VERSION 管理。当前八个技能(think/design/check/hunt/write/learn/read/health)均可用,/health 已支持 Claude Code 与 Codex 的 Agent Health 审计。仓库最近一次更新在 2026-05-22。

来源:README Install/Compatibility、徽章(Tests/Version)、GitHub meta pushed_at 2026-05-22

总结评价

Waza 是 Claude Code 技能生态里做得很有想法的一组工程习惯技能:它不堆功能,而是把「先想清楚、严格自审、系统调试、读一手资料、靠产出学习」这些公认的好习惯变成 AI 能跑的 /think、/check、/hunt 等八个技能,并以参考文档、脚本和真实踩坑经验把它们打磨得可靠,还能项目感知与手动链式组合。对用 Claude Code/Codex 做工程、想让 AI 产出更精确而非通用的人很实用,多端易装也降低了门槛。要理解它是流程层引导、效果随模型而定、转场需手动编排。出自 tw93、MIT 开源、结构清晰,作为「把工程师本能装进 AI」的技能集,质量与定位都很到位。

来源:综合 README、Skills、Install 与 GitHub meta 的事实判断
透明度声明
本页内容由 AI(大语言模型)基于以下公开材料自动生成:GitHub README、代码目录结构、依赖文件、Release 信息。 分析时间: 2026-05-23 18:52. 质量评分: 100/100.

数据来源:README、GitHub API、依赖文件