waza

Waza 是一套面向 AI 编程智能体的八项工程习惯技能集合。其前提是，优秀的工程师不仅仅写代码：他们会压力测试需求、调试到根因、审查自己的 diff，并阅读一手资料。Waza 将这些习惯打包为智能体可以运行的技能，每项技能只负责一件事，并有明确的触发条件。 ## 八项技能 - /think — 在构建任何新东西之前使用。挑战问题、压力测试设计，并产出一份决策完整的计划，供另一个智能体实施。 - /ui — 在构建前端界面时使用。目标是打造具有鲜明方向感的独特 UI，包括由截图驱动的美学迭代。 - /check — 在任务完成后、合并或发布前使用。根据项目约束审查 diff、验证结果，并处理已批准的发布和维护者操作。 - /hunt — 用于任何 bug、回归或意外行为。系统化调试，在应用修复前确认根因。 - /write — 在撰写或编辑文章时使用。重写文章，使其在中文和英文中听起来自然，并删减生硬、公式化的措辞。 - /learn — 在深入一个不熟悉的领域时使用。六阶段研究工作流：收集、消化、列大纲、填充、精炼，然后自我审查并发布。 - /read — 用于任何 URL 或 PDF。返回简洁摘要，或干净的 Markdown，以便转换、引用、引述、保存或进一步研究。 - /health — 审计智能体健康状况：Codex、Claude Code、项目指令、验证器输出和 AI 可维护性，并在深入检查前进行一次预算感知的摘要检查。 每项技能都是一个文件夹，包含参考文档、辅助脚本，以及来自真实失败的经验教训笔记。 ## 安装 对于 Claude Code、Codex、Cursor 和其他智能体，一条 npx 命令即可将技能安装到共享的 `~/.agents/skills` 目录，并将 Claude Code 以符号链接方式接入。读取该目录的智能体会将这些技能识别为斜杠命令；拥有私有技能目录的智能体则在 `-a` 标志后指定。更新使用 `npx skills update -g -y`。 Claude Code 和 Codex 也支持宿主插件，此时技能会带命名空间（例如 `/waza:check`）。Claude Desktop 用户可以从 releases 下载 ZIP，并在 Customize > Skills 下上传。此外还提供 Pi 包。 ## 串联与上下文 用户决定技能如何串联。文档中记录的工作流包括：规划功能（/think 然后 /check）、发布修复（/hunt、修复、/check）、研究与写作（/read、/learn、/write），以及调试并验证（/hunt 然后 /check）。 Waza 只提供通用习惯。/check 技能会在运行时通过读取目标仓库的公开上下文（如 README、包清单、Makefile 和 CI 工作流）以及任务约束，变得具备项目感知能力——而不是读取私有路径、凭据或令牌。 ## 附加内容 一个面向 Claude Code 的极简状态栏会显示上下文窗口、5 小时配额和 7 天配额，并按使用量着色，不使用进度条。Codex 在 `~/.codex/config.toml` 中配置原生状态栏项。还可以安装三个可选规则开关：当提示中存在英语错误时追加简短纠正的英语辅导、始终开启的反模式护栏，以及一条路由提示，告诉非 Claude 宿主在请求匹配其触发条件时优先使用 Waza 技能。 ## 背景 Waza（技）是日本武术中表示“技巧”的术语。该项目将自己定位为相较更庞大的技能集合而言刻意保持精简，并表示这些技能来自真实项目，并在 7 个项目的 300 多次会话中不断完善。它被描述为与 Kaku（代码）和 Kami（文档）并列的三部曲之一。采用 MIT 许可证。