---

name: translate-content locale: wenyan-ultra source_locale: en source_commit: 82c77053 fence_basis_commit: 82c77053 translator: "Julius Brussee homage — caveman" translation_date: "2026-05-03" description: > Translate agent-almanac content (skills, agents, teams, guides) into a target locale while preserving code blocks, IDs, and technical structure. Covers scaffolding, frontmatter setup, prose translation, code preservation, and freshness tracking. Use when localizing content for a new language, updating stale translations after source changes, or batch-translating a domain. license: MIT allowed-tools: Read Write Edit Bash Grep Glob metadata: author: Philipp Thoss version: "1.1" domain: i18n complexity: intermediate language: multi tags: i18n, translation, localization, multilingual, l10n

譯容

譯英源容於目地、留技正與構完。

用

• 地化技、代、隊、導於支語→用
• 更陳譯後源變→用
• 域或容類中多項批譯→用
• 為新地建初譯→用

入

• 必：容類——skills、agents、teams、guides
• 必：項 ID——容名/識（如 create-r-package）
• 必：目地——IETF BCP 47 碼（如 de、zh-CN、ja、es）
• 可：批列——多 ID 序譯

行

一：讀英源

1.1 定源檔路：

• Skills：skills/<id>/SKILL.md
• Agents：agents/<id>.md
• Teams：teams/<id>.md
• Guides：guides/<id>.md

1.2 讀全源檔以解境、構、容。

1.3 識當留英之段：

• 諸碼塊（三反引圍）
• 內碼（反引裹）
• YAML 前題域名與技值（name、tools、model、priority、skills 列項、allowed-tools、tags、domain、language）
• 檔路、URL、命例
• 隊中 <!-- CONFIG:START --> / <!-- CONFIG:END --> 塊

得：源容全解、明心分可譯文於留技。

敗：源檔不在→驗 ID 於登在。察容類或 ID 拼。

二：架譯檔

2.1 行架腳本：

npm run translate:scaffold -- <content-type> <id> <locale>

2.2 檔已在→讀以察是否需更（陳）或已新。

2.3 驗架檔有譯前題域：

• locale——配目地
• source_locale——en
• source_commit——當 git 短雜
• translator——歸字串
• translation_date——今日

得：架檔於 i18n/<locale>/<content-type>/<id>/SKILL.md（或 .md 為他類）含正前題。

敗：架腳本敗→以 mkdir -p 手建目而複源檔。手加前題域。

三：譯描

3.1 譯 YAML 前題之 description 域於目地。

3.2 技：描於頂前題。代/隊/導：亦於頂前題。

3.3 譯保簡——配原長式。

得：描含意譯準傳原義。

敗：描歧→留近字譯而非冒誤釋險。

四：譯文段

4.1 段段譯諸文容：

• 段頭（如「## When to Use」→「## Wann verwenden」於德）
• 段文
• 列項文（非列項碼/路）
• 表格文（非表格碼/值）

4.2 留此元如原：

• 碼塊（``` 圍與縮）
• 內碼（反引裹）
• 檔路與 URL
• 跨參中之技/代/隊 ID
• YAML/JSON 配例
• 命行例
• **Expected:** 與 **On failure:** 標（譯標、留構）

4.3 技：譯標段名：

• 「When to Use」→ 地等
• 「Inputs」→ 地等
• 「Procedure」→ 地等
• 「Validation」→ 地等
• 「Common Pitfalls」→ 地等
• 「Related Skills」→ 地等

4.4 代：譯：

• Purpose、Capabilities、Available Skills（唯段名——技 ID 留英）、Usage Scenarios、Best Practices、Examples、Limitations、See Also

4.5 隊：譯：

• Purpose、Team Composition（唯文——ID 留英）、Coordination Pattern、Task Decomposition、Usage Scenarios、Limitations

4.6 導：譯：

• 諸文段、調文、表述
• 命例、碼塊、配片留英

得：諸文段意譯。碼塊同英源。跨參用英 ID。

敗：技詞不確→留英含括譯。例：德「Staging-Bereich (Staging Area)」。

五：驗構完

5.1 確譯檔同源段數。

5.2 技：驗諸需段在：

• YAML 前題含 name、description、allowed-tools、metadata
• When to Use、Inputs、Procedure、Validation、Common Pitfalls、Related Skills

5.3 驗碼塊同英源（差圍塊）。

5.4 察行數：技必 ≤ 500 行。

5.5 驗 name 域精配英源（為 ID、永不譯）。

得：構效之譯檔過驗。

敗：段段比於英源。復諸缺段。

5.5：驗文已譯

5.5.1 自譯檔體取 3 文段。擇異段——非頭、非碼、非前題。

5.5.2 確各取段書於目語、非英。

5.5.3 取段仍英→譯不全。歸步四譯餘英文乃進。

得：3 取文段皆於目語、確體文已譯——非唯頭與前題。

敗：識何段仍含英文。譯之乃續入步六。

六：書譯檔

6.1 用 Write 或 Edit 工書全譯容於目路。

6.2 驗檔於期路：

• Skills：i18n/<locale>/skills/<id>/SKILL.md
• Agents：i18n/<locale>/agents/<id>.md
• Teams：i18n/<locale>/teams/<id>.md
• Guides：i18n/<locale>/guides/<id>.md

得：譯檔書於碟正路。

敗：察目在。需則 mkdir -p 建。

驗

• 譯檔於 i18n/<locale>/<type>/<id> 在
• name 域精配英源
• locale 域配目地
• source_commit 域為效 git 短雜
• 諸碼塊同英源
• 諸跨參 ID（技、代、隊）為英
• 檔 < 500 行（為技）
• npm run validate:translations 此檔報無患
• 文於目語意讀

忌

• 譯碼塊：碼、命、配當留英。唯譯圍文
• 譯 name 域：name 為典 ID。永不譯
• 譯標值：metadata.tags 中標留英為跨地一
• 詞不一：技詞於檔內與同地他檔皆用同譯
• 字譯成語：譯義非字。「Common Pitfalls」當為地自然等、非字字譯
• 缺 source_commit：無此域、新追斷。常含
• 批量過質：唯架出——頭譯而體留英——非效譯。少全譯勝多部
• 過 500 行：譯或脹 ~10-20% 於英。近限→緊文勿除容

參

• create-skill — 解所譯之 SKILL.md 構
• review-skill-format — 驗譯技構
• evolve-skill — 更譯後變之技