Communitygithub.com

學術寫作技能

將技術與科學文章改寫為精確的學術寫作風格,去除AI生成或口語化的痕跡。涵蓋常見的AI語氣特徵、精確命名原則、敘事結構(發布會原則),以及標記式編輯流程。

學術寫作技能 是什麼?

這個技能專為需要將技術或科學文章改寫為精確學術語氣的開發者與研究人員設計。它能識別並修正AI生成文本或口語化寫作中的常見問題,例如將數學運算描述為物體動作、使用圖像化語言代替精確屬性、以口號代替論證等。技能的核心涵蓋兩層面:一層是逐句的風格規則,要求精確命名操作、對象、數量和屬性,避免賦予物體能動性,並以陳述保證代替模糊描述;另一層是「發布會原則」(launch principle),指導論文從最強優勢出發建構論述,而非按時間順序敘述過程。此技能支援多種平台(如Claude Code、Cursor、Codex),並提供標記式編輯工作流程,確保數字、引用和意義不被更改。適用於撰寫或重構摘要、引言、結論、回應審稿意見,或在提交論文前進行風格潤飾。最終產出的是更清晰、更專業、更易於審查的學術文本。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/leolou0512/claude-skills/tree/HEAD/skills/academic-writing

在你喜歡的 AI 中提問

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

說明文件

學術寫作

兩層結構。風格規則讓每個句子精確。發布會原則決定論文主張什麼以及以何種順序呈現。所有範例均為說明性質。

此處「學術」的涵義

精確性,而非正式性。學術讀者對每個標準術語已有定義,因此確切的詞彙比生動的詞彙更簡短、更清晰。AI風格的文字總是朝著一致的方向失敗:它把數學敘述成物體在移動和行動,在可以陳述屬性的地方描繪圖像,並用口號來解釋。修復方法幾乎總是為事物命名:運算、物件、數量、論文已陳述的屬性。

過度編輯同樣是失敗。聽起來正式的近義詞、重新潤飾的正確句子以及虛構的精確性都會使文本變得更糟。在已經技術性很高的段落上編輯次數少是正確的結果。

規則及每條規則的理由

精確命名事物。

  • 對運算使用該領域的動詞:映射、投影、計算、賦值、表示為,絕不使用承載、複製、變成、獲得、綁定。領域的動詞攜帶其定義。
  • 使用已命名概念,而非對其的描述:「在……下不變」而不是「當……時不會改變」,「特徵向量」而不是「矩陣僅拉伸的方向」。同義表述更長且僅近似正確。
  • 命名數量,而非其圖像:極限、範圍、相鄰、中間,而不是邊緣、鄰居、之間。否則讀者需要重建圖像才能還原數量。
  • 命名確切物件:「樣本數量」而非「樣本」,「學習率」而非「超參數」(當僅指學習率時)。
  • 當超過一個事物符合時,為每個「這」、「一個」、「該集合」、「它」提供指涉對象。

不要賦予物體能動性或動作。 變數不會「保持」數值,約束條件不會「綁定」、「看到」或「尊重」,神經網路不會「查看」其輸入,樣本不會「接收」標籤。以數量為主語,使用運算的動詞,當動作者是演算法時使用被動語態。能動性語言隱藏了方法實際計算的內容。

陳述保證,而非圖像。 應寫「因此該迭代是壓縮映射並收斂到唯一不動點」,而不是「因此迭代趨於穩定」。圖像無法驗證;屬性是可檢驗的。

用已陳述的屬性來論證,絕不使用口號。「我們將每個特徵歸一化到單位變異數,以便懲罰項對所有特徵加權相同」,而不是「因為尺度不應影響」。口號聽起來有說服力,但沒有陳述任何審稿人可以檢驗的內容。

說明哪個數量變化以及朝哪個方向變化。「因為召回率較低」,而不是「由於偵測率下降」。說明一個數字是什麼(「在2000張測試圖像上的準確率」),而不是它「來自」哪裡。用指標替換「效能」。

為從上到下閱讀的讀者塑造句子。 一個句子一個事實;遇到第二個事實時拆分句子。先主張,後機制。刪除用圖像重述相鄰句子的句子。讓動作者做主語(「求解器需要4.2小時收斂」,而不是「收斂需要求解器4.2小時」)。寫「是……的三倍長」,而不是「比……長三倍」。用單一的標準動詞(禁用、啟用、配置)取代片語動詞(關閉、打開、設置)。刪除填充詞和慣用語(一次性、此外、不再、刻意、當然)。

與論文本身保持一致。 在選擇一個詞之前,在論文中搜尋該概念被定義的位置,並重複使用該精確短語。每個詞賦予一個意義(如果「評分」在其他地方表示評估,則不要將其用於損失函數)。符號表重複正文中每個符號的定義,無論通用規則偏好如何。在整個論文中同意詞彙變更後,再在特定章節中進行更改。

禁止使用的結構(常見的LLM特徵):長破折號和「--」;散文句子中的冒號;修辭性分號;「雖然X,Y」的開頭;「不僅……而且」;「此外」的連鎖;以「因為」或單獨的數學符號開頭的句子;排行榜用詞(擊敗、超越、超過X但低於Y、位列、最強、SOTA);過度宣稱;深入探討、利用、關鍵、樞紐、無縫、值得注意的是、強調、範式、新穎框架。

敘事:發布會原則

論文是產品發布會,而非進度報告。上述風格規則決定每個句子的措辭。這些原則決定論文主張什麼以及以何種順序呈現。

範圍。 在撰寫新文字或重構摘要、引言、結果討論或結論時完整應用。在標記式風格潤飾中,僅作為標記編輯應用規則3,並在報告中列出違反其他規則的情況。重新安排故事、重新建構比較或移除實驗會改變意義,這是作者的決定。

1. 圍繞最強優勢建構故事。 選擇一個沒有基線能匹配的結果或屬性,並圍繞它組織摘要、引言和結果。其他結果支持它。讀者每篇論文只記住一個主張。

2. 論證,而非敘述過程。 不是「我們先嘗試了X,然後Y,但失敗了」。呈現最終方法,並透過每個組件提供的功能來證明其合理性。失敗的變體應作為消融實驗,以需求的形式陳述(「移除歸一化步驟將準確率從A%降低到B%」),而不是一個故事(「沒有歸一化,我們早期的嘗試失敗了」)。時間順序說明做了什麼。論證說明為什麼有效。

3. 無自我弱化措辭。 刪除「不幸地」、「僅」和「僅僅」作為判斷詞,「仍然明顯落後」、「效果有限」、「失敗」。不要為審稿人總結弱點。認識性修飾不同,應保留:「約0.9個百分點」和「可能的原因」限定了事實的確定程度,而「不幸地」則是在評判工作。刪除判斷,絕不刪除數字。

4. 不要在方法無法勝出的指標上設置競賽。 在方法設計的軸線上進行比較(例如保證、成本或數據效率),並將該軸線作為論文陳述的目標引入。護欄:標準基準指標,使用其規範協議計算,必須保留在所有基線的表格中。改變比較基礎意味著添加一個有正當理由的軸線並將其應用於所有方法,絕不能移除或重新計算標準指標。

5. 不領先的結果應被解釋,而非讓步。 將數字並列(模式15),然後說明造成差距的目標差異或取捨,使用論文已陳述的事實。如果論文沒有陳述此類原因,則標記。絕不能虛構一個。

6. 明確陳述每個優勢。 不要讓審稿人在表格中自行尋找。寫出數量和差距(「比最強基線高1.4個百分點的準確率」)或沒有比較方法能達到的屬性。排行榜用詞仍被禁止。數量承載主張。

7. 每個實驗都有一個論證任務。 對於每個實驗,用一句話寫出它支持的主張。沒有主張意味著提議刪除它或將其移至附錄,由作者決定。與主要主張矛盾的結果也有一個任務:它應保留,並根據規則5來建構。刪除它將是選擇性報告。

8. 摘要和引言像發布會一樣開頭。 問題、現有方法的缺口、想法,然後是最強結果及其數字。在缺口清晰之前,不介紹方法歷史或貢獻列表。

9. 結論強化關鍵點。 重申主要主張及其最強數字。不要在最後一段引入新的弱點。如果場地要求有侷限性章節,則應陳述方法設計的範圍和下一步,而非道歉。

保持不變的內容

  • 準確的平實英語。「在0.3處趨於平穩」、「遮罩條目保持遮罩」、「來自未經修改的代碼副本」是精確的。替換它們是重新潤飾,而非修正。
  • 僅看起來非正式但標準的行話:群論意義上的「生成」、「發出」、「混合係數」、「環繞」,git意義上的「克隆」。
  • 正文已使用的詞,即使同義詞聽起來更正式(「下降」)。
  • 作者批准的措辭、限定的主張和估計(「約0.9個百分點的計數誤差」、「可能的原因」)。重新措辭可能會改變限定範圍。自我弱化判斷不是限定詞(發布會原則3)。
  • 數字、單位、方程式、符號、表格值、引用、文獻和標籤目標。
  • 任何精確版本需要論文未陳述事實的內容。口語措辭可以僅從文本中修復;模糊措辭通常需要一個事實。如果論文缺少該事實,則保留該句子並標記。絕不能為了使句子精確而虛構事實。
  • 表格可以保持電報式風格。

工作流程

  1. 在閱讀文本之前先閱讀簡報。 閱讀項目的樣式指南(如果有的話)。閱讀任何合著者的評論,並記下它反對的一般模式,以便閱讀是針對性的掃描,而非重新潤飾。決定預期的編輯量(對於設定或表格密集的章節,編輯量應低)。
  2. 在快照上工作。 合著者可能正在編輯即時檔案。複製它,記錄提交(commit),然後編輯副本。對於長文檔,按章節將其分割成區塊,並將每個區塊交給單獨的代理,每個代理有自己的副本和共享的簡報。
  3. 逐句掃描。 列出審稿人可能質疑的每個動詞、慣用語、解釋和同義表述。對於每個,在論文中搜尋已定義的術語。在重新措辭機制之前,閱讀代碼或方程式;措辭必須遵循計算的內容。
  4. 使用腳本進行編輯,該腳本斷言每個舊字串恰好出現一次。標記每個編輯:\del{old}\add{new} 在同一行,最小的更改短語,或當大部分更改時的整個句子。在 \del{} 內部,將行內數學和每個 \cite/\ref 包裹在 \mbox{} 中(否則 ulem 會中斷)。絕不要將顯示數學、\label、\begin/\end、\item 或 \caption 放在標記內部;標記放在標題的文字內部。不要新增或刪除行。
  5. 驗證。 拒絕每個標記必須能重現原始文本,並且不能改變任何數字、引用、文獻或標籤(用 $1 - p$ 這樣的符號替換短語會添加一個「1」;解釋任何此類命中)。與快照進行差異比對,以確認只有預期的行發生了變化。重新閱讀每個已接受的句子。
  6. 合併到即時檔案。 拉取(pull),然後進行三方合併(git merge-file current snapshot edited),以便並行的合著者編輯得以保留。編輯行附近的衝突通常是合著者添加的註釋;同時保留編輯後的行和他們的註釋。
  7. 檢查修訂巨集。 如果在序言中 \add/\del 被註解掉了,則標記式工作流程已關閉:將編輯作為純文字應用,而不是重新啟用巨集。編譯並檢查未定義的引用和「??」。
  8. 報告。 一個變更日誌,格式為 行 N: "old" -> "new" (原因,六個詞或更少),一個考慮過但保留的短語列表及其原因,以及需要作者處理的事項的標記(缺失的事實、協議不匹配、缺失的引用、風格潤飾無法解決的發布會原則違規)。

單行規則

  1. 命名運算,而非日常動作(映射,而非承載)。
  2. 命名確切物件(樣本數量,而非樣本)。
  3. 命名數量,而非空間圖像(上限,而非上邊緣)。
  4. 使用該領域的術語來表示屬性,而非描述它。
  5. 無物體動作:以數量為主語。
  6. 陳述保證,而非圖像。
  7. 用論文陳述的屬性來證明選擇的合理性,絕不使用口號。
  8. 說明哪個數量變化以及朝哪個方向變化。
  9. 一個句子一個事實;遇到第二個事實時拆分。
  10. 從論文定義概念的位置取出精確短語。
  11. 為「這」、「一個」和「該集合」提供指涉對象。
  12. 寫「是……的N倍長」,絕不寫「比……長N倍」。
  13. 不改變準確的平實英語、批准的措辭、限定詞和數字。
  14. 如果精確性需要論文未陳述的事實,則標記;絕不能虛構。
  15. 拒絕每個標記必須能返回原始文本。
  16. 圍繞其最強優勢組織論文。論證,而非敘述過程。
  17. 刪除自我弱化判斷。保留認識性修飾和每個數字。
  18. 在方法設計的軸線上進行比較。標準指標保留,規範協議。
  19. 不領先的結果:數字並列,然後是陳述的原因。絕不讓步。
  20. 每個實驗陳述其支持的主張。作者決定是否移除。
  21. 摘要:問題、缺口、想法、最強數字。結論:不引入新弱點。

參考資料

references/patterns.md 包含完整目錄:十六個模式,每個都有其特徵、規則以及前後對比範例,其次是保持不變的判斷點及其原因。在進行風格潤飾時閱讀它,或者當一個句子感覺不對且您想要匹配模式時閱讀它。

Individual skills in this repo

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

相關技能