SuperAPI AI 工具集

translate-docs

智能体与模型

查看项目

更新于 10-16 01:19

技能介绍

用途:该技能在 docs/zh/ 与 docs/en/ 两个目录间逐页同步双语文档,任一语言更新后按 source-of-truth 规则翻译另一侧,供 gen-docs(增量更新)和 audit-docs(发布前全量审计)调用。

前置条件:若缺少 docs/zh/ 与 docs/en/ 镜像目录结构,或缺少 docs/AGENTS.md(含术语表、排版规则、source-of-truth 规则),需停止并向用户报告。

同步规则:release-notes/changelog.md 与 release-notes/breaking-changes.md 以英文为源,译为中文;其他页面为镜像对,任一侧变更后需在同一次改动中更新另一侧,发布前完成同步。

工作流程:用 git diff main..HEAD --stat docs/ 查看变更文件,按相同相对路径找到另一语言的镜像,逐页逐节翻译;保持标题层级、列表结构、代码块、callout 与链接目标一致;术语存疑时阅读实际代码确认。应用 docs/AGENTS.md 的术语与排版规则:严格使用术语表,不造译名;英文 H2+ 用 sentence case;中文用全角标点并在中文与 ASCII 间加空格;callout 标题使用指定中文短标签。完成后 git diff docs/ 检查术语漂移与标点回归,并运行文档构建(如 pnpm --filter docs run build)检查坏链与 Markdown 错误。

限制:不做单侧修补,若变更侧表述不清或有误应先改该侧再同步;代码块、命令、flag、文件路径不翻译;示例须用 example.com、example.test、YOUR_API_KEY 等中性占位符,不得引入真实内部端点、密钥、账号或服务名。