waza

Waza是一套面向AI编码代理的八种工程习惯技能集合。其核心理念是，优秀的工程师不仅编写代码，还会对需求进行压力测试、追根溯源调试、审查自己的差异，并阅读原始资料。Waza将这些习惯封装为代理可运行的技能，每项技能都有明确职责和触发条件。 ## 八项技能 - /think — 在构建任何新内容前使用。挑战问题本身，对设计进行压力测试，并生成一份决策完备的计划，供其他代理实施。 - /ui — 在构建前端界面时使用。追求具有明确方向的独特UI，包括基于截图的审美迭代。 - /check — 在任务完成后、合并或发布前使用。对照项目约束审查差异，验证结果，并处理已批准的发布和维护操作。 - /hunt — 用于任何错误、回归或意外行为。进行系统性调试，在应用修复前确认根本原因。 - /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用户可从发布页面下载ZIP，并在自定义>技能下上传。同时提供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许可证。