Skill 中译 — 英文技能文档翻译
概述
本技能用于将英文的 WorkBuddy 技能文件（SKILL.md 及其相关资源）翻译为简体中文。核心目标是产出自然、准确、专业的中文技能文档，同时严格保留原始文件的结构、格式和可执行性。
适用场景
- 用户说「把这个技能翻译成中文」「翻译这个 SKILL.md」
- 用户说「把所有英文技能汉化」「批量翻译 skills」
- 用户指定某个技能目录，要求翻译其中的英文文档
- 用户安装了一个英文技能后想本地化成中文版本
翻译工作流
1. 确定翻译目标
首先确认用户想要翻译什么：
- 单个技能 — 用户指定了某个技能名或路径
- 多个技能 — 用户要求翻译多个或所有英文技能
- 特定文件 — 用户指向了某个具体的文件
若用户未指定，询问具体要翻译哪个技能。可以列出当前已安装的技能供用户选择。
2. 读取并分析源文件
读取目标 SKILL.md 文件，分析其结构：
- 确认 YAML frontmatter 的边界（
---包裹） - 识别所有代码块（
```包围）、行内代码（`包围） - 识别 URL 链接、文件路径、命令示例
- 识别表格结构
- 注意已有的
agent_created等保留字段
3. 执行翻译
按以下规则逐部分翻译：
YAML Frontmatter 翻译规则
- 保留的键名（不翻译）:
name,description,agent_created,model,read_when,summary,title,tags,version - 翻译的值:
description字段的值需要翻译为中文 - 保留原始结构: 缩进、换行、
>/|块标量符号保持不变 - 若 description 中包含触发关键词（如文件名、命令），保留英文原文并附加中文说明
Markdown 正文翻译规则
必须翻译的内容：
- 标题和段落文字
- 列表项的文字内容
- 表格中的文字内容（非代码部分）
- 说明性的注释文字
必须保留不译的内容：
- 代码块（``` 包围的内容）—— 完全不翻译
- 行内代码（` 包围的内容）—— 完全不翻译
- URL 链接 —— 保留原始 URL
- 文件路径 —— 如 scripts/init_skill.py、~/.workbuddy/skills/
- 命令行示例 —— 保留原样
- YAML/JSON 等配置示例 —— 保留原样
- 已公认的技术术语 —— 如 API、SDK、YAML、Markdown、frontmatter、CLI、CSS、HTML、JSON 等，保留英文
- 技能名称（name 字段值） —— 通常保留原始英文名称
技术术语处理
以下术语在翻译时可选择性处理：
| 策略 | 示例 |
|---|---|
| 保留英文 | API, SDK, CLI, YAML, Markdown, frontmatter, plugin, workflow |
| 中英对照（首次出现） | frontmatter（前置元数据）、skill（技能）、trigger（触发） |
| 直接翻译 | description → 描述、usage → 用法、overview → 概述 |
4. 写入翻译结果
翻译完成后，直接覆盖写入原文件（与原 SKILL.md 相同路径），除非用户指定了不同的输出路径。
写入前确认：
- YAML frontmatter 格式正确，--- 分隔符完整
- 所有代码块边界完整（``` 成对出现）
- 链接和路径未被破坏
- 翻译后的文字通顺自然
5. 批量翻译
当用户要求翻译多个技能时：
- 扫描
~/.workbuddy/skills/目录下所有子目录 - 检查每个目录的 SKILL.md 是否存在
- 识别其中的英文技能（通过分析 frontmatter description 的语言）
- 列出将要翻译的技能清单，请用户确认
- 逐个翻译，每完成一个就报告进度
翻译质量标准
翻译后的文档应满足：
- 准确性：忠实传达原文含义，不遗漏、不曲解
- 流畅性：符合简体中文的表达习惯，避免生硬的直译
- 专业性：技术术语使用业界通行译法
- 一致性：同一术语在全文中翻译一致
- 可读性：中文读者能无障碍理解技能的功能和用法
示例
翻译前（英文 frontmatter）
---
name: pdf-editor
description: >
Edit and manipulate PDF files. This skill should be used when the user
wants to rotate, merge, split, or extract text from PDF documents.
agent_created: true
---
翻译后（中文版本）
---
name: pdf-editor
description: >
编辑和处理 PDF 文件。当用户想要旋转、合并、拆分或提取 PDF 文档中的文本时，
应使用此技能。
agent_created: true
---
```
