library-sync

Library Sync Skill

管理位于 ~/Sites/agency-docs/content/docs/library/ 的双语文档库，其中包含英文（en/）和俄文（ru/）版本。

命令

add <slug> — 添加一篇新文章到两种语言

1. 先在 content/docs/library/en/<slug>.mdx 创建英文文章
2. 在 content/docs/library/ru/<slug>.mdx 创建俄文译文
3. 将文章添加到对应章节的两个 meta.json 文件中
4. 进行俄文风格审校
5. 确认两种语言的文章均能正确渲染

sync — 检查英文版与俄文版的同步状态

1. 列出 en/ 和 ru/ 中的所有文件
2. 报告任一语言中缺失的文件
3. 比较 frontmatter 标题（确保概念上相符）
4. 标记只在一种语言中更新的文章（比较 Git 时间戳）

translate <slug> <from> <to> — 翻译文章

1. 阅读源文章
2. 翻译成目标语言
3. 根据目标读者调整示例和链接
4. 如果目标语言是俄语，进行风格审校
5. 更新 meta.json

review-ru — 俄文风格审校

审校文档库中的所有俄文文章。检查以下内容：

• 一致性：全文使用相同的术语（不要混用 Агент/Эйджент）
• 自然俄语：不要逐字翻译英文
• 技术术语：标准情况下保留英文术语（Git、MCP、API、CLAUDE.md）
• 链接：内部链接使用 /library/ru/ 路径
• 语气：具有教育性，但不居高临下，使用非正式的“ты”称呼

update <slug> — 更新两种语言的现有文章

1. 阅读当前版本
2. 在主要语言版本中应用更改
3. 将更改同步到另一种语言版本
4. 如果俄文版本有更改，进行俄文审校

文件结构

content/docs/library/
├── index.mdx          # Landing page
├── meta.json          # Top-level nav (separators + language folders)
├── en/
│   ├── meta.json      # English article order with section separators
│   └── *.mdx          # English articles
└── ru/
    ├── meta.json      # Russian article order with section separators
    └── *.mdx          # Russian articles

俄文风格指南

• 使用“ты”（非正式称呼），不要使用“вы”（正式称呼）
• 保留英文技术术语：Git、API、MCP、CLAUDE.md、CLI、LLM、token
• 仅在俄语术语已广泛使用时才音译：агент、промт、токен
• 不要翻译代码示例或命令行输出
• 调整文化相关示例（例如货币示例：同时使用 $ 和 ₽）
• 在底部链接到英文版：[English version](/library/en/<slug>)
• 从英文版链接到俄文版：[Русская версия](/library/ru/<slug>)

Meta.json 章节

在 meta.json 中使用 ---SectionName--- 分隔符对导航进行分组：

• Modes / 模式
• Core Concepts / 核心概念
• Features / 功能
• Tools / 工具
• Reference / 参考