skill-to-cn

SKILL.md

---
name: skill-to-cn
description: 将任意技能汉化为中文版本。当用户要求"汉化技能"、"翻译技能"、"把XX技能翻译成中文"、"创建技能的中文版"时触发。输入原始技能路径（如 ~/.claude/skills/X/），输出汉化后的技能目录（~/.claude/skills/X-cn/）。
---

# 技能汉化器

将任意 Claude Code 技能翻译为中文版本。

## 核心职责

**重要**：本技能的完整工作流程包含两个阶段：
1. **脚本阶段**：运行翻译脚本，生成标记 `[待翻译]` 的骨架文件
2. **模型阶段**：Claude 必须读取骨架文件，完成所有 `[待翻译]` 内容的实际翻译

最终输出的必须是**已完成翻译的中文技能**，而非标记状态的中间产物。

## 工作流程

汉化技能涉及以下步骤：

1. 确认源技能路径（默认 ~/.claude/skills/<技能名>/）
2. 读取并分析源技能结构
3. 运行翻译脚本，生成目标目录骨架
4. **Claude 读取并翻译所有标记内容**
5. 输出完整翻译后的技能文件
6. 验证汉化结果

## 执行汉化

### 第一步：运行脚本生成骨架

运行汉化脚本生成带标记的骨架文件：

```bash
python3 ~/.claude/skills/skill-to-cn/scripts/translate_skill.py <源技能名>
```

示例：
```bash
# 汉化 pdf-editor 技能
python3 ~/.claude/skills/skill-to-cn/scripts/translate_skill.py pdf-editor

# 指定完整路径
python3 ~/.claude/skills/skill-to-cn/scripts/translate_skill.py /path/to/skill --output /custom/output
```

脚本会创建目标目录并标记所有需要翻译的内容。

### 第二步：Claude 完成翻译

**这是关键步骤，必须由 Claude 执行：**

1. 读取生成的目标目录中的所有文件
2. 找到所有 `[待翻译]` 标记的内容
3. 将标记内容翻译为中文，并**移除 `[待翻译]` 标记**
4. 将翻译后的内容写回文件

翻译时遵循以下原则：
- 保留代码块、命令、文件路径不翻译
- 保留 Markdown 格式标记
- 技术术语可保留英文或使用通用译名
- 专有名词（API 名称、库名、命令名等）保持原文
- 确保翻译后的内容流畅自然

**产出物语言设定**：在汉化过程中，需要在 SKILL.md 中明确指定输出语言为中文（除非原文另有要求）。这确保汉化后的技能执行时，其产出物默认使用中文：
- 文档和说明使用中文
- 代码注释使用中文
- 程序输出和提示信息使用中文
- 专有名词保持原文

### 第三步：验证输出

确认所有文件已完成翻译，无残留的 `[待翻译]` 标记。

## 手动汉化指南

如需手动汉化，遵循以下规则：

### YAML 元数据翻译

```yaml
# 原文
---
name: pdf-editor
description: Professional PDF editing toolkit for merging, splitting, and rotating PDFs. Use when user asks to "merge PDFs", "split PDF", or "rotate PDF".
---

# 译文
---
name: pdf-editor-cn
description: 专业 PDF 编辑工具包，支持合并、拆分和旋转 PDF。当用户要求"合并 PDF"、"拆分 PDF"、"旋转 PDF"时使用。
---
```

### 正文翻译原则

1. **保留代码块**：代码示例和命令不翻译
2. **保留文件路径**：路径、URL、技术术语保持原样
3. **翻译描述性文本**：说明、指导、步骤描述等
4. **保留格式标记**：Markdown 语法不变
5. **技术术语处理**：
   - 常见术语保留英文或使用通用译名
   - 首次出现可标注英文原文
6. **专有名词保留**：文档中的专有名词（如 API 名称、库名、命令名等）保持原文不翻译

### 产出物语言要求

**核心原则**：汉化后的技能执行时，其产出物应以中文为默认语言。

具体规则如下：

| 场景 | 处理方式 |
|------|---------|
| 原文未指定语言 | 产出物使用中文 |
| 原文要求英文输出 | 保持英文（尊重原文要求） |
| 原文要求其他语言 | 保持该语言（尊重原文要求） |
| 文档中的专有名词 | 保持原文不翻译 |
| 代码注释 | 翻译为中文 |
| 代码输出/提示信息 | 翻译为中文 |
| 代码变量名/函数名 | 保持原文 |

**实施方法**：在汉化 SKILL.md 时，应在技能说明中添加以下内容（如适用）：

```markdown
## 输出语言

本技能的输出内容默认使用中文。除非用户明确要求其他语言，否则：
- 文档和说明使用中文
- 代码注释使用中文
- 程序输出和提示信息使用中文
- 专有名词（API 名称、库名等）保持原文
```

### 文件处理

| 文件类型 | 处理方式 |
|---------|---------|
| SKILL.md | 翻译元数据和正文，添加"输出语言"说明（指定中文为默认） |
| README.md | 翻译为 README-cn.md（仅当目标目录不存在 README-cn.md 时） |
| scripts/* (任意语言) | 翻译注释和输出内容为中文，保留代码逻辑和变量名 |
| scripts/* (二进制文件) | 直接复制，不翻译 |
| references/*.md | 翻译全部内容，专有名词保持原文 |
| references/* (二进制文件) | 直接复制，不翻译 |
| assets/* | 直接复制（图片、模板等） |
| 根目录其他文件 | 直接复制（如 LICENSE.txt 等） |

### 二进制文件检测

脚本会自动检测以下类型的二进制文件并直接复制：

- **图片**：.png, .jpg, .gif, .ico, .webp, .svg 等
- **音频**：.mp3, .wav, .ogg, .flac 等
- **视频**：.mp4, .avi, .mkv, .mov 等
- **压缩包**：.zip, .tar, .gz, .rar, .7z 等
- **可执行文件**：.exe, .dll, .so, .dylib 等
- **字体**：.ttf, .otf, .woff, .woff2 等
- **PDF 和文档**：.pdf, .doc, .docx, .xls, .xlsx 等
- **其他**：.bin, .dat, .pyc, .jar 等

此外，脚本还会通过检测文件内容中的空字节（\x00）来识别未知的二进制文件格式。

### 支持的代码语言

脚本文件支持以下语言的注释翻译：

| 注释风格 | 支持的语言 |
|---------|-----------|
| `#` 单行注释 | Python, Shell, Ruby, YAML, TOML, R, Perl 等 |
| `//` 和 `/* */` | JavaScript, TypeScript, Java, C, C++, Go, Rust, Swift, Kotlin, Scala, C#, PHP 等 |
| `<!-- -->` | HTML, XML, Vue, Svelte 等 |
| `/* */` | CSS, SCSS, LESS 等 |

## 输出结构

汉化后的技能目录：

```
~/.claude/skills/<技能名>-cn/
├── SKILL.md          # 已翻译
├── README-cn.md      # README.md 的中文翻译（如源目录存在 README.md）
├── scripts/          # 注释已翻译
├── references/       # 已翻译（如存在）
├── assets/           # 原样复制（如存在）
└── <其他文件>        # 原样复制（如 LICENSE.txt）
```

## 完整汉化示例

假设用户要求汉化 `pdf-editor` 技能：

**用户**：请汉化 pdf-editor 技能

**Claude 执行流程**：

```
1. 运行脚本：
   python3 ~/.claude/skills/skill-to-cn/scripts/translate_skill.py pdf-editor

2. 脚本输出骨架文件，内容类似：
   ---
   name: pdf-editor-cn
   description: [待翻译] Professional PDF editing toolkit...
   ---
   [待翻译] # PDF Editor
   [待翻译] A professional toolkit for PDF operations.

3. Claude 读取骨架文件，翻译并写入最终内容：
   ---
   name: pdf-editor-cn
   description: 专业 PDF 编辑工具包，支持合并、拆分和旋转 PDF...
   ---
   # PDF 编辑器
   专业 PDF 操作工具包。

4. 确认所有文件已翻译完成，无 [待翻译] 残留
```

**最终输出**：完整可用的中文版技能，用户可直接使用。