前言¶
用通用大模型练中英文时，常见做法是口头要求「带拼音和翻译」。模型有时记得、有时漏掉，用户输入也不会被同样格式化，家长或老师很难拿同一段对话当跟读材料。下面介绍 SkillHub 上的 Bilingual Buddy：通过 SKILL.md 约束 Agent，让用户消息与 AI 回复都按「中文 → 拼音 → 英文 → IPA」四层展示，并约定何时可省略某一层。
这是什么¶
Bilingual Buddy 是一条面向对话场景的双语展示技能（当前包版本 v1.0.1）。作者在技能元数据中署名为 王教成 Wang Jiaocheng（波动几何）。
它不改变底层模型，只规定输出结构与交互规则：每条用户消息先镜像为四层对照，再给出同样结构的 AI 回复；默认始终四层齐全，仅在用户明确同意后省略拼音或 IPA 等层级，并说明可扩展到其他语言对。
在 SkillHub 社区中，该技能归类为 education，评分 99175，累计下载 461 次（数据来自任务线索，以 SkillHub 页面展示为准）。
官方入口：https://api.skillhub.cn/user_e02e04b8/bilingual-buddy
SkillHub 展示页：https://skillhub.cn/skills/bilingual-buddy
核心功能¶
四层对照与顺序¶
默认每一轮内容按以下顺序、空行分隔呈现：
- 中文原文
- 汉语拼音（含声调）
- 英文翻译
- 英文 IPA（技能要求采用 General American；与英式差异时需标注 BrE）
完整顺序为：中文 → 拼音 → 英文 → IPA。
用户输入镜像¶
规则写在 SKILL.md 中：必须先展示用户输入的四层对照，再写 AI 回复；不得跳过用户侧镜像。
结构示意：
【用户输入】
[中文原文]
[Pinyin]
[English translation]
[IPA transcription]
【AI 回复】
[中文原文]
[Pinyin]
[English translation]
[IPA transcription]
可选层级与首次提醒¶
- 默认：始终四层。
- 首次收到中文输入时，可提醒是否省略拼音；用户明确同意后，后续改为 中文 → 英文 → IPA（三层）。
- 首次收到英文输入时，可提醒是否省略 IPA；用户同意后，后续改为 英文 → 中文 → 拼音（三层）。
- 可提醒用户格式可扩展为中日、中法等多语对照；提醒本身不改变默认，只有用户明确肯定（如「好」「省掉」「同意」）才实际省略。
按内容切换版式¶
同一四层信息，技能允许按场景选用不同排版，例如：
- 词汇：词组一行，箭头串联各层
- 句子跟读：中文逐字/词附拼音
- 长段落：
【中文】/【拼音】/【英文】/【音标】四行对齐 - 日常聊天：保持对话感，仍附带四层
- 知识讲解：术语行内双语，正文用段落四层
质量与边界约束¶
技能要求拼音声调准确、中英文语义分段对齐、不为了格式牺牲自然表达；代码调试、以代码块或表格为主、或用户要求纯中文等场景应切回纯中文模式。
触发用语¶
安装并启用后，对话中出现例如 双语、bilingual、中英文对照、拼音、音标、教小孩英语、教中文、language learning、teach Chinese/English 等表述时，Agent 应按技能说明组织回复（完整列表见包内 SKILL.md 的 description 字段）。
安装与启用¶
Bilingual Buddy 遵循通用 SKILL.md 格式。经 skillhub CLI 检索，社区包标识为 @indiv-wangjiaocheng/bilingual-buddy（与部分 API 路径中的 user_e02e04b8 并存，以你使用的安装渠道为准）。
1. 准备 SkillHub CLI¶
若尚未安装，可先检查：
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 官方说明执行完整安装（节选）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
更完整的优先源与目录说明见：https://skillhub.cn/install/skillhub.md
2. 安装到当前 Agent 的 skills 目录¶
安装时必须用 --dir 指向当前客户端识别的 skills 目录，否则技能不会被加载。SkillHub 文档中的常见路径包括：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
在 Cursor 中的示例：
skillhub install bilingual-buddy --namespace indiv-wangjiaocheng --dir ~/.cursor/skills/
也可让 Agent 按安装文档自行拉取，提示词形式例如：
请根据 https://skillhub.cn/install/skillhub.md，安装 @indiv-wangjiaocheng/bilingual-buddy。
安装后需按你所用客户端的要求刷新或重启会话，使新技能生效。Cursor / Codex CLI / Claude Code 的差异主要体现在 skills 目录路径，安装命令本身相同。
典型用法¶
启用技能后，用自然语言发起双语练习即可。下面示例来自 SKILL.md 中的约定格式（用户说「试试看」）：
【用户输入】
试试看
Shìshi kàn
Let’s try / Let’s see
/lɛts traɪ/
【AI 回复】
好主意！你想从哪个话题开始？
Hǎo zhǔyì! Nǐ xiǎng cóng nǎge huàtí kāishǐ?
Great idea! Which topic would you like to start with?
/ɡreɪt aɪˈdiː! wɪtʃ ˈtɒpɪk wʊd juː laɪk tuː stɑːrt wɪð/
教学场景中，你也可以直接要求词汇卡片或段落对照；Agent 会按技能中的五种版式策略选用排版，但四层信息仍须齐全（在未约定省略层级的前提下）。
适用场景与注意¶
适合：
- 中英文学习与跟读
- 课堂或家庭双语教学、儿童启蒙
- 需要固定对照格式、减少「每次都要重复提示」的口语练习
注意：
- 输出质量依赖模型对拼音、翻译与 IPA 的生成能力；技能约束的是结构与流程，不保证语言学审校级准确。
- 写代码、查数据、大段表格或代码块场景应退出四层模式，避免干扰阅读。
- 若 CLI 安装失败，核对 namespace 是否为
indiv-wangjiaocheng，并确认--dir与当前 Agent 一致。
结尾¶
Bilingual Buddy 把「用户说什么、AI 答什么」都压进同一套四层对照模板，并区分默认展示与经用户确认后的层级精简，适合需要可重复双语对话格式的教学场景。包内逻辑集中在一份 SKILL.md，便于审阅与二次修改。
