前言¶
出差或长期待在方言区，听懂几句当地话往往比背一本通用短语表更管用；和说方言的朋友、家人日常聊天时，若只能回普通话，距离感也很难消掉。通用大模型能泛泛讲方言，但缺少统一的触发条件、输出格式和边界说明，对话容易跑偏到外语学习、实时翻译或语音识别。
下面介绍 SkillHub 社区技能「方言学习助手」（@user_70c2f807/dialect-learning-assistant）。它用标准 SKILL.md 约束 Agent：在用户提到学方言、方言翻译等意图时，按场景给出谐音标注、俚语解释和文化背景，并明确不能做什么。
这是什么¶
「方言学习助手」是面向 中国方言入门学习 的 Agent Skill，由社区发布者 user_70c2f807 维护，当前版本 1.0.0，分类为 education，来源为 community。SkillHub 页面标注 requires_api_key=false，安装后无需额外 API Key。
技能定位：提供各地方言常用句的谐音标注与场景对话，帮助用户掌握基础表达，缓解「听不懂、不会接话」的沟通障碍。它不适用于外语学习、通用翻译服务、语音识别或普通话培训（技能内 NOT for 条款已写明）。
官方入口：
- SkillHub 展示页：https://www.skillhub.cn/skills/user_70c2f807/dialect-learning-assistant
- 资源坐标：https://api.skillhub.cn/user_70c2f807/dialect-learning-assistant
截至资料抓取时，SkillHub 显示评分约 100000、下载 815 次（安装计数以页面为准）。
核心功能¶
以下能力均来自技能包内 SKILL.md，Agent 按文档执行。
触发与范围
- 适用：用户提到「方言学习」「学方言」「方言翻译」、
dialect learning、local language，或要求学习某种中国方言。 - 不适用：外语学习、翻译服务、语音识别、普通话培训。
教学内容
- 常用方言句子的谐音发音标注（辅以拼音/声调说明）。
- 按场景组织内容：日常、工作、恋爱、美食等。
- 解释俚语含义、文化背景及使用禁忌。
- 同一句话在多方言下的对照。
- 方言文化小知识、常见误解纠正。
执行流程（Agent 侧）
- 确认学习目标：方言种类、用途（出差/交友/兴趣）、当前水平。
- 场景化教学：按场景组句，标注谐音与声调，补充文化说明。
- 输出学习材料：基础句清单、发音技巧、可配合使用的学习资源建议。
输出形态
技能要求以结构化 Markdown 呈现，包含场景、难度、普通话—方言—谐音对照表、发音技巧、文化小知识与资源推荐等模块（模板见官方 SKILL.md「输出格式」一节）。
安装与启用¶
先做环境检查，再把技能装进当前 Agent 的 skills 目录。
1. 检查 SkillHub CLI
command -v skillhub && skillhub --version
未安装时可按 SkillHub 官方说明执行（完整安装含 CLI 与默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅 CLI：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2. 安装本技能
安装时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 可能不会被识别。本技能坐标为 @user_70c2f807/dialect-learning-assistant。
skillhub install dialect-learning-assistant --namespace user_70c2f807 --dir <你的 skills 目录>
常见客户端 skills 路径（来自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
3. 通过对话让 AI 安装
SkillHub 页面提供的提示词为：请 Agent 根据 https://skillhub.cn/install/skillhub.md 安装 @user_70c2f807/dialect-learning-assistant。与手动 CLI 安装等价，仍以 --dir 指向正确目录为准。
经过上面的步骤，重启或刷新 Agent 后即可在对话中触发技能描述中的关键词。
典型用法¶
下列示例摘自官方 SKILL.md「快速开始」，可在安装后直接复现。
用户：教我几句粤语
→ Agent 提供日常用语的粤语表达与谐音，并说明使用场景
用户：四川话的「巴适」是什么意思？
→ 解释含义、用法、语境，并附相关俚语
用户：出差去上海，教我几句上海话
→ 按打招呼、打车、吃饭等场景给出实用表达
用户：我想学闽南语表白
→ 提供浪漫向表达及发音标注
用户：东北话有哪些有趣的表达？
→ 整理特色词汇与用法
技能 FAQ 中还说明：可粘贴方言歌词或影视台词，请 Agent 译成普通话并解释；长篇学术级方言研究、实时对话翻译仍不在范围内。
适用场景与注意¶
适合谁
- 短期出差、旅居方言区，需要「能听懂、能接一两句」的入门者。
- 与粤语、闽南语、上海话、四川话、东北话等大方言区用户日常交流的学习者。
- 希望按场景（工作、恋爱、美食）系统整理表达，而非零散问一个词的用户。
限制与坑（技能要求 Agent 提前告知用户）
| 限制 | 说明 |
|---|---|
| 无真人发音 | 仅文字谐音与拼音注释，需配合音频或视频 App |
| 覆盖范围 | 以常用大方言区为主，村镇口音差异大 |
| 标准音取向 | 同一方言各地区发音不同，以主流标准音为主 |
| 入门定位 | 不能替代大量听力输入与实际交流 |
| 边界场景 | 不处理音频识别、外语学习、专业方言学研究、实时翻译 |
异常处理上，技能对「方言不明确」「极小众方言」「脏话请求」等场景给出了固定引导话术；用户若期望完美发音或覆盖所有村镇变体，容易与技能设计目标不符。
结尾¶
「方言学习助手」把中国方言学习的触发词、教学步骤、输出模板和边界写进 SKILL.md，让 Agent 在 education 类对话里稳定产出场景化谐音材料，而不是泛聊语言话题。无需 API Key，通过 SkillHub CLI 或官方安装文档即可装入 Cursor、Claude Code、Codex 等环境的 skills 目录。
更多信息与安装入口：https://www.skillhub.cn/skills/user_70c2f807/dialect-learning-assistant
