Communitygithub.com

直白如散文

撰寫或修改回覆、文件、UI 文案、評論或其他散文時使用。讓下一步行動一目瞭然。

直白如散文 是什麼?

此技能旨在幫助開發者與 AI 代理撰寫清晰、直接且可執行的文字。其核心原則是:讀者應能在第一次閱讀時就掌握重點,並明確知道下一步該做什麼。技能文件提供了從起草前的讀者與目標設定,到具體寫作技巧(如將重點置於句首、使用主動語態、避免 AI 慣用語),再到編輯檢查清單與報告成果的完整框架。它適用於各種寫作任務,包括文件、PR 說明、UI 文案、除錯紀錄與對話回覆,特別強調以事實與證據支撐論點,避免模糊與空洞的修辭。此技能適用於任何需要產生或修改文字的情境,無論是在 Cursor、Claude Code 還是其他 AI 工具中,透過遵循這些原則,能顯著提升輸出的品質與溝通效率。其背後的運作方式是提供一套可遵循的規則與檢查清單,讓 AI 在產生文字時能自動套用,從而產出更專業、更易於理解且更具行動導向的內容。

相容平台~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/Camgineer/skills/tree/HEAD/skills/simple-as-prose

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

直白如散文 是做什麼的?

寫作時,要讓讀者一看就懂,並且知道接下來該做什麼。修改時,請保留原意、事實、必要術語、語氣和限制條件。

設定任務

起草前,先確定讀者是誰、他們已知什麼、你期望的結果,以及他們下一步該採取的行動。只有在缺少答案會改變結果時,才提出疑問。

重點先行

  • 以結果、決策、風險或請求開頭。
  • 每個句子只傳達一個想法。任何會讓讀者回溯的句子都請拆開。
  • 使用主動語態、現在式、具體名詞和強動詞。
  • 使用能保持原意的最短且常見的詞彙。保留必要的技術術語,並在讀者可能不熟悉時加以解釋。
  • 每個概念只使用一個名稱,並重複使用。
  • 用事實、範例、數字、名稱或可觀察的標準來支持論述。推論或猜測請明確標示。
  • 當影響後續發展時,請指明負責人、行動、時程、阻礙和驗證方式。
  • 當有助於傳達訊息時,可以保留溫暖、幽默和個人觀點。

形式配合任務

  • 展現結構,而非描述結構。用表格比較選項,用 Mermaid 圖表呈現流程、架構或前後狀態變化。用散文說明其間的推理過程。
  • 聊天與狀態更新應保持簡短,先說結果再說過程。
  • 撰寫請求時,要讓讀者無需猜測即可採取行動。
  • 撰寫程序時,使用直接的指令。將條件放在指示之前。只有真正的步驟序列才編號。
  • 參考資料應保持事實性和完整性,排除說服性內容。
  • 透過真實原因、限制條件、權衡取捨和後果來解釋一個主題。
  • 教學應讓讀者能及早看到可觀察的結果,並告訴他們應該看到什麼。
  • 程式碼註解只保留程式碼無法表達的理由,例如設計原理、外部限制或經實測的權衡取捨。

常見的 AI 痕跡

看到以下情況請立即替換。對於文件、PR、技能和改寫,也請檢查 ai-tells.md 中的完整清單。

  • 開場白、結尾敬語、讚美和總結。直接切入重點,說完即止。
  • 誇飾詞。請用 "use" 取代 "utilize" 或 "leverage",用 "help" 取代 "facilitate",用 "is" 取代 "serves as"。
  • 常見的 AI 慣用詞,例如 delve, crucial, pivotal, foster, enhance, landscape, tapestry, testament, underscore, vibrant。請使用具體的詞彙。
  • "不只是 X,更是 Y" 這類轉折對比。直接陳述重點。
  • 為了節奏而強行使用的一組三個項目。請使用自然的數量。
  • 開頭爲 "-ing" 的分詞片語,例如 "ensuring..." 或 "highlighting..."。請指明執行者和動作,或直接刪除該片語。
  • 箭頭符號、缺少冠詞和缺少動詞的片段。請寫完整的句子。
  • "事情是這樣的" 這類開場白、"本質上" 這類口頭禪,以及重複重點的單行結尾。直接陳述主張並止步於此。

標點符號

  • 用句號和逗號分隔想法。可能使用破折號的地方,請另起新句。不要使用 em dash 和 en dash 字元。
  • 冒號僅用於列舉或舉例之前。
  • 使用直角引號,標題使用 sentence case,不使用裝飾性表情符號。
  • 只有在能讓文字更容易掃讀時,才使用粗體、標題和列表。

編輯檢查

  1. 檢查第一個句子是否能引導讀者。
  2. 刪除任何未增加意義、證據、必要語氣或上下文的詞語和句子。
  3. 修正不明確的代名詞、修飾語、條件句和列表分組。
  4. 替換每一個 AI 痕跡。對於文件、PR、技能和改寫,請使用 ai-tells.md。
  5. 搜尋 em dash 和 en dash 字元並全部替換。
  6. 修改時,將結果與原文比較。修改結果不能增加原文沒有的新事實、名稱、數字、日期、引述或主張,也不能遺漏任何仍然適用的內容。每個主張都要保持其確定性。將 "可能失敗" 簡短寫成 "失敗" 會形成一個新主張,因此請保留緩衝語。當一個句子需要你沒有的細節時,請提問或寫一個更簡單的句子。
  7. 以正常速度朗讀一遍。修正任何聽起來像在唸稿、生硬或模糊的內容。

報告產出

  • 先說明對使用者而言有何改變,再說明實作細節,最後說明後續維護者會繼承什麼。
  • 即使是很簡短的回覆,也要保留必要的細節、權衡取捨、選擇和未決的決策。
  • 只連結本次工作中產生或閱讀過的產出。不得偽造引用來源或轉錄參考資料。
  • 為每個主張保留其證據或標記。區分經實測、推論、轉述和猜測的主張。來自其他代理的數字在驗證其測量方式之前,仍應視為轉述。說明每個數字的統計對象是什麼。
  • 根據結果報告發現:已修正、已緩解、已延期或已拒絕。部分未解決的發現視為延期;僅透過警告或文字說明關閉的發現視為緩解。不要將混合情況稱為「已全部修正」。

產出正確的成品

  • 若是改寫,回傳改進後的文字。僅在有幫助時才解釋變更原因。
  • 若是評論,指出主要問題,提供修改版本,並列出最重要的規則。
  • 若是起草,推斷讀者和目標,然後撰寫最簡短的完整版本。
  • 在對話中,直接回答問題,不提及此流程。

完成條件

  • 讀者能在第一次閱讀時就掌握重點。
  • 如果有下一步行動,則明確指出。
  • 每個主張都有來源、經過測量,或被標示為推論或猜測。
  • 每個句子都有其存在價值。
  • 文章讀起來像是一位有能力的人為此讀者所寫。
  • 未遺留任何 em dash 或 en dash 字元。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相關技能