Communitygithub.com

shimo4228/claude-skill-paper-ecosystem

学術論文作成・レビューのためのClaude Code Agentスキルバンドル(SSRN / arXiv / Zenodo / ジャーナル対応)。オーケストレータースキル、ドラフトスキル、5つのレビュアーサブエージェントをバンドルし、install.shでスキルとエージェントを一緒にパッケージ化した初のリポジトリ。

claude-skill-paper-ecosystem とは?

このスキルは、学術論文(ポジションペーパー、プレプリント、ジャーナル記事)のドラフト作成からレビュー、投稿前品質チェックまでを支援する包括的なClaude Code Agentスキルです。SSRN、arXiv、Zenodo、各種ジャーナルといった主要な学術発表プラットフォームに対応し、既存のエッセイ群やADR、実装履歴から論文を抽出する機能も備えています。主な特徴として、一次資料の厳密な引用ルール(ソース忠実度ルール)、クレームと引用の1:1マッピング、副分類の保存、統一されたセクション構造とアブストラクトテンプレート、APAlike簡略引用形式などが含まれます。また、5つの専門レビューアエージェント(ペーパーレビューア、ソース忠実度チェッカー、語彙一貫性チェッカー、引用フォーマッター)がドラフト完了後の各セクションを並列レビューし、投稿前の品質ゲートを自動化します。このスキルは`paper-ecosystem`オーケストレータースキルに依存し、インストールスクリプト(install.sh)によりスキルとエージェントをまとめてセットアップできます。

対応✓Claude Code~Codex CLI~Cursor
npx skills add shimo4228/claude-skill-paper-ecosystem

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

paper-writing — 学術論文ドラフトの手順

ポジションペーパー / プレプリント / ジャーナルスタイル記事のドラフト手順を、paper-ecosystem オーケストレーターの正本ルールに従って整理するスキル。

アクティベーション条件

  • SSRN / arXiv / Zenodo / ジャーナル会場向けの論文をドラフトする
  • 既存のエッセイ連作 / ADR群 / 実装履歴から論文を抽出する
  • ポジションペーパーのアウトライン確定後、各セクションのドラフト作成に入る
  • プレプリント v1 → v2 の改訂(大幅な書き換えを伴う場合)

アクティベーション外

  • ブログ記事 / エッセイ(人間主体、非形式) → writing-ecosystem を使用
  • llms.txt / FAQ(AI主体) → llms-txt-writer を使用
  • README / CHANGELOG(プロジェクト文書) → これらはスキルを介さず直接書く

ドラフト前チェックリスト

論文ドラフトに入る前に、著者は以下を完了させる:

1. 一次資料リストの確立

論文が引用する一次資料をリスト化する:

  • 引用元エッセイ / ブログ記事(URL + 日付 + 1行要約)
  • 引用元ADR / 仕様書(リポジトリパス + バージョン + 1行要約)
  • 引用元外部論文(著者 年 + arXiv ID / DOI + 1行要約)
  • 引用元標準 / フレームワーク文書(組織 年 + 標準ID)

各一次資料は論文ドラフト時に直接読める状態にする(URLアクセス可、リポジトリクローン済み、PDF取得済み)。

2. 用語集 / 要約への依存を避ける

一次資料の代わりにリポジトリの用語集 / 要約 / 二次文書を引用元として参照しない。二次側のドリフトが論文に伝播するため(詳細: paper-ecosystem スキルのSource Fidelity Rules)。

二次資料を参照するのは次の2つのみ:

  • 用語の定義の一貫性チェック(論文の定義と用語集の定義が一致するか確認)
  • 参考文献リストのフォーマット参考(どのフィールドを含めるかのスタイル例)

3. クレーム ↔ 引用ソースの1:1マッピング

アウトライン段階で、各セクションのコアクレームを1文で書き出し、各クレームに対応する引用ソースを1:1で対応させる。マッピングがあいまいなクレームはドラフトに入れる前に解消する。

フォーマット例:

§3 コアクレーム: 「リダイレクト障害には2つのアーキテクチャ的に異なるモードがある——原理的なもの(自律ループに内在する)と人工的なもの(ワークフローワークが自律ループを通じてルーティングされる)である。」
引用ソース:
- Essay 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 スキルのVocabulary Consistency Rules)。


セクションテンプレート(ポジションペーパー / プレプリント)

標準的な9セクション構造:

  1. タイトルページ — タイトル + サブタイトル + 著者 + ORCID + バージョン + コンパニオンリポジトリ + ライセンス
  2. アブストラクト — 250-300語、3段落構造(下記)
  3. はじめに — 問題提起 + 論文の主張プレビュー + セクションロードマップ
  4. [本文セクション] — 論文のコアコントリビューション。3-6セクション程度
  5. 既存フレームワークとの関係 — 短い(1段落〜1ページ)、競合フレームワークとの関係
  6. 結論 — 論文の主張の再述 + 未解決の問い
  7. 参考文献 — APAlike簡略形式
  8. 謝辞(任意)
  9. 付録(任意)

ジャーナルスタイル記事では、会場のハウススタイルに従ってセクション番号 / 見出し階層 / 表・図の配置を調整する。


アブストラクト構造(250-300語)

3段落:

  1. 問題提起(約70-90語) — どの現象を取り上げ、現状の議論の何が不足しているか
  2. コントリビューション(約120-150語) — 論文のコアコントリビューション2-3個を明示。各コントリビューションに対しwhat / why / howを1文ずつ
  3. 結果(約60-90語) — コントリビューションが論文の読者に何をもたらすか、未解決の未解決の問いへの言及

キーワード(5-8個)をアブストラクト直下に置く。


参考文献フォーマット(APAlike簡略形式)

ソースタイプフォーマット
ジャーナル記事著者, A. B. (年). タイトル. *ジャーナル名* 巻(号): ページ.
arXivプレプリント著者, A. B., & 著者, C. D. (年). *タイトル.* arXiv:NNNN.NNNNN.
会議論文著者, A. B. (年). タイトル. In *会議録タイトル* (ページ). 出版社.
業界 / 企業文書組織名. (年). *タイトル.* URL
標準規格組織名. (年). *標準ID タイトル.* 出版社.
リポジトリ / データセット著者, A. B. (年). *タイトル (バージョン).* プラットフォーム. DOI

詳細: paper-ecosystem スキルのCitation Format Rules。


多言語表記規則(任意)

従属言語版(例: 日本語訳)を並行作成する場合:

  • 英語版が正本、従属言語版は正本ではない
  • ファイル命名: <論文名>.md(英語) + <論文名>.ja.md(日本語)
  • 内容変更時、英語版が先、従属言語版を逐次反映
  • 技術用語(Quadrant / Phase Separation / artifact名等)は従属言語版でも英語表記のまま、または英語併記

詳細: paper-ecosystem スキルのMulti-language Paper Convention。


執筆プロセス(セクションドラフト)

各セクションのドラフト手順:

  1. セクションのクレームを1文で書き出す(ドラフト前チェックリストの出力を再確認)
  2. セクション冒頭は具体物から: 例 / 既知の現象 / 引用ソースからの引用、抽象的な枠組みから始めない
  3. クレームを支えるエビデンスを直後に置く(引用と1:1)
  4. セクション間の遷移をセクション末尾で明示: 次のセクションに何を渡すか、現在のセクションの何が前提として持ち越されるか
  5. 従属パラグラフはクレームを分解する方向か、反論 / 代替案を扱う方向のいずれかに揃える(両方混在は流れを弱める)

各セクションドラフト完了後、paper-reviewer エージェント + source-fidelity-checker エージェント + vocabulary-consistency-checker エージェントを並列で起動してレビューする(詳細: paper-ecosystem スキルのWhen to Use Whatフローチャート)。


品質ゲート(投稿前)

投稿直前に以下を確認:

  • 全セクションが paper-reviewer を通過している
  • 全クレームが source-fidelity-checker でALIGNEDまたはPARTIAL判定(DRIFTは残っていない)
  • 全用語が vocabulary-consistency-checker を通過している(副分類の導入明示済み)
  • citation-formatter で孤立引用0、引用 ↔ 参考文献1:1
  • アブストラクトの語数が会場標準範囲内
  • DOI / arXiv ID / URLがすべて有効
  • 多言語版がある場合、英語版と内容で乖離していない

詳細な次元は paper-ecosystem スキル内4つの正規則セクションを参照。


関連

  • paper-ecosystem スキル — Source Fidelity / Vocabulary Consistency / Academic Voice / Citation Formatの正本。本スキルが依存するオーケストレーター
  • paper-reviewer エージェント — セクションドラフト完了後の構造レビュー
  • source-fidelity-checker エージェント — セクションドラフト完了後の引用-クレーム整合性検証
  • vocabulary-consistency-checker エージェント — セクションドラフト完了後の用語一貫性検証
  • citation-formatter エージェント — 投稿直前の引用 ↔ 参考文献最終ゲート
  • writing-ecosystem スキル — ブログ記事 / エッセイ用、本スキルではなくそちら
  • llms-txt-writer スキル — AI向け文書用、本スキルではなくそちら

関連スキル