SKILL.md
唯讀
名稱
writing-clearly-and-concisely
描述
當你需要撰寫人類會閱讀的文章時使用——文件、提交訊息、錯誤訊息、說明、報告或 UI 文字。套用 Strunk 永恆的規則，讓寫作更清晰、有力、專業。
清晰簡潔寫作
概述
寫作要清晰有力。這個技能涵蓋了該做的事（Strunk）和不該做的事（AI 模式）。
何時使用此技能
每當你為人類撰寫散文時，請使用此技能：
- 文件、README 檔案、技術說明
- 提交訊息、拉取請求描述
- 錯誤訊息、UI 文字、說明文字、註解
- 報告、摘要或任何說明
- 編輯以改善清晰度
如果你正在寫句子給人類閱讀，請使用此技能。
有限上下文策略
當上下文有限時：
- 先憑判斷寫出草稿
- 將草稿和相關章節檔案派發給子代理
- 讓子代理進行編輯並回傳修訂版
只載入單一章節（約 1,000–4,500 個 token）而非全部內容，可以節省大量上下文。
風格的要素
William Strunk Jr. 的《風格的要素》（1918 年）教你如何清晰寫作並果斷刪減。
規則
基本用法規則（文法/標點）：
- 單數所有格加 's
- 在系列中每個詞之後使用逗號，最後一個除外
- 插入語前後用逗號括起來
- 在連接並列子句的連詞前加逗號
- 不要用逗號連接獨立子句
- 不要將句子斷成兩半
- 句首的分詞片語應修飾主語
基本寫作原則：
- 一個段落一個主題
- 段落以主題句開頭
- 使用主動語態
- 以肯定形式陳述
- 使用明確、具體、實在的語言
- 刪除不必要的詞
- 避免連續使用鬆散句
- 並列的想法用相似形式表達
- 相關詞語放在一起
- 摘要中保持同一時態
- 將強調的詞放在句尾
參考檔案
上述規則摘自 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 涵蓋了最重要的部分。
