前言¶
在对话里改文档、整理多语言素材时，常见做法是反复打开翻译网站，或自己写脚本调 API。前者打断工作流，后者要维护密钥和语言代码。若希望 Agent 在用户说「翻译」「translate」时自动走同一套流程——单条、批量、自动识别语种、可选 API 或模型翻译——可以把 Skill 装进当前客户端，用自然语言触发即可。
下面介绍 SkillHub 社区技能「常见语言翻译」（坐标 @user_d39ac014/translate-2）的定位、能力与安装方式。
这是什么¶
「常见语言翻译」是面向办公效率（SkillHub 分类 office-efficiency）的 Agent Skill，由社区发布者 user_d39ac014 维护，当前 SkillHub 页面标注版本为 1.0.0，来源为 community。技能标签标明 requires_api_key=false：不配置第三方翻译 API 时，也可依赖 Agent 侧 AI 翻译完成请求。
一句话定位：在 15+ 种语言之间做高准确度文本翻译，支持单条与批量、自动语种检测、多种翻译路径（API / AI）以及多种输出格式；适用于翻译、语种转换与多语言文本处理。官方简介中的触发词包括：翻译、translate、翻译成、translation、language exchange。
- SkillHub 页面：https://www.skillhub.cn/skills/user_d39ac014/translate-2
- API 坐标页：https://api.skillhub.cn/user_d39ac014/translate-2
核心功能¶
以下能力均来自技能包内 SKILL.md 与配套脚本说明，与商店简介一致。
- 单条翻译：用户给出待译文本与目标语言，返回译文。
- 批量翻译：一次处理多条内容（列表、多行文本等），适合术语表或短句清单。
- 自动语种检测：未指定源语言时，由技能逻辑识别后再翻译。
- 多种翻译方式：优先尝试已配置的 API 翻译；失败或未配置时回退到 Agent（文档中写作 Claude）AI 翻译。
- 输出格式：支持仅译文、带原文对照、以及含源语言、目标语言、翻译方式等字段的详细格式。
技能文档列出的支持语言（15+）及代码示例如下：
| 语言 | Code |
|---|---|
| 中文（简体） | zh |
| 中文（繁体） | zh-TW |
| English | en |
| 日本語 | ja |
| 한국어 | ko |
| Русский | ru |
| العربية | ar |
| Français | fr |
| Deutsch | de |
| Español | es |
| Italiano | it |
| Português | pt |
| ไทย | th |
| Tiếng Việt | vi |
| हिन्दी | hi |
自动检测说明中额外提到可识别：zh、en、ja、ko、ru、ar、fr、de、es 等常用语种。
可选 API 配置（非必须）：Google Cloud Translate、DeepL、LibreTranslate；未配置时文档明确说明由 AI 翻译兜底。
安装与启用¶
1. 安装 SkillHub CLI¶
若本机尚未安装，可先检查版本：
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 官方安装文档执行完整安装（节选）：
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
安装说明全文：https://skillhub.cn/install/skillhub.md
2. 安装本技能¶
安装时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 可能不会被客户端加载。
skillhub install @user_d39ac014/translate-2 --dir <skills 目录>
各客户端常见路径（来自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
也可将官方页面给出的提示词发给 Agent，让其按 https://skillhub.cn/install/skillhub.md 安装 @user_d39ac014/translate-2。
安装后按所用客户端要求重启或刷新技能列表，使 SKILL.md 被加载。
3. 可选：命令行脚本¶
技能包内含 scripts/translate.py，用于在终端做单条或批量翻译（需 Python 3）。示例：
# 单条
python scripts/translate.py --text "Hello" --target zh
# 批量（文件每行一条）
python scripts/translate.py --batch --file input.txt --target ja
# 指定源语言
python scripts/translate.py --text "Bonjour" --source fr --target en
若使用 Google、DeepL 或 LibreTranslate，需在脚本或环境变量中按 SKILL.md「API Configuration」一节配置对应服务；不配置时脚本会走回退逻辑，由 Agent 完成翻译。
典型用法¶
技能设计为自然语言驱动。Agent 按文档中的四步工作流处理：识别翻译意图 → 解析文本与语种 → 执行翻译（API 优先、AI 兜底）→ 按用户偏好格式化输出。
单条翻译¶
把「你好世界」翻译成英文
预期输出形态之一：Hello World（或技能定义的「带原文」格式）。
批量翻译¶
把以下内容翻译成日文：
苹果
香蕉
橙子
文档示例输出为逐条对照的日文结果。
自动检测源语言¶
Translate: Bonjour le monde
未指定源语言时，先识别为法语再给出英文等目标语译文（用户可在同一句中写明目标语言）。
触发方式¶
除「翻译 / translate」外，文档还列出例如「用 XX 语怎么说」「How do you say X in XX」「convert to XX」等表述，便于在写文档、改 commit message、整理多语言 README 时直接口述需求。
适用场景与注意¶
适合谁
- 经常在 Agent 会话里处理中英日韩等多语言文案的开发者或运营。
- 希望批量翻短句、术语表，又不想每次切出浏览器的人。
- 已具备 SkillHub CLI、希望在 Cursor / Claude Code 等环境统一安装社区 Skill 的团队。
限制与注意
- 商店数据：SkillHub 页面显示评分 100000、下载 1083、安装 0；以上为页面统计，会随时间变化，写作时请以官网为准。
- API 与准确度：文档对主要语种标注「高」准确度，其余为「中」，并说明 AI 回退可保证有结果；专业法律、医学译稿仍需人工审校。
- 批量格式：文档建议用列表或分行书写，避免把多条内容粘成一行，以免解析不清。
- 版本信息：商店标注 v1.0.0；技能包内
SKILL.md的 Version History 另有迭代记录，若行为与说明不一致，以你本地安装包内的SKILL.md为准。 - 无需 API Key 的含义：指标签与文档均指 AI 路径可用；若要走 Google / DeepL 等，仍需自行申请密钥并配置。
结尾¶
「常见语言翻译」把单条、批量、语种检测和多种输出格式收进一个 Skill，在 SkillHub 上标记为无需 API Key 即可启用 AI 翻译路径，适合作为 Agent 里的默认翻译工作流。安装时记住坐标 @user_d39ac014/translate-2 与 --dir 指向正确的 skills 目录。
- SkillHub：https://www.skillhub.cn/skills/user_d39ac014/translate-2
- 坐标 API 页：https://api.skillhub.cn/user_d39ac014/translate-2
