paper-writing — 學術論文草稿流程
Position paper / preprint / journal-style 文章的草稿流程,依照 paper-ecosystem orchestrator 的主規則進行編排。
啟動時機
- 為 SSRN / arXiv / Zenodo / 期刊等投稿管道撰寫論文草稿
- 從現有的一系列文章、ADR 群組或實作歷史中萃取論文
- Position paper 大綱確定後,開始撰寫各章節
- Preprint v1 → v2 修訂(涉及大幅度改寫時)
非啟動時機
- 部落格文章 / 隨筆(以人類為主、非正式)→ 請使用
writing-ecosystem - llms.txt / FAQ(以 AI 為主)→ 請使用
llms-txt-writer - README / CHANGELOG(專案文件)→ 直接撰寫,不經由此技能
草稿前檢查清單
進入論文草稿階段前,作者應完成以下事項:
1. 確立主要來源清單
列出論文將引用的主要來源:
- 引用的文章 / 部落格貼文(URL + 日期 + 一行摘要)
- 引用的 ADR / 規格文件(儲存庫路徑 + 版本 + 一行摘要)
- 引用的外部論文(作者 YEAR + arXiv ID / DOI + 一行摘要)
- 引用的標準 / 框架文件(組織 YEAR + 標準 ID)
每個主要來源在論文草稿時應能直接讀取(可存取 URL、已 clone 儲存庫、已取得 PDF)。
2. 避免依賴詞彙表 / 摘要
不得使用儲存庫的詞彙表、摘要或次要文件作為引用依據。次要文件的變異會傳播到論文中(詳見 paper-ecosystem 技能的來源忠實度規則)。
僅在以下兩種情況可參考次要文件:
- 檢查術語定義的一致性(確認論文中的定義與詞彙表定義相符)
- 參考參考文獻格式(作為欄位包含的範例)
3. 聲明 ↔ 引用來源的 1:1 對應
在大綱階段,為每個章節的核心聲明撰寫一句話,並將每個聲明與其引用來源進行 1:1 對應。對應模糊的聲明必須在進入草稿前解決。
格式範例:
§3 核心聲明:「重導向失敗有兩種架構上截然不同的模式——原則性的(內生於自主循環)和人為的(工作流程透過自主循環路由)。」
引用來源:
- 文章 5(zenn-content/articles-en/react-agent-business-quadrant-2.md, 2026-04-30)
- ADR-0009 §Context(agent-attribution-practice/docs/adr/0009-triage-before-autonomy.md)
- Elish(2019)「Moral Crumple Zones」
4. 保留子分類
若主要來源對概念賦予了子形式 / 子單元 / 子類型,需在論文引入術語時明確指出。扁平化會造成偏差(詳見 paper-ecosystem 技能的詞彙一致性規則)。
章節範本(position paper / preprint)
標準的 9 節結構:
- 標題頁 — 標題 + 副標題 + 作者 + ORCID + 版本 + 附屬儲存庫 + 授權
- 摘要 — 250-300 字,三段結構(如下)
- 引言 — 問題陳述 + 論文預覽 + 章節路線圖
- [主體章節] — 論文的核心貢獻,約 3-6 個章節
- 與現有框架的關係 — 簡短(1 段至 1 頁),說明與競爭框架的關係
- 結論 — 重申論文 + 開放問題
- 參考文獻 — 類似 APA 的簡化格式
- 致謝(可選)
- 附錄(可選)
若為期刊風格文章,請依照投稿目標的固定格式調整章節編號、標題層級及表格 / 圖形配置。
摘要結構(250-300 字)
三段:
- 問題陳述(約 70-90 字) — 探討何種現象,現有論述缺少什麼
- 貢獻(約 120-150 字) — 明確提出 2-3 個核心貢獻。每個貢獻各用一句話說明 what / why / how
- 影響(約 60-90 字) — 貢獻為論文讀者帶來什麼,提及尚未解決的開放問題
關鍵字(5-8 個)置於摘要正下方。
參考文獻格式(類似 APA 的簡化版)
| 來源類型 | 格式 |
|---|---|
| 期刊文章 | Author, A. B. (YEAR). Title. *Journal Name* Vol(Issue): pages. |
| arXiv 預印本 | Author, A. B., & Author, C. D. (YEAR). *Title.* arXiv:NNNN.NNNNN. |
| 會議論文 | Author, A. B. (YEAR). Title. In *Proceedings Title* (pages). Publisher. |
| 業界 / 公司文件 | Org. (YEAR). *Title.* URL |
| 標準 | Org. (YEAR). *Standard ID Title.* Publisher. |
| 儲存庫 / 資料集 | Author, A. B. (YEAR). *Title (Version).* Platform. DOI |
詳見 paper-ecosystem 技能的引用格式規則。
多語言慣例(可選)
若同時製作次要語言版本(例如中文翻譯):
- 英文版為主要版本,次要語言版本不具權威性
- 檔案命名:
<論文名稱>.md(英文)+<論文名稱>.ja.md(中文) - 內容變更時,先更新英文版,再逐步反映至次要語言版
- 技術術語(Quadrant / Phase Separation / artifact 名稱等)即使次要語言版也保留英文,或附上英文原文
詳見 paper-ecosystem 技能的多語言論文慣例。
寫作流程(章節草稿)
每個章節的草稿流程:
- 用一句話寫出章節聲明(再次確認草稿前檢查清單的產出)
- 章節開頭從具體事物開始:舉例 / 已知現象 / 引用來源的引言,不要從抽象框架開始
- 緊接在後放置支持聲明的證據(與引用 1:1 對應)
- 在章節末尾明確提示章節轉換:下一節將承接什麼,本節的哪些前提會帶入下一節
- 次要段落應統一朝分解聲明的方向,或處理反駁 / 替代觀點的方向,兩者混雜會削弱流暢度
每個章節草稿完成後,同時啟動 paper-reviewer agent + source-fidelity-checker agent + vocabulary-consistency-checker agent 進行審查(詳見 paper-ecosystem 技能的 When to Use What 流程圖)。
品質閘門(投稿前)
投稿前確認以下事項:
- 所有章節已通過
paper-reviewer審查 - 所有聲明經
source-fidelity-checker判定為 ALIGNED 或 PARTIAL(無 DRIFT) - 所有術語已通過
vocabulary-consistency-checker審查(子分類引入已明確標示) - 經
citation-formatter確認無孤立引用,引用 ↔ 參考文獻 1:1 對應 - 摘要字數在投稿標準範圍內
- 所有 DOI / arXiv ID / URL 均有效
- 若有多語言版本,英文版與內容無偏差
詳細維度請參閱 paper-ecosystem 技能內的 4 個規範性規則章節。
相關
paper-ecosystemskill — 來源忠實度 / 詞彙一致性 / 學術語調 / 引用格式的主規則。本技能所依賴的 orchestratorpaper-revieweragent — 章節草稿完成後的結構審查source-fidelity-checkeragent — 章節草稿完成後的引用-聲明一致性驗證vocabulary-consistency-checkeragent — 章節草稿完成後的術語一致性驗證citation-formatteragent — 投稿前的引用 ↔ 參考文獻最終閘門writing-ecosystemskill — 用於部落格文章 / 隨筆,不屬於本技能llms-txt-writerskill — 用於 AI 文件,不屬於本技能