Multi-Lang README(中文)是一个专注于 README 多语言化的技能,用于将现有 README 翻译为中英或多语言版本,并在整个过程中保持 Markdown 结构、链接、代码块和语言切换导航稳定。它面向中英双语和多语言 README 集合,不处理与 README 无关的通用文档改写。
用途
当用户需要基于现有 README 创建中英或多语言 README,并保持 Markdown 结构时使用。典型触发场景包括:创建双语 README(如中英)、创建多语言 README、将现有 README 翻译为指定语言、统一 README 的语言切换链接。
主要能力
- 定位待翻译的 README 源文件:默认先检查根目录 README.md,如果存在多个 README 则先让用户指定目标文件。
- 读取完整内容:包括标题与徽章、各章节(Features、Installation、Usage、Contributing、License 等)、代码块与链接。
- 确认目标语言与主 README 语言策略:默认 README.md 作为英文主版本;如果当前主 README 非英文,先转为英文主版本,再按需求生成其他语言版本。若用户只说“做双语 README”但未指定语言,默认先生成英文 README.md,再生成中文 README.zh-CN.md。
- 执行翻译:保留 Markdown 结构,代码块不翻译,标题与正文翻译为目标语言,相对链接路径保持不变,外链锚文本可按目标语言优化。
- 写入目标文件:推荐命名英文 README.md、德语 README.de.md、日语 README.ja.md、韩语 README.ko.md、中文 README.zh-CN.md。
- 补充语言切换:在 README 顶部(标题或徽章后)加入语言切换,例如:English | 中文 | Deutsch | 日本語 | 한국어。
- 更新互链:在翻译文件中增加返回主文档或多语言互链,避免孤立文档。
- 交付前检查路径、链接和格式一致性。
使用方式
- 定位要翻译的 README 源文件(有歧义时先问用户)。
- 确认目标语言与主 README 语言策略。
- 在保留 Markdown 结构前提下完成翻译。
- 按语言后缀规范写入目标文件。
- 在各语言 README 顶部补齐语言切换链接。
- 交付前检查路径、链接和格式一致性。
支持语言
en(English)、de(German)、ja(Japanese)、ko(Korean)、zh-CN(Chinese)。
触发示例
“帮我创建中英 README”“帮我创建多语言 README”“把 README 翻译成日语”“新增 README.zh-CN.md”“create bilingual README”。
限制
以下场景不应使用本技能:翻译非 README 的通用文档;与 README 无关的内容创作任务;法律/合同等高风险文档翻译。