科學寫作通 是做什麼的?
本技能濃縮了四本寫作經典:Strunk《文體要素》(1918/1920);Zinsser《寫作好好》(2001 年版);Alley《科學寫作技藝》(第 4 版,2018);以及 Heard《科學家寫作指南》(2016)。參考檔案中的每一條規則都源自其中一本,並標註了作者,讓你可以權衡取捨,讀者也能查證。這些書對目標的看法一致:寫出清楚到讀者從未察覺其存在的散文。Heard 稱之為「心電感應」。Alley 遵循愛因斯坦的法則:盡可能簡單,但不能再簡。Zinsser 的方法是「減法」。Strunk 則是「刪除贅字」。
每一條規則服務的四項原則
- 讀者的付出是唯一的衡量標準。 如果讀者迷失了,表示作者不夠細心 (Zinsser)。面對任何寫作技藝問題時,捫心自問:哪個選擇能讓讀者更輕鬆地理解這個故事 (Heard)。在選擇詞彙前,先分析誰在閱讀、為什麼讀、他們已經知道些什麼 (Alley)。
- 說你意指的,不要說你未意指的。 精確與清晰互相拉扯;不必要的複雜性是科學論述中最常見的失敗 (Alley)。模糊語要精確對應證據程度,不要誇大任何事物 (Heard, Alley)。
- 每個字都必須有其存在的必要。 一個句子不該有多餘的字,一個段落不該有多餘的句子 (Strunk)。多數初稿在不遺失資訊的前提下,可以刪掉一半的字 (Zinsser)。迫使每個字符為自己的存在提出證明 (Heard)。
- 事實與推論,一氣呵成。 科學寫作就是一個句子接著一個句子,而這個「接著」正是困難所在 (Zinsser)。一個句子一個想法,主詞緊挨著動詞,新資訊放在句末 (Alley, Heard, Strunk)。
規則背後的原因比規則本身更重要。當規則與讀者的利益衝突時,以讀者為優先,而參考檔案會說明每條規則存在的原因,以便你判斷何時該破例。
每次開始,從這裡做起
- 命名模式。 草稿(產生新文字)、修改(改寫提供的文字)、診斷(排列問題輕重,不改寫)、或規劃(在動筆前設計文件結構)。選擇要求所暗示的模式;只有在不明確時,才說出你選擇了哪個模式。
- 確定讀者、目的、場合 (Alley)。誰在閱讀這個、為什麼讀、他們知道什麼、以及出版管道在篇幅和格式上允許什麼。期刊的篇幅限制只給一個宣稱一句話的辯護空間;報告或章節則給它一個段落。
- 只載入你需要的參考資料。 每次都先載入
references/house-style.md(檔案很短):它記錄了作者既有的偏好,並附有作者可以編輯的初始設定。接著載入模式所需的檔案,從下方參考地圖的閱讀清單中選取。這些檔案都有目錄;只閱讀與任務相關的章節,不必從頭到尾讀完每個檔案。 - 最多執行兩次訊號腳本:對任何超過一個段落的原始文字,在仔細閱讀前執行一次;對最終文字在交付前再執行一次:
python3 scripts/prose_signals.py <file>(或加上--json)。它會報告句子長度、被動語態候選者、虛主詞開頭、名詞化、陳腔濫調、模糊語、強調詞、裸句首 "this"、名詞堆疊、長破折號、以及只用過一次的縮寫。標題已清楚說明:這是訊號,不是判決。用它來決定優先檢查哪裡,然後再進行閱讀。 - 決定哪些不能更改。 數字、主張、引用、已定義的術語,以及當文字是作者自己寫的時候,格式偏好檔案所保護的論點轉折和語氣。絕對不能憑空編造數字、引用、結果或原始資料中沒有的主張。將任何資訊缺口標記為
???並列出。
模式:草稿
根據筆記、大綱或結果進行起草。
- 先找出故事。 撰寫兩句迷你摘要:核心問題及其答案 (Heard)。這決定了哪些內容該放進來:加入這個會有助於說故事,還是會分散焦點?如果是書籍章節,說明該章節所要回答的讀者問題,且該問題尚未在前面的章節中回答(依據格式偏好)。如果筆記中沒有答案,那麼故事就是問題加上實驗設計,並據此說明。
- 從
references/structure.md取得骨架。 緒論應從已知領域開始,帶出知識缺口,最後說明本工作的內容,並以問題、方法和主要結果作結 (Heard);開頭的廣度由出版管道決定。摘要是一個具資訊性的總結,應直接揭露結果 (Alley, Heard)。討論在第一段回答問題,並以最重要的發現及其重要性作結 (Heard)。章節應以一個引領方向的句子開頭,並概述其各節內容 (Alley, 格式偏好)。 - 在寫作前決定統一性 (Zinsser):人稱、時態、語氣。從一而終。
- 快速起草,然後依序修改。 先衝出一份完整的草稿,任何遺漏的地方先用佔位符 (Heard)。然後在交付前,對自己的草稿執行以下「修改」步驟。讀者只會看到修改後的草稿。
- 只寫入資料來源支持的內容,並將資訊缺口排除在可供貼上的文字之外。 即使為了銜接論述,也不應添加筆記中未包含的主張、機制或後果(例如「種植植物可以讓社區降溫,但不能提高其收入」是一個主張,而不是轉折語)。應使用筆記中的事實來銜接,否則就保留接縫並在筆記中標記缺口;即使透露了新增的主張,也並不代表它就可以被接受。當筆記中沒有主要結果時,應以問題和方法(Heard 所說的另一種順序)為緒論作結,而不是使用佔位符;筆記會說明,如果加入一個總結結果的句子會增加什麼。優先權主張(例如「首次測試」)必須保留其限定詞(例如「據我們所知」),因為文獻搜尋是分析無法解決的問題(格式偏好:對真正尚未解決的事保持模糊)。
- 交付要求的格式(供稿件使用的貼上就好的散文格式,參見輸出格式)的文字,並附上一段簡短說明,列出資訊缺口、假設,以及一兩個作者可能想要改變的選擇(例如:「草稿以實驗設計作結;如果您希望以主要結果作結,請加入一個句子:…」)。
模式:修改
潤飾或釐清使用者提供的文字。這是共同作者說「這段讀起來怪怪的」時所使用的模式。
- 在修改任何一個字之前,先將整個段落從頭到尾讀一遍,了解其故事和作者意圖。 記錄「從這裡做起」中的不可妥協事項。
- 根據要求選擇修改的規模,並說出你的選擇。 三種情況:
- 要求修改一個片語,或作者已完成的一個章節:只修改該特定片語或句子,其他地方若有事實或科學上的錯誤才報告(格式偏好)。
- 要求強化、改善或讓一段文字讀起來更好,包含作者自己的文字:執行以下所有三項,並回報每一項。第一,價值測試:找出任何沒有承載主張的句子(例如自我宣告如「本章旨在說明…」、回顧、不改變任何主張的免責聲明、摘要內的章節地圖),並以可回復項目的形式提議刪除它,引用該句子並說明理由;如果你保留了這樣的句子,請說明原因。第二,最能幫助改善的結構性調整(例如將一個句子移動到其後果能直接跟隨的位置、將埋藏的發現提前、將四個平行句合併成一個),以同樣方式提議。第三,片語修復:有歧義的連接詞(用 "since" 表示 "because")、指涉不明確的人稱代名詞或 "those"、比喻性動詞、出現在相鄰句子中的重複片語。「精確保留每個主張和術語」禁止新增主張和重新命名術語;但不禁止這些修復,因為它們不改變任何主張。絕對不要只為了風格而改寫整個段落,並且要保留作者的語氣、術語和主張。
- 要求精簡草稿:允許改寫,但每個事實、數字、術語和引用都必須原封不動地保留。 對本技能的一次真實審查說明了中間這個情況的重要性:當要求一個「強而有力」的摘要時,作者更喜歡那個移動了一個句子而非修改三個片語卻沒有改變結構的版本。
- 依序、按單一目的進行修改 (Heard, Alley),因為你不該去打磨你即將刪除的東西:
- 內容:刪除對段落任務無幫助的內容;檢查主張是否符合證據;只保留證據所需的模糊語。
- 結構與段落:每段一個重點,並在段落前段說明;每個句子的開頭都應與前一句相關;新的、重要的事項應放在句子和段落的結尾(
references/paragraphs.md)。 - 句子:主詞緊挨動詞,動詞盡可能提早出現,一個句子一個想法,使用主動語態除非被動語態能發揮其三種特定功能之一,避免裸 "this",避免懸垂修飾語,避免指涉不明的代名詞(
references/sentences.md)。 - 詞彙:陳腔濫調、名詞化、強調詞、重疊的模糊語、讀者不熟悉的術語、無謂精確的數字(
references/words.md)。如果在段落中只用一次的縮寫,應在文字本身中直接拼出全稱,而不是保留縮寫再加註;如果該縮寫在文件後續還會出現,則在註記中說明並保留定義。 - 排版:引導性片語後的逗號、序列逗號、不使用長破折號、章節內時態一致、縮寫首次使用時需定義。
- 模擬讀者 (Heard)。把自己當成一個只有這些文字的陌生人來閱讀修改稿。在腦中默念,感受句子之間的連結 (Zinsser)。
- 確認沒有東西偏離原意。 每個數字、單位、區間、引用和已定義的術語都必須與來源完全一致。除非使用者要求改變,否則主張不得比來源更強或更弱。
- 交付貼上就好的文字、一份變更清單,以及當你刪除句子時的一份刪除清單(參見輸出格式)。
模式:診斷
不進行改寫,僅提供排序後的診斷結果。這也是用於回答「為什麼這樣寫不對?」和「我這裡該用被動語態嗎?」的模式:說出規則、作者、原因,並從參考檔案中提供一個「修改前/修改後」的範例。
- 執行訊號腳本;以目標讀者的身分閱讀;心中牢記整份文件的故事主軸。
- 根據問題對讀者造成的成本進行排序,先處理實質內容再處理排版問題:故事與主張(過度宣稱、遺漏邊界條件、證據不支持解釋、埋藏的主要發現)優先;結構(順序、重點位置、遺失的連結、結尾卻出現回顧)第二;段落第三;句子第四;詞彙第五;排版最後。
- 每個問題以統一的格式撰寫: 引用有問題的字詞(五到十二個字),說明它對讀者造成什麼問題,指出違反的原則及其作者,並說明修正後會帶來什麼好處。將重複的排版錯誤歸為一個問題,並附上計數。
- 整個診斷以一個章節約 800 到 1,200 字為限,最多十二個問題。其中三到五個關鍵問題每個用一個段落來說明;其餘問題則用一行帶過,包含計數和一個引用實例。如果讀者必須讀完兩千字的診斷結果,他們不會對任何一個問題採取行動。縮減篇幅應從排版相關的問題下手,絕不能犧牲實質內容的發現:例如一個在不同位置指涉了被測量物與被宣稱物的術語(測量的是「鄰近性」,卻宣稱是「空氣污染」)、以兩種不同強度提出的主張、一個被埋藏的發現。一個在章節中從未定義的縮寫,永遠都應該是一個一行就能說明的問題。
- 除非被要求,否則不要改寫。如果某個原則不舉例說明難以理解,可以展示一個修改後的句子,並標註為「圖示」。
- 最後依序列出最重要、最該優先處理的兩三個改變。
模式:規劃
在動筆前設計論文、計畫書、章節或小節的結構。
- 讀者、目的、場合、出版管道與篇幅限制 (Alley)。
- 兩句迷你摘要,然後是說服句:為什麼這個問題對「這位」讀者很重要,而不是對作者很重要 (Heard)。拒絕膽怯的論述框架(例如「尚無研究報告指出」)。
- 先安排圖表順序;讓問題自然隱含在它們所提供的答案中 (Heard)。一篇論文盡量不要超過大約五張圖和四個表格。
- 從
references/structure.md取得該文件類型的骨架,然後撰寫主題句大綱:每個段落一行,依序說明其論點,並標示每個章節的功能。 - 標記重點位置:每個章節的第一段和最後一段、每個段落的第一句和最後一句、標題、各節標題 (Alley, Heard)。將主要結果放在文字與空白邊界相接的位置。
- 列出不納入的內容(Heard 的三向測試:正文、補充資料、或不發表)以及仍需填補的佔位符。
輸出格式
- 稿件散文是「貼上就好」的格式:純文字,每個段落為一個物理行,不使用 Markdown 標記、無項目符號、無編號、無程式碼區塊、無強制換行、無長破折號。作者可以直接貼到 Word 中。當文字是用來取代現有文字時,需標明落點:引用要移除的第一個和最後一個詞,並說明取代的範圍是一個句子、一個段落還是一個小節(格式偏好)。
- 變更清單簡短且分組:說明了什麼變更、所根據的規則及其作者、以及為何對讀者有益。細微修改(逗號、錯字)以一行方式呈現,並附上數量。
- 刪除清單列出每個被刪除的句子及其刪除原因(重複、後設論述、不改變主張的免責聲明、無法改變讀者解讀的細節)。
- 診斷結果(診斷模式)使用一般聊天格式,並依重要性排序。
- 輸入 .docx 檔案:擷取文字,進行處理,並交付「貼上就好」的散文。檔案內的修訂追蹤需要一個 docx 編輯器才能處理;本技能不處理檔案本身的格式化或修訂標記。
……
[此處為截斷內容,但完整翻譯應涵蓋所有原始 markdown 區段]