用途：维护 DeepSeek Harness 文档的中英配对（foo.md ↔ foo.zh.md），使两种语言保持一致且自然。两种语言地位对等，改动发生在哪一侧，该侧即为本次更新的源。
调用边界：仅当用户明确点名 dsh-translate-docs 时才运行；不得因普通文档工作、其他技能调用或推断出的翻译需求而加载。常规翻译遵循 docs/AGENTS.md 的一次性单遍规则。
按变更类型分流： 更新（配对已存在、一侧被编辑）：走更新路径，简报驱动、成本低，不读指导语料、不做 git 考古，只做最小对应改动；不要为应用更新而重译整篇。 新建配对：走整篇文档路径。 删除或重命名文档：同步删除或重命名对应文件及其 .i18n.yaml。 .agents/notes/archived/ 下冻结的 Agent Notes 不属于翻译工作，归档后不得更新或修复。
更新路径：用 pnpm run gen-translation-brief <配对中任一文件> 生成简报（无参数则覆盖所有不同步配对），简报给出最窄可安全对齐粒度上的改动、源侧 diff、各改动单元的已确认源文/当前源文/当前对应文本（含行号）、涉及的术语行与规则摘要。若改动全部位于两侧逐字节相同的代码围栏内，可用 pnpm run gen-translation-brief --apply <pair> 直接拼接并做结构校验。散文改动则把简报交给子代理翻译，子代理不重读指导语料、不重新推导 diff。改动范围取最小，逐句核对，术语按内联行，代码片段逐字保留。随后用 pnpm run verify-translation-pairing --write <pair> 记录，再运行 pnpm run verify-translation-pairing <pair> 校验；全库检查在 doc-sync/CI 中运行，不按次执行。
整篇路径（新建配对）：编排代理不亲自翻译，而是派生子代理。翻译前先读事实来源：docs/i18n/README.md（配对契约）、translation-rules.md（翻译规则）、terminology.md（双向约束的术语表，翻译前加载）、translation-prompt.md（自动流水线模板，本技能不渲染它）、dsh-prose-standard（散文标准）。翻译分两遍：第一遍按语义单元以母语技术作者口吻重写；第二遍逐句对照源文核验，确认无增无减、术语合规、代码片段逐字保留，再单独通读译文修正生硬表达，只把最终文本写入文件。术语按表渲染，未列术语需有可引用的中文开源/厂商先例，否则保留英文并列入「待定术语」。代码块两侧逐字节一致（含注释）；仓库内文档链接保持同一语义目标与查询/片段后缀，英文侧用 .md、中文侧用 .zh.md。配对门禁检查标题层级、围栏块、表格行列数、列表类型与起始、列表项数、链接语言与语义目标。
查找工作：pnpm run verify-translation-pairing --list 列出范围内文档的 missing / out-of-sync / ok；pnpm run gen-translation-brief 无参数打印所有不同步配对的简报；编辑配对文档的 PR 中，工作清单即 diff 本身。
收尾：中文文件 H1 后加 English | 中文，英文文件 H1 后加 English | 中文；用 --write 重算并记录 foo.i18n.yaml 中的分节哈希；普通文档无需 manifest 条目；PR 前受触配对在范围检查下为绿，pnpm run doc-sync 在 PR 级别运行一次。PR 中说明哪些配对是新建、哪些是最小更新，并突出列出「待定术语」。
限制：本技能是工作流指引而非翻译记忆；措辞判断由译者负责，术语不自由发挥；不得为应用更新而整篇重译；归档笔记不得改动。