多语文档生成

解决什么问题

维护多语言 README 最常见的问题是：结构漂移、链接失效、代码块被误译，以及语言之间缺少稳定的切换入口。不同语言版本一旦各自演进，读者就很难在文档间跳转，维护者也会反复手工对齐标题、章节和导航。

这个技能把项目文档中的 README 本地化收敛成一次可重复的流程：保留源文件的 Markdown 骨架，生成命名规范的译文，并在每个版本顶部补上语言切换行，使多个语言版本看起来像同一个文档的不同视图。

它如何工作

核心能力包括：

• 结构保持：标题、章节、徽章、列表与正文按目标语言重写，但 Markdown 结构保持稳定，方便后续 diff 和持续维护。
• 代码与链接保护：代码块 不翻译；相对链接路径保持不变；外链锚文本可按目标语言优化，但不改变跳转目标。
• 命名规范：默认将 README.md 作为英文主版本；其他语言按 README.de.md、README.ja.md、README.ko.md、README.zh-CN.md 等规则落盘。
• 导航补齐：在各语言文件顶部插入切换行，例如 **English** | 中文，并在译文中增加返回主文档或跨语言互链，避免孤立页面。

工作流分为八个步骤：

1. 定位：默认读取根目录 README.md；存在多个 README 时先让用户指定目标文件。
2. 读取：完整解析标题、徽章、Features / Installation / Usage / Contributing / License 等章节，以及代码块和链接。
3. 确认语言：询问目标语言；只说“双语”时，按英文 README.md + 中文 README.zh-CN.md 执行。
4. 翻译：保留 Markdown 结构，代码块不译，标题与正文译为目标语言，相对链接路径不变。
5. 写文件：按命名规范写入各语言 README。
6. 补切换：在每个语言文件顶部加入语言切换导航。
7. 互链：在译文中增加返回主文档或多语言互链。
8. 校验：检查路径、链接、格式一致性与导航完整性，并返回包含主版本、译文路径和切换链接的 ReadmeSetArtifact。

适用边界与注意点

它只处理项目 README，不用于翻译非 README 的通用文档、与 README 无关的内容创作，也不用于法律、合同等高风险文档翻译。

使用前要确认默认英文主版本策略是否符合项目现状；如果当前主 README 不是英文，技能会先把英文版本转为主版本，再生成其他语言。译文中的外链锚文本可以优化表达，但不应改变相对路径或跳转目标。