translate-skill

翻译 skill

使用这个 skill 把上游 addyosmani/agent-skills 的内容翻译成简体中文，用于 vinvcn/addyosmani-agent-skills-zh。

这个 skill 用于内容本地化，不是 Git 同步。

操作原则

把用户可见的英文说明性文字翻译成自然的简体中文，同时原样保留所有行为关键内容。

目标仓库是一个独立的简体中文本地化版本。它应接收翻译后的内容，而不是上游的仓库元数据。

翻译哪些内容

翻译自然语言文本，包括：

README 说明
skill instructions
skill descriptions
用户可见的 frontmatter prompts
面向 agent 的指引
面向维护者的指引
docs 说明性文字
以说明性文字写成的示例
Markdown 标题（headings）

Markdown 标题的翻译规则

标题是说明性文字，翻译成简体中文；标题层级与 Markdown 结构保持不变。标题内嵌的 inline code、identifiers 原样保留。

• docs 页面与 skill 文件的固定 schema 标题必须使用 TRANSLATION-GLOSSARY.md 登记的统一译法，保证所有页面一致。
• 其余标题按页面语境意译，无需逐一登记。
• 例外（作为术语保留英文，不译）：模板结构标题（如 spec/ADR 模板内的 Objective、Tech Stack、Status 等，与上游模板逐字一致）；invocation 术语（User-invoked、Model-invoked）。
• 修改标题时，同步更新同一文件内指向该标题的 anchor links（GitHub 会按标题文本生成 slug，中文标题生成中文 anchor）。仓库用 node scripts/validate-reference-links.js 强制这一条。

原样保留哪些内容

不要翻译或改写：

目录名
skill 名称
slash commands
CLI 命令
代码块
inline code
文件路径
package 名
tool identifiers
API identifiers
环境变量名
frontmatter keys
JSON/YAML/TOML keys
Markdown 链接 URL
行为关键 labels

保持 Markdown 结构、标题层级、列表嵌套、表格、链接目标、相对路径和 code fences 不变。

仓库路径本地化

翻译用户可见的安装示例时，把上游仓库路径：

addyosmani/agent-skills

替换为本地化仓库路径：

vinvcn/addyosmani-agent-skills-zh

只有当命令或说明性文字是在告诉用户如何安装或使用本地化仓库时，才做这个替换。

不要移除对上游项目的署名。

Frontmatter 规则

原样保留 frontmatter keys。

按含义而不仅是字段名，对每个 frontmatter 值分类：

• 保持 name 值不变。
• 把用户可见或面向 agent 的自然语言文本翻译成简体中文，包括 description 和 argument-hint 的值。
• 保持 identifiers、命令、路径、package 名、URL、工具名、布尔值、数字和其他有类型的配置值不变。
• 在可翻译的值内部，原样保留内嵌的 slash commands、inline code、占位符、路径、URL、package 名、工具名和其他行为关键片段。
• 对有歧义的值打复核标记，不要猜测。

示例：

---
name: teach
description: 在这个工作区中教用户一个新技能或概念。
disable-model-invocation: true
argument-hint: "你想学习什么？"
---

翻译风格

使用满足以下要求的简体中文：

自然
对开发者友好
简洁
准确
与本仓库现有语气一致

如果某个常见工程术语在开发者中是标准说法，或者翻译它会降低清晰度，就把它保留为英文。

术语参考

查阅仓库根目录的 TRANSLATION-GLOSSARY.md。

对已决定的术语，严格使用记录的译法。

术语决定与落地流程

术语的请求与认领流程见 CONTRIBUTING.md；译法以 TRANSLATION-GLOSSARY.md 为唯一权威。一次完整的落地流程：