该技能是面向仓库双语文档(英文↔简体中文)维护的工作流指导,而非翻译记忆库。两种语言地位平等,任一侧被修改后即作为该次更新的源。
适用触发场景:整篇文档翻译、批量新增对照版本,或按需求做配对审计。若只是小幅散文改动的一侧对照更新,加载仓库术语表后直接一趟完成即可,无需本技能。
按变更类型分流:配对已存在且一侧被编辑,走更新路径;尚无对照版本,走整篇文档路径;文档被删除或重命名,则同步删除或重命名对照文件及 .i18n.yaml 一致性记录。已归档冻结的笔记不属翻译范围。
更新路径以简报驱动:运行仓库的翻译简报脚本(无参数则覆盖所有失配配对),否则对已编辑侧与上次确认对照做 diff。仅有代码围栏内的机械性差异时,可用脚本带 apply 标志直接拼接并做结构校验,无需子代理。散文差异则把简报交给子代理处理,做覆盖差异的最小编辑,逐一对照源校验条款、术语与行内代码。
整篇路径用于新建对照:先阅读配对契约、翻译规则、术语表及 prose-standard 等真理来源,再整篇翻译,长文档按节推进并锁定结构;第一遍重述而非逐句搬移,第二遍逐子句校验,最后单独通读润色。术语必须按表渲染,未收录术语需有可引用先例或保留英文并加简短注释。代码块两语言间字节一致,相对链接保留 .md 目标,仅切换器行链接 .zh.md。
配对门禁检查标题层级、围栏块、表格行列数、列表类型与起始、列表项数量及链接目标。用 --list 可列出缺失、失配与正常状态;--write <pair> 重算并记录双方 blob 哈希,作为“确认两侧含义一致”的凭证。切换器格式:英文 H1 后接 English | 中文,中文 H1 后接 English | 中文;AGENTS.md 与 SKILL.md 不设对照。
变更前应确认涉及的配对通过作用域检查,仓库级文档门禁每次变更运行一次,不在单个翻译任务内运行。回应翻译评审时,术语相关意见应落到术语表而非单个文件。