Communitygithub.com

joshua-zyy/academic-paper-writer

CS/AI/ML分野のエビデンス駆動型・セクション進行式の論文作成エージェントスキル。

academic-paper-writer とは?

このスキルは、CS(コンピュータサイエンス)/AI(人工知能)/ML(機械学習)分野における学術論文の作成プロセスを、エビデンス(証拠)に基づいてセクションごとに支援します。特に実験データの可視化に特化しており、デフォルトではPython/matplotlibによる編集可能なSVG形式でグラフを生成し、CS/AI/MLに適したグラフ設計ゲートを実行します。モデルフレームワーク図やアーキテクチャ図などの複雑な図は自動描画範囲外であり、その場合は手動作成指示や図のブループリントノートを出力します。サポートするモードには、データからのチャート作成(chart-from-data)、図の提案(figure-blueprint)、既存図の査読(figure-audit)、既存図の改訂(figure-revision)があり、各モードで成果物と品質保証レポートを提供します。

対応~Claude Code~Codex CLI~Cursor
npx skills add joshua-zyy/academic-paper-writer

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

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

ドキュメント

Academic Figure

CS/AI/ML学術図ルーター。実験データ図はデフォルトでPython/matplotlib編集可能なSVGとして納品し、CS/AI/ML図表設計ゲートを実行します。モデルフレームワーク図、アーキテクチャ図、概要図、複雑なメカニズム図は本スキルの自動描画範囲外です。論文でこれらの図が必要な場合は、手動作成要件、エビデンス一覧、キャプション草案、または図のブループリントノートのみを出力します。

ルータープロトコル

  1. manifest.yamlを読み込む。これにはalways_loadファイル、axes、references.on_demandが宣言されています。
  2. always_loadにリストされたすべてのファイルを読み込む。これらはスキルのバインディングルールであり、参照資料ではありません。
  3. 読み込んだマテリアルを制約として適用する。
    • stance.mdはPython専用プロット、図契約、ビジュアルポリシー、スコープを定義します。
    • red-lines.mdは絶対的な禁止事項を定義します。これらについては交渉しないでください。
    • output-contract.mdはモードごとの成果物を定義します。
    • anti-patterns.mdは既知の失敗モードとその正しい代替手段を定義します。
  4. マニフェストから正確に1つのmodeを選択する。曖昧な場合は、データソースまたはターゲットの用途が不足している場合にのみ、1つの簡潔な確認質問を行う。モデルフレームワーク、アーキテクチャ、概要、メカニズム図のリクエストは、manual_figure_neededノートを生成するためにのみfigure-blueprintを使用します。画像、SVG、プロンプトは決してレンダリングしないでください。
  5. 実行前に選択したモードをユーザーに通知する。
  6. references/は、マニフェストのreferences.on_demand条件が満たされた場合にのみ参照する。

モード

モード使用タイミング
chart-from-dataデータファイルや数値結果があり、CS/AI/ML図表設計ゲート付きの出版品質プロットが必要な場合
figure-blueprint論文セクションの図案提案が必要な場合
figure-audit既存図を出版準備の観点からレビューする場合
figure-revision既存図に改訂が必要な場合

エージェントディスパッチ

agents/figure_agent.mdは、ステップ6.4でオーケストレーターによってディスパッチされます。エージェントは図のアーティファクト、スクリプト、SVGパス、レポートを返します。プロジェクトのソースコードや実験データを独自に編集してはなりません。

完了基準

  • chart-from-data: 図契約、CS/AI/ML図表設計ゲート、Pythonスクリプト、ソースデータ、編集可能SVG、QAレポート — すべて合格。
  • figure-audit: すべてのQA項目に合格/不合格ステータスと具体的な改善策が付与されていること。
  • figure-blueprint: 提案されたすべての図が論文の主張とデータ/エビデンスソースにマッピングされていること。
  • figure-revision: 改訂されたアーティファクトまたは指示、QAレポート、変更されていないエビデンスのトレーサビリティが維持されていること。

関連スキル