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セクション構造:
- タイトルページ — タイトル + サブタイトル + 著者 + ORCID + バージョン + コンパニオンリポジトリ + ライセンス
- アブストラクト — 250-300語、3段落構造(下記)
- はじめに — 問題提起 + 論文の主張プレビュー + セクションロードマップ
- [本文セクション] — 論文のコアコントリビューション。3-6セクション程度
- 既存フレームワークとの関係 — 短い(1段落〜1ページ)、競合フレームワークとの関係
- 結論 — 論文の主張の再述 + 未解決の問い
- 参考文献 — APAlike簡略形式
- 謝辞(任意)
- 付録(任意)
ジャーナルスタイル記事では、会場のハウススタイルに従ってセクション番号 / 見出し階層 / 表・図の配置を調整する。
アブストラクト構造(250-300語)
3段落:
- 問題提起(約70-90語) — どの現象を取り上げ、現状の議論の何が不足しているか
- コントリビューション(約120-150語) — 論文のコアコントリビューション2-3個を明示。各コントリビューションに対しwhat / why / howを1文ずつ
- 結果(約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:1)
- セクション間の遷移をセクション末尾で明示: 次のセクションに何を渡すか、現在のセクションの何が前提として持ち越されるか
- 従属パラグラフはクレームを分解する方向か、反論 / 代替案を扱う方向のいずれかに揃える(両方混在は流れを弱める)
各セクションドラフト完了後、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向け文書用、本スキルではなくそちら