translate-skill

1# 翻译 skill
2 
3使用这个 skill 把上游 `mattpocock/skills` 的内容翻译成简体中文，用于 `vinvcn/mattpocock-skills-zh-CN`。
4 
5这个 skill 用于**内容本地化**，不是 Git 同步。
6 
7## 操作原则
8 
9把用户可见的英文说明性文字翻译成自然的简体中文，同时原样保留所有行为关键内容。
10 
11目标仓库是一个独立的简体中文本地化版本。它应接收翻译后的内容，而不是上游的仓库元数据。
12 
13## 翻译哪些内容
14 
15翻译自然语言文本，包括：
16 
17```text
18README 说明
19skill instructions
20skill descriptions
21用户可见的 frontmatter prompts
22面向 agent 的指引
23面向维护者的指引
24docs 说明性文字
25以说明性文字写成的示例
26Markdown 标题（headings）
27```
28 
29### Markdown 标题的翻译规则
30 
31标题是说明性文字，翻译成简体中文；标题层级与 Markdown 结构保持不变。标题内嵌的 inline code、identifiers 原样保留。
32 
33- docs 页面的固定 schema 标题（`What it does`、`When to reach for it`、`Common questions`、`It's working if`、`Where it fits`、`Prerequisites`）与 skill 文件的结构性标题（`Steps`、`Reference` 等）必须使用 `TRANSLATION-GLOSSARY.md` 登记的统一译法，保证所有页面一致。
34- 其余标题按页面语境意译，无需逐一登记。
35- 例外（作为术语保留英文，不译）：bucket 名（`Engineering`、`Productivity`、`Misc` 等，与目录名一致）；invocation 术语（`User-invoked`、`Model-invoked`）。
36- 修改标题时，同步更新同一文件内指向该标题的 anchor links（GitHub 会按标题文本生成 slug，中文标题生成中文 anchor）。
37 
38## 原样保留哪些内容
39 
40不要翻译或改写：
41 
42```text
43目录名
44skill 名称
45slash commands
46CLI 命令
47代码块
48inline code
49文件路径
50package 名
51tool identifiers
52API identifiers
53环境变量名
54frontmatter keys
55JSON/YAML/TOML keys
56Markdown 链接 URL
57行为关键 labels
58```
59 
60保持 Markdown 结构、标题层级、列表嵌套、表格、链接目标、相对路径和 code fences 不变。
61 
62## 仓库路径本地化
63 
64翻译用户可见的安装示例时，把上游仓库路径：
65 
66```text
67mattpocock/skills
68```
69 
70替换为本地化仓库路径：
71 
72```text
73vinvcn/mattpocock-skills-zh-CN
74```
75 
76只有当命令或说明性文字是在告诉用户如何安装或使用本地化仓库时，才做这个替换。
77 
78不要移除对上游项目的署名。
79 
80## Frontmatter 规则
81 
82原样保留 frontmatter keys。
83 
84按含义而不仅是字段名，对每个 frontmatter 值分类：
85 
86- 保持 `name` 值不变。
87…