Communitygithub.com

論文フォーマットエージェント

学術論文のDOCXフォーマットを行うエージェントスキルです。コンテンツフィンガープリントガードにより、テキスト内容は変更せず、書式のみを変更することを保証します。エージェントスキルとしてもインストール可能です。

論文フォーマットエージェント とは?

Paper Format Agent は、ローカルファーストで学術文書のフォーマット作業を行うためのスキルです。`.docx`形式の論文と、フォーマット仕様が記載された`.docx`、`.doc`、または`.txt`ファイルを入力として受け取り、論文の内容を一切変更せずに書式(余白、フォント、行間、セクション構成など)のみを整形します。このスキルの最大の特徴は**コンテンツフィンガープリントガード**であり、出力レポート内の`content_changed`フィールドが`false`であることで、テキスト内容が改変されていないことを確認できます。CLI経由で実行し、整形済み文書、書式ルール、スコアレポート、変更ログなどを出力ディレクトリに生成します。開発者向けには、ルール抽出ロジックの改善や合成テストの追加などのコントリビューションが可能です。

対応~Claude Code✓Codex CLI~Cursor
npx skills add zxyasfas/paper_format_agent

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

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

ドキュメント

Paper Format Agent

このスキルは、ローカルファーストの学術文書フォーマット作業に使用します。.docx形式の論文と、別途.docx、.doc、または.txt形式のフォーマット仕様を対象としています。

安全に関するデフォルト設定

  • ユーザーが明示的に依頼しない限り、プライベートな論文やフォーマットガイドを外部サービスにアップロードしないでください。
  • 学生の論文、原稿、査読者コメント、学校のテンプレートは機密データとして扱ってください。
  • ユーザーが明示的にオプトインしない限り、学術的な内容を変更しないでください。デフォルトではフォーマットのみの変更に留めてください。
  • レポートや生成されたドキュメントは、ユーザーが指定した出力ディレクトリに保存してください。

標準的なワークフロー

  1. 入力ファイルを確認します:
    • --format-file: フォーマットガイドまたはテンプレートテキスト
    • --paper-file: ソース論文(現在は.docxのみ)
    • --out-dir: レポートと生成ドキュメントの出力ディレクトリ
  2. フォーマットのみのモードでCLIを実行します:
python -m paper_format_agent.cli \
  --format-file "format_guide.docx" \
  --paper-file "paper.docx" \
  --out-dir "./output" \
  --engine auto \
  --strict-required-sections
  1. 生成されたアーティファクトを確認します:
    • formatted_paper_v3.docx: 整形済みドキュメント
    • format_rules.json: 抽出されたルール
    • format_report.json: 機械可読なスコアとチェック結果
    • format_report.html: 人間可読なレポート
    • modify_log.json: フォーマット操作のログ
    • engine_report.json: 後処理エンジンの結果
  2. format_report.json内のコンテンツガードフィールドを確認します:
    • content_changed は通常 false であるべきです
    • content_guard_enforced は通常 true であるべきです
  3. ルールが間違っている場合は、ルール抽出またはスコアリングロジックを更新し、最小限のテストケースを追加します。

バリデーション

作業を引き渡す前に、以下を実行します:

python tools/validate_skill.py
python -m unittest discover -s tests -p "test_*.py"
python tools/compile_check.py
python tools/release_audit.py

テンプレートサポートを追加する場合

  • 動作を再現するために必要な最小限の代表的なルールテキストを追加します。
  • LLMのみによる解釈よりも、決定論的なルール抽出を優先します。
  • 抽出された余白、フォントサイズ、行間、必須セクション、見出し、キャプション、参考文献のテストを追加します。
  • 実際の学生文書をコミットしないでください。合成テキストまたは匿名化されたフィクスチャを使用します。

出力をレビューする場合

最初にformat_report.jsonを読み、ユーザーが人間可読なサマリーを必要とする場合はformat_report.htmlを確認します。問題は以下の優先順位で対応します:

  1. コンテンツが予期せず変更された場合
  2. 必須セクションまたは見出しが誤って分類された場合
  3. ページ設定、余白、フォント、行間が間違っている場合
  4. キャプション、参考文献、表、番号付けが間違っているように見える場合
  5. レポートの表現やスコアの説明が不明瞭な場合

コントリビューションに適したタスク

初めてのPRとして適しているタスクは、通常以下のいずれかに該当します:

  • 学校、ジャーナル、会議のフォーマットルールに対する合成テストを追加する
  • スコープを限定した正規表現またはパーサーを使用して、ルール抽出プログラムを改善する
  • スコアリングのセマンティクスを変更せずにレポートの明確性を向上させる
  • docs/regression_manifest.sample.jsonにリグレッションケースを追加する
  • このスキルのワークフローまたはagents/openai.yamlメタデータを改善する

関連スキル