用途：把 agent-almanac 的英文源内容本地化到目标语言，适用于技能、智能体、团队与指南的翻译、更新过期译文、按域批量翻译，或为新语言创建初始译文。
输入：内容类型（skills/agents/teams/guides）、条目 ID、目标语言（IETF BCP 47，如 zh-CN）、可选批量列表。
主要能力与流程：先读取英文源文件并区分可翻译正文与必须保留的英文内容（代码块、内联代码、YAML frontmatter 字段名与技术值、文件路径、URL、命令示例、团队中的 CONFIG 块）；用 npm run translate:scaffold -- <content-type> <id> <locale> 生成骨架文件，frontmatter 含 locale、source_locale、source_commit、translator、translation_date；翻译 description 与各正文段落，保持技术元素原样；技能需翻译标准化小节名，智能体与团队翻译用途、能力、场景、限制等章节，跨引用 ID 保持英文；校验结构完整、代码块与英文源一致、技能不超过 500 行，name 字段不翻译，运行 npm run validate:translations 检查；最后写入 i18n/<locale>/<type>/<id> 路径。
限制与注意：代码、命令、配置、ID、标签值必须保留英文；术语需全文件一致；不可只翻译标题而正文仍为英文；译文可能比英文长 10–20%，接近 500 行时收紧文字而非删内容；缺少 source_commit 会破坏新鲜度追踪。