1. 项目概述：为日本开发者打造的沉浸式英语编程教练

如果你是一名日语为母语的开发者，每天都要面对海量的英文技术文档、Stack Overflow上的英文问答，或者在跨国团队里用英语沟通代码，那种“词到用时方恨少”的无力感，我太懂了。传统的英语学习方式，比如背单词书、上语法课，往往和实际工作场景脱节，学完就忘，效率低下。今天要聊的这个项目 english-coding-coach ，就精准地戳中了这个痛点。它不是一个英语教学软件，而是一个专为 Claude Code（以及兼容的 AI 编程助手）设计的技能插件。它的核心思路非常巧妙： 让你在日常的编程工作中，不知不觉地提升英语能力 。

简单来说，当你用日语向 Claude Code 提问时，它会用英文回复你。但这可不是普通的英文回复，而是经过特殊“加工”的：它会将回复中的难点词汇用“简单英文同义词 + 日语翻译”的形式标注出来，同时通过加粗动词、分行显示句子等排版技巧，让你的阅读负担降到最低。最后，它还会贴心地附上一句日文摘要，确保你完全理解了核心意思。整个过程，你就像拥有一位随时在线的、精通技术的英语母语者搭档，他一边帮你解决代码问题，一边用最自然的方式帮你扫清语言障碍。

这个项目完全遵循开源的 Agent Skills 标准，这意味着它不仅能在 Claude Code 上运行，也能兼容任何支持该标准的 AI 编程代理（Agent），比如通过 Skills CLI 安装到 Cursor 或 OpenAI Codex 环境中。对于渴望突破语言壁垒、更自如地融入全球开发者社区的日本程序员而言，这无疑是一个极具实用价值的工具。

2. 核心设计思路与工作原理拆解

2.1 “编码优先，顺带学英语”的哲学

这个技能最核心的设计原则，我称之为“ 编码优先 ”。开发者使用它的首要目的，永远是解决手头的编程问题：修复一个棘手的 Bug、评审一段代码、设计一个新功能。英语学习只是这个过程中一个自然而然的“副产品”。这种设计避免了用户产生“我在上英语课”的抵触心理，将学习无缝嵌入到真实的工作流中，学习动机和留存率都会高得多。

为了实现这一点，技能对英文回复的“注解”做了精心的克制。它遵循“ 无过度标注 ”原则，确保注解文本（即括号内的同义词和翻译）不超过非代码文本总量的约10%。过多的注解会打断阅读的流畅性，让回复变得臃肿不堪，背离了“编码优先”的初衷。同时，它严格保证“ 代码块保持洁净 ”，所有注解只出现在自然语言描述部分，绝不会侵入到 ``` 包裹的代码示例中，这保证了代码的纯粹性和可复制性。

2.2 回复格式的四大增强特性

这个技能通过一套组合拳，将一段普通的英文技术回复，改造成了对日语开发者极度友好的学习材料。我们来逐一拆解它的四个核心特性：

1. 行内词汇注解 ：这是学习的核心。当回复中出现可能对中级英语学习者构成障碍的词汇时，技能会立即在其后附上注解，格式为 difficult-word (simpler synonym / 日本語) 。例如，“obscures (hides / 隠す)”。这种即时、情境化的词汇支持，比查字典高效十倍，因为你是在理解技术概念的同时记住了单词。
2. 加粗主要动词 ：英语句子的核心往往是动词。技能将每个句子的主要动词 加粗 ，就像给你的眼睛安装了导航，让你能快速抓住句子的主干和动作逻辑，理解“谁对谁做了什么”。这对于习惯日语语序（主-宾-谓）的开发者理解英语语序（主-谓-宾）特别有帮助。
3. 单句成行 ：技能将回复的每一个完整句子都单独放在一行。这个简单的排版改变极大地提升了可读性，避免了长段落带来的压迫感，让你可以逐句消化，降低了阅读认知负荷。
4. jp: 日文摘要 ：在回复的末尾，会有一个 --- 分隔线，下面跟着以 jp: 开头的简短日文总结。这个设计非常精妙，它被团队称为“ 无逃生舱口 ”。意思是，它只概括核心内容，而不是全文翻译。这迫使你必须去阅读和理解上面的英文正文， jp: 摘要只是作为一个安全网，用于最终确认你的理解没有跑偏，而不是让你直接跳过英文部分。

2.3 技能结构与工作流

从项目结构看，这是一个典型的、符合 Agent Skills 标准的技能包。它的核心指令存放在 skills/english-coaching/SKILL.md 文件中。当技能被激活时，Claude Code 会加载这个文件中的指令，这些指令详细规定了回复的格式、注解的规则以及词汇表的使用方式。

词汇表（ vocabulary.md ）很可能是一个精心整理的词库，包含了编程和技术文档中的高频难点词汇及其对应的简单同义词和日语翻译。技能在生成回复时，会实时查询这个词库，并应用上述的格式化规则。

整个工作流对用户而言是完全无感的：你像往常一样用日语（或英语）提问，Claude Code 在后台调用这个技能，生成增强版的英文回复，然后呈现给你。你不需要切换模式，不需要输入特殊命令，学习就在真实的编程对话中发生了。

注意 ：这种设计高度依赖于底层 AI 模型（如 Claude 3）强大的指令遵循和文本格式化能力。技能本身不包含复杂的 NLP 处理逻辑，它更像是一套写给 AI 的“排版和内容增强指南”。

3. 安装与配置全指南

english-coding-coach 提供了多种安装方式，以适应不同的使用环境和习惯。无论你是 Claude Code 的深度用户，还是喜欢命令行的高效玩家，都能找到适合自己的方法。

3.1 方案一：Claude Code 插件安装（推荐）

这是最直接、最用户友好的方式，特别适合主要在 Claude Code 界面内工作的开发者。

1. 打开 Claude Code ：确保你已经在使用 Claude Code 插件或应用。
2. 添加技能市场 ：在聊天输入框中，键入以下命令并回车：

   /plugin marketplace add enumura1/english-coding-coach
   

   这个命令会告诉 Claude Code，去添加一个由 enumura1 维护的特定技能市场源。这里的 enumura1/english-coding-coach 是一个符合 Agent Skills 标准的仓库标识符。
3. 安装技能 ：市场添加成功后，继续输入安装命令：

   /plugin install english-coding-coach
   

   此时，Claude Code 会从刚才添加的市场源中查找名为 english-coding-coach 的技能，并将其下载、安装到本地。

实操心得 ：使用 / 命令是 Claude Code 的内置功能，非常稳定。安装成功后，通常不需要重启 Claude Code，技能会自动生效。你可以在后续的对话中直接使用，无需手动激活。

3.2 方案二：使用 Skills CLI（通用方案）

如果你使用的 AI 编程代理（如 Cursor 的 AI 功能、或自建的 Codex 环境）也支持 Agent Skills 标准，但可能没有集成的图形界面，那么 Skills CLI 是你的最佳选择。这是一个基于 Node.js 的命令行工具。

1. 环境准备 ：确保你的系统已经安装了 Node.js （建议使用 LTS 版本）。你可以通过终端运行 node --version 来验证。
2. 一键安装技能 ：在终端中，进入你的项目目录（或任意目录），运行以下命令：

   npx skills add enumura1/english-coding-coach
   

   npx 是 Node.js 自带的包执行器，它会自动下载并运行 skills 这个命令行工具，然后将指定的技能添加到当前环境的技能库中。

注意事项 ：Skills CLI 需要知道你的 AI 代理的技能目录在哪里。通常，对于 Cursor 或 Claude Code，它会尝试检测默认的配置路径（如 ~/.cursor/skills/ 或 ./.claude/skills/ ）。如果安装失败，你可能需要查阅你所使用代理的文档，明确其技能目录位置，并通过环境变量或 CLI 参数指定。

3.3 方案三：手动复制（适用于高级用户或定制）

如果你希望完全控制技能的存放位置，或者想研究、修改技能的源代码，手动复制是最灵活的方式。

1. 克隆或下载仓库 ：访问项目的 GitHub 页面 ( https://github.com/enumura1/english-coding-coach )，将整个仓库克隆到本地，或直接下载 ZIP 包并解压。
2. 定位技能目录 ：在解压后的项目中，找到 skills/english-coaching/ 这个文件夹。这个文件夹里包含了技能的所有核心文件（ SKILL.md 和 references/ ）。
3. 复制到代理目录 ：找到你所用 AI 代理的技能存放目录。例如，对于 Claude Code，通常是项目根目录下的 .claude/skills/ 文件夹（如果不存在则需创建）。将 english-coaching/ 整个文件夹复制到 .claude/skills/ 目录下。
4. 验证 ：重启你的 AI 代理（如果需要），然后尝试用日语提问，检查回复是否带有词汇注解和日文摘要。

提示 ：手动安装方式在技能更新时需要你再次手动覆盖文件。而通过插件市场或 CLI 安装，通常可以通过相应的更新命令来升级技能。

4. 实战场景深度应用与效果分析

光看介绍可能感觉不够直观，我们结合几个真实的编程场景，看看 english-coding-coach 在实际工作中如何大显身手。我将通过对比普通英文回复和经过技能增强后的回复，来剖析其价值。

4.1 场景一：调试与根因分析

用户提问（日文） ： この関数がnullを返すんだけど原因わかる？ (这个函数返回null，知道原因吗？)

• 普通 AI 回复 ：

  The function returns null because the condition on line 12 doesn't handle empty arrays. When the array length is zero, it returns early. You should add a check or return a default value.

• English Coding Coach 增强回复 ：

  The function returns null because the conditional check on line 12 doesn't account for (fails to handle / 考慮していない) empty arrays. When items.length is zero, the early return triggers before the main logic executes .

  if (!items || items.length === 0) {
    return null; // ← this is the cause
  }
  

  You should replace this with a fallback (default value / デフォルト値) that returns an empty result instead of null.

  ---

  jp: items が空配列のとき早期リターンで null を返している。空の結果を返すように修正すべき。

效果分析 ：

• 学习点 ：用户学到了 doesn‘t account for 这个在代码评审中非常地道的表达，并通过注解 (fails to handle / 考慮していない) 立即理解了其含义。 fallback 这个词也通过 (default value / デフォルト値) 得到解释。
• 理解辅助 ：动词 returns , is , triggers , executes , replace 被加粗，让句子的动作逻辑一目了然。单句成行让技术解释层次分明。
• 安全感 ：日文摘要准确概括了“空数组导致返回null，应改为返回空结果”，让用户瞬间确认自己的理解无误，从而可以更自信地专注于英文正文的学习。

4.2 场景二：代码评审与最佳实践探讨

用户提问（日文） ： このAPIのエラーハンドリング、もっと良くできない？ (这个API的错误处理，能做得更好吗？)

• 普通 AI 回复 ：

  The error handling catches everything in one block, which is bad for debugging. You should differentiate between client and server errors. Throw specific errors for HTTP non-OK responses and catch them separately for better logging.

• English Coding Coach 增强回复 ：

  The current error handling catches all exceptions with a generic (general-purpose / 汎用的な) catch block. This obscures (hides / 隠す) the root cause and makes debugging harder.

  I‘d suggest we distinguish (separate / 区別する) between client errors and server errors: (代码示例略)

  This provides better observability (ability to monitor / 監視のしやすさ) and helps you pinpoint (identify exactly / 正確に特定する) issues in production.

  ---

  jp: 汎用catchを廃止し、クライアントエラーとサーバーエラーを分けてログ出力。本番でのデバッグが容易になる。

效果分析 ：

• 词汇升级 ： generic , obscures , distinguish , observability , pinpoint 这些都是技术设计和系统运维中的高阶词汇。通过即时注解，用户不仅解决了代码问题，还一次性掌握了多个关键术语。
• 概念传递 ： observability （可观测性）是 DevOps 中的重要概念，注解 (ability to monitor / 監視のしやすさ) 用简单的语言和日语翻译进行了完美诠释。
• 表达积累 ：用户学到了如何用英语提出建议（“I‘d suggest we...”）以及如何陈述好处（“This provides... and helps...”），这些句式和词汇可以直接用在英文邮件或文档写作中。

4.3 场景三：技术方案选型与决策

用户提问（日文） ： ページネーション実装したいんだけど、cursor方式とoffset方式どっちがいい？ (我想实现分页，游标方式和偏移方式哪个好？)

• 普通 AI 回复 ：

  It depends. Offset is simple but has consistency issues with changing data. Cursor is better for feeds with frequent updates but doesn‘t allow jumping to arbitrary pages. For your frequently updated feed, cursor is better.

• English Coding Coach 增强回复 ：

  It depends on your use case.

  Offset-based pagination is straightforward (simple / シンプル) to implement, but it suffers from (has problems with / 問題がある) data inconsistency when rows are inserted or deleted between requests.

  Cursor-based pagination eliminates (removes completely / 完全に解消する) that problem because each page is anchored to a specific record, not a numeric position.

  For your case — a feed with frequently (often / 頻繁に) updated content — cursor-based is the better fit. The trade-off (compromise / トレードオフ) is that users can‘t jump to an arbitrary (any chosen / 任意の) page number.

  ---

  jp: 更新頻度が高いフィードにはcursor方式が適切。offset方式はデータ追加削除時にずれが生じる。ただしページ番号ジャンプはできない。

效果分析 ：

• 技术写作范本 ：这段回复本身就是一篇微型技术对比文档。用户可以通过模仿其结构（总起 -> 分述A优缺点 -> 分述B优缺点 -> 结合场景给出建议 -> 指出权衡取舍）来提升自己的英文技术写作能力。
• 精准动词学习 ： suffers from , eliminates , is anchored to , can‘t jump to 这些动词短语非常生动准确，是技术描述中的利器。
• 高频术语掌握 ： trade-off （权衡）是架构决策中的核心概念， arbitrary （任意的）也是技术文档常用词。通过一次真实的方案咨询，用户就牢牢记住了它们。

通过以上三个场景可以看出，这个技能将一次普通的编程问答，变成了一次高质量的技术英语沉浸式学习。它提供的不是生硬的翻译，而是贴合语境的、可理解的输入，这正是语言习得理论中的“可理解性输入”原则，学习效率最高。

5. 自定义与高级玩法

虽然开箱即用的 english-coding-coach 已经非常强大，但如果你有特定的需求，比如想增加自己领域（如机器学习、区块链）的专业词汇，或者调整注解的频度，项目开放的结构也允许你进行自定义。

5.1 定制专属词汇表

技能的核心词汇定义在 references/vocabulary.md 文件中。如果你采用手动安装的方式，可以直接编辑这个文件。

1. 打开词汇表文件 ：找到你手动安装的技能目录下的 vocabulary.md 。
2. 理解格式 ：文件内容很可能是一个结构化的列表或映射，格式可能类似于：

   # Technical Vocabulary
   obscure: hide, 隠す
   distinguish: separate, 区別する
   trade-off: compromise, トレードオフ
   arbitrary: any chosen, 任意の
   # Programming Terms
   singleton: a single instance, シングルトン
   idempotent: same result if repeated, 冪等
   

   或者是更结构化的 YAML 或 JSON。
3. 添加你的词汇 ：你可以按照相同格式，添加你所在领域经常遇到但不太熟悉的英文术语。例如，如果你是数据工程师，可以添加：

   idempotent: producing the same result if repeated, 冪等
   idempotency: the property of being idempotent, 冪等性
   orchestration: automated arrangement of tasks, オーケストレーション
   

4. 生效 ：保存文件后，重启你的 AI 代理（或重新加载技能），新的词汇就应该在后续的回复中被注解了。

注意 ：修改词汇表后，技能的行为取决于 AI 代理如何缓存和加载这些数据。有些代理可能需要完全重启，有些则支持热重载。建议在修改后进行测试。

5.2 调整技能指令（面向开发者）

对于想要更深层次定制的开发者，可以研究 SKILL.md 文件。这个文件包含了给 AI 的完整指令集，定义了回复的格式、规则和逻辑。

• 调整注解比例 ：你可能会找到控制注解频率的指令，比如“保持注解在文本的10%以下”。如果你觉得注解太少或太多，可以尝试微调这个比例。但请注意，过度注解会破坏阅读体验。
• 修改格式样式 ：理论上，你可以修改加粗、分行、摘要前缀（ jp: ）等格式。但除非你有明确需求，否则不建议修改核心格式，因为这是经过精心设计的。
• 适配其他语言 ：这个项目的思路完全可以复用到其他语言对。例如，为中文开发者制作一个“中文编程教练”，将英文回复中的难词注解为中文。你需要创建一个新的技能，修改 SKILL.md 中的指令（将日语替换为目标语言），并构建一个对应的词汇表。

实操心得 ：在修改 SKILL.md 这类指令文件时，最好先备份原文件。指令的编写需要清晰、无歧义，并且符合所用 AI 模型的理解能力。修改后，务必通过大量的对话测试来验证效果，确保技能按预期工作。

6. 常见问题与排查技巧实录

在实际使用中，你可能会遇到一些小问题。下面是我根据经验总结的一些常见情况及解决方法。

6.1 技能安装后不生效

问题现象	可能原因	解决方案
用日语提问，回复仍是纯英文，无注解。	1. 技能未正确安装或启用。 2. Claude Code 未加载技能目录。 3. 提问方式触发了其他技能或默认行为。	1. 验证安装 ：在 Claude Code 中尝试运行 /plugin list ，查看 english-coding-coach 是否在列表中。 2. 检查路径 ：确认技能文件是否放在了正确的 .claude/skills/ 目录下（通常在项目根目录或用户主目录）。 3. 重启代理 ：完全关闭并重新打开 Claude Code。
回复有部分格式（如加粗），但没有词汇注解和日文摘要。	技能指令被部分加载，但词汇表或核心格式化规则未生效。	1. 检查词汇表文件 ：确保 references/vocabulary.md 文件存在且可读。 2. 重装技能 ：尝试先卸载 ( /plugin remove english-coding-coach )，再重新安装。
仅在特定项目/对话中生效。	Claude Code 的技能可能是按项目或对话会话加载的。	1. 项目级技能 ：确保技能安装在当前项目的 .claude/skills/ 下。 2. 全局技能 ：如果想在所有项目中使用，可能需要将技能安装到全局目录（如 ~/.claude/skills/ ），具体需查阅 Claude Code 文档。

6.2 注解效果不理想

问题现象	可能原因	解决方案与调整思路
注解太多，干扰阅读。	技能对“难点词汇”的判断阈值较低，或者词汇表太庞大。	1. 接受设计 ：10%的注解比例是经过权衡的，旨在平衡学习与效率。可以尝试适应。 2. 自定义词汇表 ：如果你认为某些词对你已不是难点，可以尝试从本地的 vocabulary.md 文件中移除它们（如果采用手动安装）。
有些想要的词没有被注解。	该词汇不在技能的预设词汇表中。	1. 手动添加 ：按照前述方法，将你希望被注解的词汇添加到自定义词汇表中。 2. 上下文学习 ：有时未被注解正是检验你词汇水平的机会，可以主动查阅记忆。
日文摘要不准确或太简略。	摘要由 AI 根据英文回复生成，可能偶尔会遗漏细节。	1. 以英文正文为准 ：牢记“无逃生舱口”原则，日文摘要仅是辅助。任何歧义应以英文原文和技术逻辑为准。 2. 追问 ：如果摘要让你困惑，可以直接用英文或日文追问：“Could you elaborate on the summary?” (要約について詳しく説明してもらえますか？)

6.3 与其他工具或技能的兼容性

场景	说明与建议
同时使用多个技能	Claude Code 可能支持同时激活多个技能。但技能之间的指令可能会相互干扰。如果 english-coding-coach 与其他技能（如代码风格检查、提交信息生成）同时使用时格式异常，可以尝试在对话中单独启用它。
在 Cursor 中使用	通过 Skills CLI ( npx skills add ) 安装后，需要确保 Cursor 的 AI 功能配置指向了正确的技能目录。这通常在 Cursor 的设置中完成。由于 Cursor 的 AI 底层可能与 Claude 不同，注解效果可能会有细微差异。
网络问题导致安装失败	使用 /plugin marketplace add 或 npx skills add 时，需要从 GitHub 等地址下载资源。确保你的网络环境能够正常访问。如果失败，手动安装是可靠的备选方案。

个人体会 ：这个技能的本质是一个“提示词工程”的优秀实践。它最大的价值在于设计理念，而非高深的技术。它巧妙地利用了现有大语言模型的指令遵循能力，创造了一个独特的学习场景。对于学习者，最重要的不是纠结于某个词是否被注解，而是养成 主动阅读英文技术内容、并利用注解作为脚手架 的习惯。随着时间的推移，你会发现自己查阅注解的频率越来越低，直接阅读和理解英文技术资料的能力却在稳步提升。这才是“沉浸式学习”最终要达到的目的。