Waza English Coaching 规则解读：面向非母语工程师的低干扰英语纠错机制

【免费下载链接】Waza Engineering habits you already know, turned into skills Claude can run.项目地址https://gitcode.com/gh_mirrors/cl/Waza点击查看免费下载本篇技术指南围绕 Waza 仓库中rules/english.md与plugins/waza/rules/english.md内容一致展开讲解这条常驻规则如何在日常对话中为英语非母语用户提供克制、安静、可量化的英语纠错什么情况必须闭嘴、什么情况才出手、出错时按什么格式反馈、重点识别哪些语法模式以及它在 Waza 的规则体系里如何被安装、校验和保护。读完你既能照抄这套规则到自己的 Agent 配置里也能从源码角度理解它为什么被设计成少即是多。规则定位Waza 规则体系里的静音式常驻行为Waza 把工程习惯沉淀成两类载体skills/下的八个技能think、ui、check、hunt、write、read、learn、health负责按需触发的工作流而rules/*.md负责始终在线的行为护栏不依赖具体技能是否激活。English Coaching 属于后者它的适用对象是英语非母语、需要在国际协作中把英语写得和说得更自然的用户且以安静地应用Apply this quietly为总基调——它不抢话头不打断工作流只在真正出错时出现。从路由表 waza-routing.md 看写稿、润色、去 AI 味这类任务会优先路由到write技能其 SKILL.md 位于 write/SKILL.md但 English Coaching 与write分工明确write是用户主动发起的批量文稿处理English Coaching 则是会话过程中对用户自己写的零星英文做逐条轻量纠正不进入任何技能入口也不需要用户发起请求。这条规则还承担了一个防呆职责scripts/checks_content.py中的check_english_coaching_guard()checks_content.py专门校验rules/english.md必须保留两个失败模式护栏一是对纯中文消息保持沉默二是对已经自然的英文保持沉默。注释写明这些护栏是在真实误触发事故后加的不要让它们腐烂These guards were added after real misfires; do not let them rot说明沉默条款是这条规则的历史核心而非可有可无的装饰。核心机制一什么时候闭嘴Stay Silent规则的第一条硬约束是只纠正用户写的、确实存在语法或措辞错误的地方并且显式列举了必须保持沉默的清单纯中文消息Chinese-only messagesURL命令commands代码code日志logs名称names引语quotes已经自然的英文already-natural English这条清单的设计意图可以从两个角度理解。一是噪音控制URL、命令、代码、日志属于机器语义不参与自然语言评分纠正它们既无意义又制造干扰。二是信任保护如果 Agent 频繁纠正没出错的英文用户会开始怀疑每一条纠正的可信度真正重要的错误反而被淹没。仓库对这条沉默条款有自动化保护。check_english_coaching_guard检查rules/english.md文本中必须包含两个标记字符串Chinese-only messages 与 already-natural English, stay silent缺失任一即判失败fail。该检查同时被挂在scripts/skill_checks.py的check_english_coaching_guard与 verify_skills.py 的校验清单里也就是说任何人改动这条规则时一旦删掉沉默条款CI 或技能校验脚本就会报警。核心机制二什么时候出手Correct当用户确实写出了真实错误规则给出的输出协议非常明确每条问题在消息末尾追加一行格式为 原文 → 修正 (模式名)不加任何解释No explanation按重要性排序优先纠正重要错误语气要耐心、鼓励像一位温和的老师绝不冷漠或临床化patient and encouraging, like a kind teacher. Never cold or clinical规则原文给出的示例格式无引号 discuss about → discuss (Redundant preposition) I am very interest → I am very interested (Wrong verb form) it is not good to be read → its hard to read (Unnatural phrasing)这个格式值得拆解图标承担语气软化作用让纠错在视觉上友好化箭头前后分别是原文与修正括号里的模式名让用户能对错误进行分类记忆而不是只得到一个孤立的改正。逐条追加、不做解释的设计把纠正的认知成本压到最低——用户扫一眼就能拿到错在哪、怎么改、属于哪类而不会被一段解释打断思路。常见错误模式清单规则内置了十一个高频错误模式用于帮助 Agent 识别值得出手的问题类别模式一句话含义Missing article冠词缺失a / an / theWrong article冠词用错Redundant preposition介词冗余如 discuss aboutGerund vs. base verb动名词与动词原形混淆Wrong verb form动词形态错误如 interest → interestedPassive voice error被动语态错误Subject-verb agreement主谓一致问题Double subject双重主语Tense error时态错误Unnatural phrasing不自然措辞Over-hedging过度委婉/过多限定词这十一类覆盖了非母语写作者在国际工作场景里最高频的出错面冠词和介词是系统性的、可教的错误类型动词形态与时态是基础准确性问题而 Unnatural phrasing 与 Over-hedging 则指向语法正确但不像母语者会说的话这一层。最后两类尤其重要English Coaching 的目标不是把英语改得语法完美而是让用户在国际协作中说得更自然。与 Write 技能的英语场景协同write技能加载的 write-en.md 处理的是批量英文文本的去 AI 味其目录同样是气味清单而非检查清单a catalog of smells, not a checklist to run top to bottom并且明令过度编辑与编辑不足一样是失败Over-editing is failure, equal to under-editing。这与 English Coaching 的克制哲学一脉相承两者都拒绝尽可能多地改。在 write/SKILL.md 中还有一处与 English Coaching 直接相关的硬规则No em-dash——中英文输出一律禁止使用 U2014 与 U2013 破折号因为它是这里最强的 AI 味指纹。该规则由标点门禁脚本 check_punctuation.py 逐字符执行它按语言环境检查 CJK/拉丁混排、全角标点、em/en 破折号并跳过代码块、行内代码、URL 与链接目标。这与 English Coaching跳过命令、代码、URL、日志的沉默清单是同一套边界哲学机器可判定的内容不参与语言评分。值得注意的差异是English Coaching 的示例本身不含 em-dash纠正行只使用箭头→、括号与普通连字符这恰好符合 Write 技能的标点规范两条规则在输出形态上彼此自洽。安装与分发如何把这条规则装进 Claude Code / Codex / AntigravityEnglish Coaching 规则可以通过 setup-rule.sh 安装到三种目标环境# 安装到 Claude Code默认目标 ./scripts/setup-rule.sh english claude-code # 或简写为 claude # 安装到 Codex写入 ~/.codex/AGENTS.md带开始/结束标记块 ./scripts/setup-rule.sh english codex # 安装到 Antigravity CLI写入 ~/.gemini/antigravity-cli/rules/ ./scripts/setup-rule.sh english antigravity-cli # 也接受 antigravity 或 agy 别名脚本的关键行为值得注意原子下载规则文件先从rules/rule-name.md对应的远端地址下载到同目录临时文件curl 完成含 Ctrl-C/终止信号中断场景均有 trap 兜底后才mv换入中途失败不会破坏已安装的规则文件。Codex 的幂等安装Codex 目标把规则以!-- Waza English Coaching: start --/!-- Waza English Coaching: end --标记块的形式写进~/.codex/AGENTS.md重复运行会替换旧块而不是追加第二份。测试 test_english-coaching-installer.sh 验证了这一点连续两次安装后start 标记在文件中恰好出现一次。标记标签映射脚本第 47 行显式把english映射为标记标签English Coaching这是为了保持既有安装的幂等性——老安装用的就是这个标签改了会导致旧标记块无法被识别替换。默认版本引用WAZA_REF默认v3.38.0可覆盖为main或任意vX.Y.Z发布标签脚本会校验格式。仓库分发侧同样把 english 规则列为必须打包的产物scripts/checks_distribution.py的打包清单checks_distribution.py中包含english.md确保发布包不缺这条规则。由于仓库是只读的实际使用时应按上述命令将规则安装到你本机的 Agent 配置目录而不是直接修改仓库文件。源码级佐证沉默护栏为何不可删check_english_coaching_guard的失败信息写得很直白ENGLISH COACHING GUARD: rules/english.md must suppress no-op output.必须抑制无操作输出。注释进一步说明护栏针对的是真实发生过的事故added after real misfires如果 Agent 对纯中文消息逐条纠正、或对本来就自然的英文挑刺用户很快会关闭整个规则英语提升的收益归零。这一设计在更广的 Waza 规则体系里也找得到呼应。anti-patterns.md 第 6 条Format overkill简单答案套上标题列表总结、第 9 条Invent missing data用听起来合理的内容填补空白、第 10 条Ignore error output都指向同一个原则输出与需求匹配不制造多余动作。English Coaching 是这一原则在语言教学场景的具体化——它存在的意义恰恰是大多数时候什么都不说。落地建议与边界把 English Coaching 部署到自己的 Agent 时有三条实操建议直接来自仓库设计保留沉默条款一个字都别删。它是防误触发护栏verify_skills.py和skill_checks.py都会校验其存在删掉后规则会退化成每句都纠正的噪音源。输出格式严格照抄 原文 → 修正 (模式名)、逐条追加、不解释、按重要性排序。格式本身就是用户体验的一部分。与 Write 技能配合使用日常零星纠错交给 English Coaching批量文稿润色、去 AI 味、本地化走 write/SKILL.md两者触发时机不同、互不重叠。适用边界也要说清这条规则的目标是国际工作场景下的自然英语它以非母语用户为对象对母语用户、对纯代码评审场景它并不适用且规则从未承诺覆盖全部语法问题——十一类模式是高频清单不是完整语法手册。它和 Waza 的其他规则一样靠少而准建立可信度而不是靠全而多证明存在感。赞分享【免费下载链接】Waza Engineering habits you already know, turned into skills Claude can run.项目地址https://gitcode.com/gh_mirrors/cl/Waza点击查看免费下载相关推荐MCprep终极Blender Minecraft动画创作插件完整指南MCprep终极Blender Minecraft动画创作插件完整指南 你是否曾经梦想过将Minecraft世界变成生动的动画却因为繁琐的技术流程而止步不前图形学游戏开发antd-admin 工程规范用 Cursor 规则强制英文代码注释English-only Commentsantd admin 工程规范用 Cursor 规则强制英文代码注释English only Comments 导读 antd admin 是一个面向 A前端开发工具english-note 英语语法笔记副词的构词分类、修饰对象与位置规则全解english note 英语语法笔记副词的构词分类、修饰对象与位置规则全解 本文以 docs/guide/adverb.md https://link.gi文档知识库教程上一篇5分钟上手AI图表生成神器ChartGPT完全指南从文本到可视化的智能转换下一篇5分钟让Xbox手柄在Mac上重生360Controller驱动全攻略 创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考