用途:为 oss-docs 相关专家提供 i18n 硬性规则的工作摘要,覆盖 moai-adk-go 的 README 四语言(ko/en/ja/zh)与 docs-site(adk.mo.ai.kr)。权威来源为 .moai/docs/docs-site-i18n-rules.md,冲突时以 SSOT 为准,但文中列出的两处过时项以实际为准。
主要能力与规则:1)规范语言链:docs-site 与 README 均以韩文为规范语言,en/ja/zh 由 ko 派生,只写规范语言,翻译中不得“修正”规范内容。2)四语言同步:规范内容变更必须在同一 PR 落地全部 4 个语言,否则 locale-parity 失败。3)Mermaid 仅允许 flowchart TD、graph TB,禁止 LR/RL。4)正文禁用 emoji,改用 icon 短代码 {{</* icon <name> [variant] */>}},变体有 ok|warn|danger|primary|muted;排版符号与 orchestrator-banner 示例中的品牌 emoji 保留。5)强调标记空格:바이브코딩 (Vibe Coding),括号放标记外。6)URL 黑名单:仅 adk.mo.ai.kr 有效,禁止 docs.moai-ai.dev、adk.moai.com、adk.moai.kr。7)版本 SSOT:docs-site/hugo.toml 的 params.version/releaseDate 为唯一版本来源;每次发布在同一 PR 更新全部版本展示,历史引用不改。8)页面移动需在 docs-site/vercel.json 加重定向,含 locale 与无 locale 回退。9)Vercel 绑定与部署配置不可改(重定向数组除外),禁止提交/推送,发布由人工把关。
使用方式:按上述规则编辑与校验,不要调用 docs-i18n-check.sh 与 gen_menu.py(不存在),改用 Skill("hns-oss-docs-verify") 的内联检查。
限制:SSOT 中关于 Hextra 主题与 hugo.yaml 的说法已过时,实际为 hugo-geekdoc 与 docs-site/hugo.toml(defaultContentLanguage=ko);其余未提供。