academic-paper について
academic-paperは、研究者やエージェントによる学術文書の執筆・改稿向けのスキルと実行可能なスターターワークスペースです。学術向けの組版ルールとReact/MDXのサンプルを備えますが、投稿用のIEEEまたはACM形式ではありません。
主な機能
- 01A4縦・一段組の学術レイアウト
- 02ローマ数字の章と斜体の小見出し
- 03概要、索引語、数値参照
- 04図表の自動番号付け
- 05実行可能なReact/MDXスターター
活用シーン
- 01LaTeX組版前の研究論文の草稿作成
- 02会議論文の内容の改稿
- 03ジャーナルプレプリントやarXiv形式の草稿作成
- 04授業レポート、実験報告書、論文の章の執筆
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ quan0715/ open-press --skill academic-paperインストール後、Claude Code で/academic-paperを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
starter/package.openpress.jsonstarter/press/design.mdstarter/press/academic-paper/press.tsxstarter/press/academic-paper/chapters/01-introduction/content/01-introduction.mdxstarter/press/academic-paper/chapters/02-methods/content/01-methods.mdxstarter/press/academic-paper/chapters/03-results-and-discussion/content/01-results.mdxstarter/press/academic-paper/chapters/04-acknowledgment/content/01-acknowledgment.mdxstarter/press/academic-paper/chapters/05-references/content/01-references.mdxstarter/press/academic-paper/components/Page.tsxstarter/press/academic-paper/components/ChapterOpenerVisual/index.tsxstarter/press/academic-paper/components/TokenSwatchGrid/index.tsxstarter/press/academic-paper/components/TypeSpecimen/index.tsxstarter/press/academic-paper/media/figure-placeholder.svgREADME.mdstarter/press/academic-paper/theme/fonts.cssREADME.mdtokens.cssstarter/press/academic-paper/theme/base/page-contract.cssprint.csstypography.cssstarter/press/academic-paper/theme/page-surfaces/back-cover.csschapter-opener.csscover.csstoc.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はこのスターターを取得しません。
エージェントがスキルを読み、ファイルをコピーするか、適宜調整します。
次に、以下を行います。
press/<slug>/press.tsx内の<Press>プロパティとカバーのJSXで、title/subtitle(論文のランニングサブタイトル)/organization(学部、機関)/authorを設定します。デプロイ/PDFの設定には、starter/package.openpress.jsonをワークスペースのpackage.jsonの"openpress"フィールドにマージします。- スターターにはIEEE会議テンプレートを基にしたサンプル構成(
Introduction、Methods/Ease of Use、Results/Prepare Your Paper、Acknowledgment、References)が含まれています。各章を独自の内容に置き換えてください。 - プロジェクト固有の規則(推奨する引用スタイル、省略形のルールなど)を
press/design.mdで編集します。 - 編集後、
npm run buildを実行して検証し、レンダリングします。
やること/やってはいけないこと
やること:
- すべての図と表に番号を付け、本文では
Fig. N/Table Nの形式で参照します。 - 参考文献は
[N]で引用し、参考文献の章に一貫した書式でまとめます。 - 数式は独立した行に配置し、右揃えの
(1)形式で番号を付けます。表の前には<TableCaption>を使用します。 - 要約で使用した後であっても、略語は初出時に定義します。
やってはいけないこと:
- 真に避けられない場合を除き、タイトルや主要な見出しで略語を使用しません。
- 要約や参考文献リストに脚注を入れません。
- 括弧内の参照には
Eq. (1)やequation (1)を使用せず、単に(1)とします。文頭でのみEquation (1)を使用します。 - すべての段落に、セクションのように番号を付けません。H4 は、明確に区別される手法やサブ手順に使用し、文章のリズムを整えるためには使用しません。
詳細な設計ルール
詳細なタイポグラフィの尺度、間隔、番号付けのルール、CSS レイヤーの役割については starter/press/design.md に記載されています。スターターをワークスペースにコピーすると、このファイルがユーザーとエージェントの両方に適用される、プロジェクトレベルの設計規約になります。