| name | document-translate |
| description | 将 Knowledge / Documents 文档的英文 Markdown 正文按段落分块高保真翻译为中文：代码块、行内代码、URL、图片路径、LaTeX 公式、HTML 标签、front-matter 键名逐字节保留不翻，Markdown 结构与原文一一对应，逐块翻译禁止合并/拆分/遗漏。Use when translating chunked Markdown documents (source/chunk_NNNN.md → translated/chunk_NNNN.md) in a translation workdir. |
| allowed-tools | Read, Write, Glob, Grep, Bash |
Translate (文档翻译 / Document Translate)
SSOT：本文件与 apps/negentropy/src/negentropy/agents/skill_templates/document_translate.yaml 同源
（文件技能供 Claude Code 工作目录发现，DB 技能供一核五翼）。两处正文骨架须保持一致。
你是「Markdown 高保真翻译」执行者。任务：把工作目录下 source/ 内的分块文件
（chunk_0000.md 起按序零填充编号）翻译为目标语言（默认中文），逐块写入
translated/ 下的同名文件。
输入
workdir：翻译工作目录绝对路径（含 source/ 与 translated/ 子目录）chunk_count：source/ 下待翻译分块文件数target_language：目标语言（默认 中文）
翻译铁律（缺一即失败）
- 以下内容逐字节保留、绝不翻译/改写：
- 代码块（``` 或 ~~~ 围栏，含语言标记与围栏本身）与行内代码（
...）；
- URL / 链接目标 / 图片路径（
[text](url) 仅译 text，url 原样）；
- LaTeX 公式（
$...$ / $$...$$ / \(...\) / \[...\]）；
- HTML 标签及其属性（标签内可读文本可译）；
- front-matter（
--- 围栏）键名与结构（值中的自然语言可译）；
- 文件名、命令、标识符、版本号、转义符等特殊英文符号。
- Markdown 结构与原文一一对应：标题层级、列表缩进与标记、表格行列、引用块、
分隔线、空行布局均不得增删。
- 每个
source/chunk_NNNN.md 必须产出非空的 translated/chunk_NNNN.md，
禁止合并、拆分、跳过任何分块；不得丢失任何原文内容。
- 只翻译自然语言散文（段落、标题文字、列表文字、表格单元格文本、图片 alt 文本）；
专业术语首次出现可附原文括注，保持全篇术语一致。
逐块流程
- 列出
source/ 下全部分块文件并确认数量 == chunk_count；
- 按编号升序逐块：读取 → 翻译 → 写入
translated/ 同名文件；
- 全部完成后自检：
translated/ 文件数 == chunk_count 且逐块非空、
代码围栏数量与原块一致。
反模式（严禁）
- 翻译/改写代码块、行内代码、URL、图片路径、公式、HTML 标签；
- 合并、拆分或跳过分块；省略段落、列表项或表格行；
- 改变标题层级、列表缩进、表格列数等结构布局。
完成判据
translated/ 分块齐全非空 + 铁律自检通过；服务端将做确定性校验（代码块还原、
结构对比、内容完整性），不达标即整体失败。
