| name | skill-translator-zh |
| description | 将英文编写的skill翻译成中文版本。当用户需要将现有的英文skill（包括SKILL.md和相关文档）翻译成中文，同时保持核心内容、代码、路径、技术细节不变时使用此skill。适用于创建skill的中文本地化版本。 |
Skill Translator (中文翻译)
概述
此skill用于将英文编写的skill翻译成中文版本，确保中文版本保持原有skill的结构、功能和技术准确性。
翻译工作流程
1. 理解原始Skill
首先阅读并理解待翻译的skill：
- 阅读SKILL.md的frontmatter和body
- 了解skill的目的、工作流程和核心功能
- 查看所有bundled resources（scripts/、references/、assets/）
- 识别哪些内容需要翻译，哪些需要保持原样
2. 创建翻译后的Skill目录
使用skill-creator的init_skill.py创建新的skill目录：
python3 skills/skill-creator/scripts/init_skill.py <原skill名>-zh --path skills
例如，翻译pdfskill时：
python3 skills/skill-creator/scripts/init_skill.py pdf-zh --path skills
3. 翻译SKILL.md
按照以下原则翻译SKILL.md：
Frontmatter翻译：
name: 保持原样或添加-zh后缀description: 完整翻译成中文，确保保留所有触发条件和使用场景
Body翻译：
- 标题和说明文字翻译成中文
- 保持markdown结构和格式不变
- 技术术语根据上下文决定是否翻译（参见下方"翻译原则"）
4. 处理Bundled Resources
根据文件类型采取不同策略：
scripts/ 目录：
- 代码文件（.py, .sh, .js等）：保持代码不变
- 可翻译代码注释和docstring为中文
- 文件名通常保持英文
references/ 目录：
- Markdown文档：翻译所有说明性文字
- 保持代码示例、配置文件、JSON/YAML示例不变
- 保持文件名或添加
-zh后缀
assets/ 目录：
5. 验证和打包
翻译完成后：
- 检查所有链接和引用是否正确
- 确保代码示例可运行
- 验证markdown格式
- 使用package_skill.py打包：
python3 skills/skill-creator/scripts/package_skill.py skills/<skill名>-zh
翻译原则
需要翻译的内容
✅ 必须翻译：
- 标题、章节名称
- 说明性文字、描述、解释
- 工作流程步骤
- 用户指南和教程
- 注释和文档字符串
保持原样的内容
❌ 不要翻译：
- 代码（Python, JavaScript, Bash等）
- 文件路径和文件名
- 命令行指令
- 变量名、函数名、类名
- API端点和URL
- 正则表达式
- 配置文件内容（JSON, YAML, XML等）
- 包名和导入语句
技术术语处理
⚖️ 根据情况处理：
保持英文的术语：
- 广泛使用的技术术语：API, JSON, XML, PDF, DOCX, HTML, CSS, Git
- 编程概念：frontend, backend, middleware, webhook
- 工具和框架名：React, Vue, Django, Flask
- 文件格式：.md, .py, .json, .yaml
可以翻译的术语：
- 一般概念：文档(document)、表格(table)、文件(file)
- 操作动词：创建(create)、编辑(edit)、删除(delete)
- 通用术语：用户(user)、数据(data)、配置(configuration)
混合使用（推荐）：
- 首次提及时使用"中文(English)"格式
- 后续使用中文或英文，保持一致性
- 示例："前端(frontend)"、"应用程序接口(API)"
格式和结构保持
- 保持原有的markdown结构
- 保持代码块的缩进和格式
- 保持列表、表格的对齐
- 保持链接引用的正确性
- 保持frontmatter的YAML格式
语言风格
- 使用简洁、专业的中文
- 避免过度直译，注重可读性
- 保持技术准确性
- 使用祈使句（命令式）描述步骤
- 保持与原文相同的语气（正式/非正式）
翻译示例
示例1：标题和描述
原文：
## Quick Start
To extract text from a PDF, use pdfplumber:
译文：
## 快速开始
要从PDF中提取文本，使用pdfplumber：
示例2：代码和注释
原文：
import pdfplumber
with pdfplumber.open('document.pdf') as pdf:
text = pdf.pages[0].extract_text()
译文：
import pdfplumber
with pdfplumber.open('document.pdf') as pdf:
text = pdf.pages[0].extract_text()
示例3：技术术语混合
原文：
Use the API endpoint to fetch user data from the database.
译文：
使用API端点从数据库中获取用户数据。
或
使用API端点(API endpoint)从数据库中获取用户数据。
质量检查清单
翻译完成后，检查以下项目：
参考资源
详细的翻译指南和示例请参见：
references/translation-guidelines.md - 完整的翻译指南和常见术语对照表
