mcpField
A
academic-paper

academic-paper

github.com/quan0715ドキュメント1451 回インストール9 週間前に更新
リポジトリ

academic-paper について

academic-paperは、研究者やエージェントによる学術文書の執筆・改稿向けのスキルと実行可能なスターターワークスペースです。学術向けの組版ルールとReact/MDXのサンプルを備えますが、投稿用のIEEEまたはACM形式ではありません。

主な機能

  1. 01A4縦・一段組の学術レイアウト
  2. 02ローマ数字の章と斜体の小見出し
  3. 03概要、索引語、数値参照
  4. 04図表の自動番号付け
  5. 05実行可能なReact/MDXスターター

活用シーン

  1. 01LaTeX組版前の研究論文の草稿作成
  2. 02会議論文の内容の改稿
  3. 03ジャーナルプレプリントやarXiv形式の草稿作成
  4. 04授業レポート、実験報告書、論文の章の執筆

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/quan0715/open-press --skill academic-paper

インストール後、Claude Code で/academic-paperを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

starter/
package.openpress.json
starter/press/
design.md
starter/press/academic-paper/
press.tsx
starter/press/academic-paper/chapters/01-introduction/content/
01-introduction.mdx
starter/press/academic-paper/chapters/02-methods/content/
01-methods.mdx
starter/press/academic-paper/chapters/03-results-and-discussion/content/
01-results.mdx
starter/press/academic-paper/chapters/04-acknowledgment/content/
01-acknowledgment.mdx
starter/press/academic-paper/chapters/05-references/content/
01-references.mdx
starter/press/academic-paper/components/
Page.tsx
starter/press/academic-paper/components/ChapterOpenerVisual/
index.tsx
starter/press/academic-paper/components/TokenSwatchGrid/
index.tsx
starter/press/academic-paper/components/TypeSpecimen/
index.tsx
starter/press/academic-paper/media/
figure-placeholder.svg
README.md
starter/press/academic-paper/theme/
fonts.css
README.md
tokens.css
starter/press/academic-paper/theme/base/
page-contract.css
print.css
typography.css
starter/press/academic-paper/theme/page-surfaces/
back-cover.css
chapter-opener.css
cover.css
toc.css

詳細

学術論文

研究論文形式の執筆向けのドキュメントスタイルです。セリフ体のタイトル、要旨ブロック、番号付きセクション(I、II、III)、イタリック体のサブセクション見出し(A、B、C)、番号付きの図表、[N]形式の数値参照を備えています。IEEEの会議論文レイアウトを参考にしつつ、単段組でスクリーンリーダーにも配慮しており、IEEEtranでの投稿に使う最終出力ではなく、執筆/プレプリント/反復作業の段階を想定して設計されています。

これはスターターを含むスキルです。SKILLルールに加えて、実行可能なstarter/ワークスペース(React/MDXのエントリ、テーマ、デザインドキュメント、サンプル章)が含まれています。openpressを使ってOpenPressランタイムのワークスペースを初期化してください。このスキルは、学術論文用のスターターファイルとデザインルールを管理します。

ビジュアルの特徴

  • 書体:全体を通してセリフ体(Source Serif 4 / Noto Serif TC)。タイトルは大きなディスプレイウェイト、本文は10.5pt程度の読みやすいサイズです。
  • セクション:最上位はローマ数字+スモールキャピタル(I. INTRODUCTION)、サブセクションはイタリック体の文頭大文字形式(A. Maintaining the Integrity…)、サブサブセクションは行内イタリック体(a) Positioning Figures and Tables:)です。
  • 要旨:太字の行内ラベル**Abstract**—に続けて、本文をイタリック体で記載します。本文の前には全幅の帯を配置します。
  • 索引語:太字の行内ラベル**Index Terms**—に続けて、本文をイタリック体で記載します。要旨の直下に配置します。
  • 参考文献:ぶら下げインデントを使用する[1]、[2]形式です。
  • 図表:自動採番し、図のキャプションは下、表のキャプションは上に配置します。細い線の境界線を使用します。
  • レイアウト:A4の単段組です。二段組の論文には専用のページ/フレームコンポーネントが必要です。このスターターでは、出版社の最終版となるIEEE/ACMレイアウトは保証されません。

適している用途

  • 研究論文の草稿(LaTeX形式に整える前の段階)
  • 会議論文の反復作業(投稿用にIEEEtranへ変換する前)
  • 学術誌のプレプリント/arXiv形式の草稿
  • 授業の期末レポート、研究室レポート、技術ノート
  • 論文の章(章ごと、または構成を拡張した論文全体)

適していない用途

  • IEEE/ACM会議への最終投稿 — その場合は出版社のクラスファイルを使ったLaTeXが必要です。このスターターは執筆とエージェントとの共同作業の段階で使用し、投稿時に手動でLaTeXに出力してください。
  • マーケティング資料やデザイン重視のドキュメント — 書体のリズムは学術的な文章を想定しており、宣伝文には適していません。
  • スライド資料や1枚ものの資料。

適用方法(新しいワークスペースへの適用)

ユーザーが「academic-paperを使って」または「研究論文を始めて」と言ったら、次を実行します。

npm create @open-press <target> -- --type slides
cd <target>
rm -rf press
cp -R <this-skill>/starter/press press

<this-skill>は、インストール済みのスキルディレクトリ、またはこのリポジトリの skills/academic-paperディレクトリを指します。OpenPressはこのスターターを取得しません。 エージェントがスキルを読み、ファイルをコピーするか、適宜調整します。

次に、以下を行います。

  1. press/<slug>/press.tsx内の<Press>プロパティとカバーのJSXで、title/subtitle(論文のランニングサブタイトル)/organization(学部、機関)/authorを設定します。デプロイ/PDFの設定には、starter/package.openpress.jsonをワークスペースのpackage.jsonの"openpress"フィールドにマージします。
  2. スターターにはIEEE会議テンプレートを基にしたサンプル構成(Introduction、Methods/Ease of Use、Results/Prepare Your Paper、Acknowledgment、References)が含まれています。各章を独自の内容に置き換えてください。
  3. プロジェクト固有の規則(推奨する引用スタイル、省略形のルールなど)をpress/design.mdで編集します。
  4. 編集後、npm run buildを実行して検証し、レンダリングします。

やること/やってはいけないこと

やること:

  • すべての図と表に番号を付け、本文では Fig. N / Table N の形式で参照します。
  • 参考文献は [N] で引用し、参考文献の章に一貫した書式でまとめます。
  • 数式は独立した行に配置し、右揃えの (1) 形式で番号を付けます。表の前には <TableCaption> を使用します。
  • 要約で使用した後であっても、略語は初出時に定義します。

やってはいけないこと:

  • 真に避けられない場合を除き、タイトルや主要な見出しで略語を使用しません。
  • 要約や参考文献リストに脚注を入れません。
  • 括弧内の参照には Eq. (1) や equation (1) を使用せず、単に (1) とします。文頭でのみ Equation (1) を使用します。
  • すべての段落に、セクションのように番号を付けません。H4 は、明確に区別される手法やサブ手順に使用し、文章のリズムを整えるためには使用しません。

詳細な設計ルール

詳細なタイポグラフィの尺度、間隔、番号付けのルール、CSS レイヤーの役割については starter/press/design.md に記載されています。スターターをワークスペースにコピーすると、このファイルがユーザーとエージェントの両方に適用される、プロジェクトレベルの設計規約になります。

コメント