直白如散文 是做什麼的?
寫作時,要讓讀者一看就懂,並且知道接下來該做什麼。修改時,請保留原意、事實、必要術語、語氣和限制條件。
設定任務
起草前,先確定讀者是誰、他們已知什麼、你期望的結果,以及他們下一步該採取的行動。只有在缺少答案會改變結果時,才提出疑問。
重點先行
- 以結果、決策、風險或請求開頭。
- 每個句子只傳達一個想法。任何會讓讀者回溯的句子都請拆開。
- 使用主動語態、現在式、具體名詞和強動詞。
- 使用能保持原意的最短且常見的詞彙。保留必要的技術術語,並在讀者可能不熟悉時加以解釋。
- 每個概念只使用一個名稱,並重複使用。
- 用事實、範例、數字、名稱或可觀察的標準來支持論述。推論或猜測請明確標示。
- 當影響後續發展時,請指明負責人、行動、時程、阻礙和驗證方式。
- 當有助於傳達訊息時,可以保留溫暖、幽默和個人觀點。
形式配合任務
- 展現結構,而非描述結構。用表格比較選項,用 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,不使用裝飾性表情符號。
- 只有在能讓文字更容易掃讀時,才使用粗體、標題和列表。
編輯檢查
- 檢查第一個句子是否能引導讀者。
- 刪除任何未增加意義、證據、必要語氣或上下文的詞語和句子。
- 修正不明確的代名詞、修飾語、條件句和列表分組。
- 替換每一個 AI 痕跡。對於文件、PR、技能和改寫,請使用 ai-tells.md。
- 搜尋 em dash 和 en dash 字元並全部替換。
- 修改時,將結果與原文比較。修改結果不能增加原文沒有的新事實、名稱、數字、日期、引述或主張,也不能遺漏任何仍然適用的內容。每個主張都要保持其確定性。將 "可能失敗" 簡短寫成 "失敗" 會形成一個新主張,因此請保留緩衝語。當一個句子需要你沒有的細節時,請提問或寫一個更簡單的句子。
- 以正常速度朗讀一遍。修正任何聽起來像在唸稿、生硬或模糊的內容。
報告產出
- 先說明對使用者而言有何改變,再說明實作細節,最後說明後續維護者會繼承什麼。
- 即使是很簡短的回覆,也要保留必要的細節、權衡取捨、選擇和未決的決策。
- 只連結本次工作中產生或閱讀過的產出。不得偽造引用來源或轉錄參考資料。
- 為每個主張保留其證據或標記。區分經實測、推論、轉述和猜測的主張。來自其他代理的數字在驗證其測量方式之前,仍應視為轉述。說明每個數字的統計對象是什麼。
- 根據結果報告發現:已修正、已緩解、已延期或已拒絕。部分未解決的發現視為延期;僅透過警告或文字說明關閉的發現視為緩解。不要將混合情況稱為「已全部修正」。
產出正確的成品
- 若是改寫,回傳改進後的文字。僅在有幫助時才解釋變更原因。
- 若是評論,指出主要問題,提供修改版本,並列出最重要的規則。
- 若是起草,推斷讀者和目標,然後撰寫最簡短的完整版本。
- 在對話中,直接回答問題,不提及此流程。
完成條件
- 讀者能在第一次閱讀時就掌握重點。
- 如果有下一步行動,則明確指出。
- 每個主張都有來源、經過測量,或被標示為推論或猜測。
- 每個句子都有其存在價值。
- 文章讀起來像是一位有能力的人為此讀者所寫。
- 未遺留任何 em dash 或 en dash 字元。