polish-tables-figures について
polish-tables-figuresは、CS系venueに投稿する研究者向けのLaTeX編集スキルです。データ値を変えずに、表や図、キャプション、参照、サイズ、色のアクセシビリティを整えます。
主な機能
- 01表をbooktabs形式に変換
- 02表と図のサイズ調整
- 03プロットをサブ図に配置
- 04キャプションと相互参照の検査
- 05色のアクセシビリティ確認
活用シーン
- 01カメラレディ論文の表を整える
- 02段幅を超えるフロートの修正
- 03図の配色のアクセシビリティ確認
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ shaishavmaisuria/ research-paper-lifecycle-skills --skill polish-tables-figuresインストール後、Claude Code で/polish-tables-figuresを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/captions-crossrefs.mdcolor-accessibility.mdfigures.mdtables.mdscripts/check_floats.pypalettes.pyvenueyaml.py詳細
表と図の仕上げ
草稿品質の LaTeX フロートを、ACM/IEEE/NeurIPS スタイル/LNCS の会議で査読者に見せられる表と図に仕上げます。booktabs の罫線、ページ幅に収まる列、整ったサブ図のレイアウト、開催地に適したキャプション、一貫した \cref 参照、色覚多様性に配慮した色を使用します。変更はすべて見た目に関するものです。数値には手を加えません。
使用するタイミング
- 「表や図をプロフェッショナルな見た目にして」/「カメラレディ向けに仕上げて」
- 「この表を booktabs に変換して」/「表の幅が広すぎる」/「overfull hbox が出る」
- 「これらのプロットをサブ図として配置して」/「キャプションを修正して」
- 「図の色は色覚多様性に配慮できている?」/「このプロットに合うパレットを選んで」
- 「
\ref/\crefの混乱を直して」 tailor-to-venueの実行後、preflight-checkの実行前。
入力
- メインの
.texファイル(\documentclassが含まれているファイル)。\input/\includeファイルは自動的に追跡されます。 - 任意:開催地プロファイル
venues/conferences/<venue>-<year>.yml(スキーマはvenues/schema.yml)— 列数とキャプションの規則を設定します。指定しない場合は、documentclass から規則を推定します。 - 強く推奨:
.texと同じ場所にある、コンパイル済みの.logファイル。これがあると、 列幅の確認(ボックスのはみ出しチェック)を実行できます。
プロセス
-
会場の規定を確認します。 会場名が指定されている場合は、そのプロファイルを読み込みます (
python3 scripts/venueyaml.py venues/conferences/<venue>.ymlで妥当性を確認します)。 形式に関わる重要な事実については、それを前提にする前に、公開中のcfp_urlで 再確認します。対象となるのは、テンプレート/documentclass、段組数、図表に関する 明記された規定(最小フォントサイズ、カラー/グレースケールの要件、アクセシビリティ 要件)です。プロファイルは出発点であり、確定情報ではありません。 -
まずすべてをリントします:
python3 scripts/check_floats.py paper.tex \ --venue venues/conferences/<venue>-<year>.ymlフラグ:
--json、--strict(警告も失敗として扱います)、--log <file>、--overfull-threshold <pt>、--no-inputs。終了コード:0 は問題なし、 1 は指摘事項あり、2 は引数が不正です。リンターが対象とする項目:booktabs のスタイル (\hline、\cline、縦罫線、二重罫線、パッケージの不足)、\resizebox/小さなフォントへの縮小、系統ごとのキャプション位置、\caption/\label/\centering/ACM の\Descriptionの不足、 キャプションより前にあるラベル、非推奨のsubfigureパッケージ、 2 段組会場での 1 段組フロート内のwidth=\textwidth、ラスター画像、[h]/[H]による配置、未定義および参照されていないラベル、Figure~\refと\crefのスタイルの混在、「Figure \cref」の二重接頭辞、 cleveref の読み込み順、文頭の小文字\cref、および.log内の Overfull\hboxエントリー。 -
表を修正します — references/tables.md を参照して指摘事項に対応します。 機械的な booktabs への変換手順(セルの内容をバイト単位でそのまま保持します)を行い、 続いてページ幅の範囲内で列幅を調整します(削除 → 略記 → 数値を揃える →
\tabcolsep→tabularx→table*の順。\resizeboxは使用しません)。 -
図を修正します — references/figures.md を参照します。 幅の規則(
\columnwidth/\linewidth、複数段にまたがる場合はfigure*)、subcaptionを使ったサブ図のレイアウト、ベクター形式、プロット内のフォントサイズ、 フロートの配置を確認します。 -
キャプションと相互参照を修正します — references/captions-crossrefs.md を参照します。 系統ごとのキャプション位置/スタイルの表、内容が単独で理解できるキャプションの書き方、 cleveref の設定(最後に読み込む、
capitalise、\crefと\Crefの使い分け、 すべての箇所でスタイルを統一)を確認します。 -
色を修正します — references/color-accessibility.md を参照します。 論文で実際に使われている色を確認します(TikZ/pgfplots の定義にある 16 進数値、 または埋め込みプロットからサンプリングした値)。
python3 scripts/palettes.py check 4477AA EE6677 ... # arbitrary colors python3 scripts/palettes.py show okabe-ito --format latex|pgfplots|matplotlibcheckは 1 型色覚/2 型色覚/3 型色覚とグレースケール印刷をシミュレートし、 見分けにくい色の組み合わせを報告します(終了コード 1)。参照ファイルでは、 冗長な符号化(色だけでなく、マーカーと線種を併用すること)について説明しています。 プロットをユーザースクリプト(matplotlib/pgfplots)で生成している場合は、作図元を 編集してユーザーに再生成を依頼します。色を変更した結果だと決して主張しないでください。 -
再コンパイルしてリンターを再実行し、判定が PASS になるまで続けます(または、 残る WARN がすべて意図的で、ユーザーの承認を得た選択であることを確認します)。 その後、完全なデスクリジェクト向けリントを行うため、
preflight-checkに引き継ぎます。
出力
編集した .tex(および作図スクリプト)の変更をその場で適用し、各フロートについて、
変更内容と理由を会場の規定に言及しながら簡潔な変更ログに記載します。
さらに、最終的なリンターレポート(PASS/PASS-WITH-WARNINGS/FAIL)を提示します。
ユーザーがスタイルの抜粋(例:colors.tex のパレット用プリアンブル)を求めた場合を除き、
新しいファイルは作成しません。
分野に合わせた調整
ここに記載した規定は、CS 系の会場(ACM/IEEE/ML/LNCS)を対象としています。
別の分野向けにフォークする場合は、
references/captions-crossrefs.md のキャプション位置に関する規定と、
scripts/check_floats.py の系統マッピング(convention_label)を調整してください。
booktabs、サイズ調整、色に関する指針は、分野を問いません。
ガードレール
- データを変更しないこと:セルの値、単位、有効桁数、軸のスケール、エラーバー、凡例の意味は変更できません。再フォーマットのみ可能です。値に誤りがあるように見える場合はユーザーに伝え、「修正」しないでください。
- 会場の規則を捏造しないでください。規則の情報源は、プロフィールと現在のCFPのみです。どちらにも規則が記載されていない場合は、一般的な慣習に基づく助言であることを明示してください。
- 結果のプロットを自分で再生成したり、色を変更したりしないでください。ユーザーのプロット用ソースを編集し、ユーザー自身に再実行してもらってください。
- 最良結果を太字にする書式は、どの数値が「最良に見えるか」という判断ではなく、ユーザーが示した基準に基づいて適用してください。
- 作業中に見つかった引用の問題は
verify-citationsに回し、投稿準備の確認はpreflight-checkに回してください。ユーザーに代わって投稿しないでください。