Communitygithub.com

shimo4228/claude-skill-paper-ecosystem

Claude Code Agent 的學術論文寫作與審查技能包,整合了編排、草稿與 5 個審查子代理,支援 SSRN / arXiv / Zenodo / 期刊等投稿。

claude-skill-paper-ecosystem 是什麼?

這是一個專為撰寫與審查學術論文(如 position paper、preprint 或 journal-style 文章)設計的 Claude Code Agent 技能組合。它包含一個 orchestrator 技能(paper-ecosystem)來管理草稿流程、一個草稿寫作技能,以及 5 個專門的審查子代理(pape-reviewer、source-fidelity-checker、vocabulary-consistency-checker、citation-formatter 等),可協同執行品質把關。該技能強調「來源忠實度」——要求所有聲明必須直接對應主要來源(論文、ADR、標準等),避免引用摘要或次要文件,並確保詞彙一致性與子分類保留。它支援多語言版本(如中英文並行),並提供標準化的章節範本(9 節結構)與摘要格式(250-300 字三段結構)。開發者只需透過 install.sh 即可將此技能組合部署至支援 Claude Code Agent 的平台(如 Claude Desktop 或 Cursor),大幅簡化學術寫作與審查流程。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add shimo4228/claude-skill-paper-ecosystem

在你喜歡的 AI 中提問

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

說明文件

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 節結構:

  1. 標題頁 — 標題 + 副標題 + 作者 + ORCID + 版本 + 附屬儲存庫 + 授權
  2. 摘要 — 250-300 字,三段結構(如下)
  3. 引言 — 問題陳述 + 論文預覽 + 章節路線圖
  4. [主體章節] — 論文的核心貢獻,約 3-6 個章節
  5. 與現有框架的關係 — 簡短(1 段至 1 頁),說明與競爭框架的關係
  6. 結論 — 重申論文 + 開放問題
  7. 參考文獻 — 類似 APA 的簡化格式
  8. 致謝(可選)
  9. 附錄(可選)

若為期刊風格文章,請依照投稿目標的固定格式調整章節編號、標題層級及表格 / 圖形配置。


摘要結構(250-300 字)

三段:

  1. 問題陳述(約 70-90 字) — 探討何種現象,現有論述缺少什麼
  2. 貢獻(約 120-150 字) — 明確提出 2-3 個核心貢獻。每個貢獻各用一句話說明 what / why / how
  3. 影響(約 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. 用一句話寫出章節聲明(再次確認草稿前檢查清單的產出)
  2. 章節開頭從具體事物開始:舉例 / 已知現象 / 引用來源的引言,不要從抽象框架開始
  3. 緊接在後放置支持聲明的證據(與引用 1:1 對應)
  4. 在章節末尾明確提示章節轉換:下一節將承接什麼,本節的哪些前提會帶入下一節
  5. 次要段落應統一朝分解聲明的方向,或處理反駁 / 替代觀點的方向,兩者混雜會削弱流暢度

每個章節草稿完成後,同時啟動 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-ecosystem skill — 來源忠實度 / 詞彙一致性 / 學術語調 / 引用格式的主規則。本技能所依賴的 orchestrator
  • paper-reviewer agent — 章節草稿完成後的結構審查
  • source-fidelity-checker agent — 章節草稿完成後的引用-聲明一致性驗證
  • vocabulary-consistency-checker agent — 章節草稿完成後的術語一致性驗證
  • citation-formatter agent — 投稿前的引用 ↔ 參考文獻最終閘門
  • writing-ecosystem skill — 用於部落格文章 / 隨筆,不屬於本技能
  • llms-txt-writer skill — 用於 AI 文件,不屬於本技能

相關技能