Agent Skills › areal-project/AReaL › translate-doc-zh

translate-doc-zh

GitHub

将 docs/en/ 下的英文 Markdown 文档翻译至 docs/zh/。支持校验路径、自动解析目标路径及创建目录。智能判断全量翻译或增量更新，保留技术术语、代码块及 Markdown 结构，确保专业且简洁的中文表达。

.agents/skills/translate-doc-zh/SKILL.md areal-project/AReaL

触发场景

用户请求将英文文档翻译成中文用户指定 docs/en/ 下的文件进行本地化

安装

npx skills add areal-project/AReaL --skill translate-doc-zh -g -y

更多选项

非标准路径

npx skills add https://github.com/areal-project/AReaL/tree/main/.agents/skills/translate-doc-zh -g -y

不安装直接使用

npx skills use areal-project/AReaL@translate-doc-zh

指定 Agent (Claude Code)

npx skills add areal-project/AReaL --skill translate-doc-zh -a claude-code -g -y

安装 repo 全部 skill

npx skills add areal-project/AReaL --all -g -y

预览 repo 内 skill

npx skills add areal-project/AReaL --list

SKILL.md

Frontmatter

{
    "name": "translate-doc-zh",
    "description": "Translate an English document under `docs\/en\/` into the matching Chinese document under `docs\/zh\/`."
}

Translate Docs EN to ZH

Use this skill when the user asks to translate a document from docs/en/ to docs/zh/.

Input

A markdown file path under docs/en/

Workflow

Step 1: Validate the source path

Confirm the file exists.
Confirm it is under docs/en/.
Confirm it ends with .md.
If any check fails, stop and ask the user for a valid docs/en/...md path.

Step 2: Resolve the target path

Source: docs/en/<path>.md
Target: docs/zh/<path>.md

Step 3: Choose translation mode

If the Chinese file already exists, update only the changed parts while preserving the rest.
If the Chinese file does not exist, translate the full document.

Translation Rules

Preserve technical terms such as FSDP, FSDP2, GRPO, PPO, DAPO, MoE, LLM, RL, RLVR, Codex, Claude Code, OpenCode, Megatron, Archon, SGLang, vLLM, PyTorch, HuggingFace, and Transformers.
Do not translate file paths, code blocks, CLI flags, or literal configuration keys.
Preserve Markdown structure, tables, and fenced code blocks.
Use concise, professional Chinese terminology.

Error Handling

If the target directory does not exist, create it before writing the translated file.
If the source document is partially translated already, preserve sections that do not need updates.