writing-clearly-and-concisely

清晰簡潔寫作

概述

寫作要清晰有力。這個技能涵蓋了該做的事（Strunk）和不該做的事（AI 模式）。

何時使用此技能

每當你為人類撰寫散文時，請使用此技能：

• 文件、README 檔案、技術說明
• 提交訊息、拉取請求描述
• 錯誤訊息、UI 文字、說明文字、註解
• 報告、摘要或任何說明
• 編輯以改善清晰度

如果你正在寫句子給人類閱讀，請使用此技能。

有限上下文策略

當上下文有限時：

1. 先憑判斷寫出草稿
2. 將草稿和相關章節檔案派發給子代理
3. 讓子代理進行編輯並回傳修訂版

只載入單一章節（約 1,000–4,500 個 token）而非全部內容，可以節省大量上下文。

風格的要素

William Strunk Jr. 的《風格的要素》（1918 年）教你如何清晰寫作並果斷刪減。

規則

基本用法規則（文法/標點）：

1. 單數所有格加 's
2. 在系列中每個詞之後使用逗號，最後一個除外
3. 插入語前後用逗號括起來
4. 在連接並列子句的連詞前加逗號
5. 不要用逗號連接獨立子句
6. 不要將句子斷成兩半
7. 句首的分詞片語應修飾主語

基本寫作原則：

8. 一個段落一個主題
9. 段落以主題句開頭
10. 使用主動語態
11. 以肯定形式陳述
12. 使用明確、具體、實在的語言
13. 刪除不必要的詞
14. 避免連續使用鬆散句
15. 並列的想法用相似形式表達
16. 相關詞語放在一起
17. 摘要中保持同一時態
18. 將強調的詞放在句尾

參考檔案

上述規則摘自 Strunk 的原文。如需完整說明與範例：

章節	檔案	約略 Token 數
文法、標點、逗號規則	02-elementary-rules-of-usage.md	2,500
段落結構、主動語態、簡潔	03-elementary-principles-of-composition.md	4,500
標題、引文、格式	04-a-few-matters-of-form.md	1,000
用詞、常見錯誤	05-words-and-expressions-commonly-misused.md	4,000

大多數任務只需要 03-elementary-principles-of-composition.md——它涵蓋了主動語態、肯定形式、具體語言和刪除不必要的詞。

應避免的 AI 寫作模式

大型語言模型傾向於回歸統計平均值，產生籠統、浮誇的文字。應避免：

• 浮誇用語： 關鍵、至關重要、不可或缺、見證、永恆遺產
• 空洞的「-ing」片語： 確保可靠性、展示功能、凸顯能力
• 推銷形容詞： 開創性、無縫、強大、尖端
• 過度使用的 AI 詞彙： 深入探討、利用、多面向、促進、領域、錦囊
• 過度格式化： 過多項目符號、表情符號裝飾、每個其他字都加粗

要具體，不要誇大。說它實際做了什麼。

關於這些模式為何發生的全面研究，請參閱 signs-of-ai-writing.md。維基百科編輯開發了這份指南來檢測 AI 生成的投稿——他們的模式經過充分記錄和實地測試。

結論

為人類寫作？從 elements-of-style/ 載入相關章節並套用規則。對大多數任務而言，03-elementary-principles-of-composition.md 涵蓋了最重要的部分。