chinese-content-writing-guideline

中文內容撰寫指南

這項技能提供語言專屬規則，協助撰寫符合台灣慣例的高品質繁體中文（zh-TW）內容。

先決條件：請務必搭配 writing-style-guideline 技能使用。該技能負責規範文章結構、語氣、輸出原則、修辭手法配額、禁用詞、替代寫法和一般檢查清單。本技能僅涵蓋中文語言的專屬規則。

語言與格式

台灣讀者習慣全形標點符號、中英文之間留空格，以及台灣常用詞彙；半形逗號、使用Docker 這類字詞緊連的寫法，以及「代碼」「函數」等中國大陸用語，都會讓內容顯得像是經過轉換，或不夠用心。

• 使用繁體中文（zh-TW），並採用全形標點符號（，。、；：「」『』（）！？）
• 中文字與英數字之間一律空一格（例如：使用 Docker 建立）
• 技術詞彙採用台灣標準繁體中文用語
• 以「讀者」「大家」「各位」或「你」稱呼讀者，切勿使用「您」
• 以「我」稱呼作者，切勿使用「我們」

文法限制

「是…的」句尾結構和疊字會讓陳述變得像口語填充詞；使用直述句也能傳達相同事實，且更加簡潔。

• 句尾的：子句結尾不可在「，」或「。」前緊接「的」（「是…的」強調句尾）。請改用直述句、刪除「的」，或調整「的」字詞組在子句中的位置，避免讓「的」出現在句尾。
• 避免使用疊字

英文詞彙

在英文詞彙和譯文之間切換，會讓讀者以為兩者代表不同概念；第一次介紹時將兩者並列，之後固定使用中文譯名，就能讓每個概念只有一種稱呼。

英文詞彙重複出現時，請確認是否有常見的繁體中文譯名或縮寫。如果有，第一次出現時先列出原文和中文對照，之後只使用中文譯名。本規則不適用於人名等專有名詞。

避免照搬英文片語

逐字翻譯英文片語，會產生台灣讀者不常使用的中文詞彙：讀者必須先解讀英文原意才能理解，而這類生造詞往往並不正確。切勿直譯英文片語動詞或慣用語；請以自然的中文動詞傳達原意。

• fold in ≠ 折入。請依語境使用納入、併入或融入：將使用者回饋納入計畫，而非將回饋折入計畫。在食譜中，fold in 表示拌入；在數學中，fold（folding-based validation）表示摺疊。請注意，繁體中文的「折」不等於 fold in；摺紙要用「摺」，所以即使是字面直譯也不恰當。
• backfill ≠ 回填。請使用補填。
• align ≠ 拉齊。請使用對齊。
• empower ≠ 賦能。請使用賦權，或改寫為「讓…能夠」。
• land（專案）≠ 落地。請使用成真；執行落地 → 完成、上路或實現。
• actionable ≠ 可行動的。請使用具體可行或可立即執行。
• leverage ≠ 槓桿化。請使用善用。
• deep dive ≠ 深潛。請使用深入研究或深入探討。
• touch base ≠ 碰基地。請使用聯繫。

如果英文片語沒有標準中文譯法，請用簡短子句表達原意，或保留英文；切勿逐字創造中文譯詞。

审查清单

先运行 writing-style-guideline 的审查清单和检查器。然后运行此技能的检查器：

# Path is relative to this skill's directory; call it by absolute path from the project.
<skill-dir>/scripts/lint.sh draft.md
some-command | <skill-dir>/scripts/lint.sh -

它会将「您」、句末的「的，」「的。」、缺少中日韩文字与字母数字之间的空格、中文字符旁的半角标点，以及高置信度的英语直译词（例如折入）报告为 ERROR；将叠词、台湾术语（规则名称中包含对应的台湾替换词）、含义模糊的直译词，以及出现多次的小写英语术语报告为 WARN。代码块、行内代码、URL 和链接定义会跳过。像谢谢这样的合理叠词，以及其他含义的词语（例如指伴侣的对象、指实体着陆的落地、土方工程中的回填）属于预期警告。脚本需要支持 PCRE 的 GNU grep；在 macOS 上，请设置 GREP=ggrep。

然后逐项核对以下内容：

1. 所有文本是否都使用繁体中文和全角标点？
2. 中文字符与字母数字之间的空格是否正确？
3. 是否有分句以「的」结尾，后面紧接「，」或「。」？如果有，请改写。
4. 是否有英语术语出现多次？
5. 是否应用了台湾术语映射？
6. 是否有英语短语的直译词，例如折入？请检查“避免直译”表格。

参考：术语映射

撰写内容时，请应用以下繁体中文映射：create = 建立，object = 物件，queue = 佇列，stack = 堆疊，information = 資訊，invocation = 呼叫，code = 程式碼，running = 執行，library = 函式庫，schematics = 原理圖，building = 建構，Setting up = 設定，package = 套件，video = 影片，for loop = for 迴圈，class = 類別，Concurrency = 平行處理，Transaction = 交易，Transactional = 交易式，Code Snippet = 程式碼片段，Code Generation = 程式碼產生器，Any Class = 任意類別，Scalability = 延展性，Dependency Package = 相依套件，Dependency Injection = 相依性注入，Reserved Keywords = 保留字，Metadata = Metadata，Clone = 複製，Memory = 記憶體，Built-in = 內建，Global = 全域，Compatibility = 相容性，Function = 函式，Refresh = 重新整理，document = 文件，example = 範例，demo = 展示，quality = 品質，tutorial = 指南，recipes = 秘訣，byte = 位元組，bit = 位元，context = 脈絡，tech stack = 技術堆疊，equation = 方程式，activate = 啟動、觸發，feedback = 回饋