Paper Format Agent
このスキルは、ローカルファーストの学術文書フォーマット作業に使用します。.docx形式の論文と、別途.docx、.doc、または.txt形式のフォーマット仕様を対象としています。
安全に関するデフォルト設定
- ユーザーが明示的に依頼しない限り、プライベートな論文やフォーマットガイドを外部サービスにアップロードしないでください。
- 学生の論文、原稿、査読者コメント、学校のテンプレートは機密データとして扱ってください。
- ユーザーが明示的にオプトインしない限り、学術的な内容を変更しないでください。デフォルトではフォーマットのみの変更に留めてください。
- レポートや生成されたドキュメントは、ユーザーが指定した出力ディレクトリに保存してください。
標準的なワークフロー
- 入力ファイルを確認します:
--format-file: フォーマットガイドまたはテンプレートテキスト--paper-file: ソース論文(現在は.docxのみ)--out-dir: レポートと生成ドキュメントの出力ディレクトリ
- フォーマットのみのモードでCLIを実行します:
python -m paper_format_agent.cli \
--format-file "format_guide.docx" \
--paper-file "paper.docx" \
--out-dir "./output" \
--engine auto \
--strict-required-sections
- 生成されたアーティファクトを確認します:
formatted_paper_v3.docx: 整形済みドキュメントformat_rules.json: 抽出されたルールformat_report.json: 機械可読なスコアとチェック結果format_report.html: 人間可読なレポートmodify_log.json: フォーマット操作のログengine_report.json: 後処理エンジンの結果
format_report.json内のコンテンツガードフィールドを確認します:content_changedは通常falseであるべきですcontent_guard_enforcedは通常trueであるべきです
- ルールが間違っている場合は、ルール抽出またはスコアリングロジックを更新し、最小限のテストケースを追加します。
バリデーション
作業を引き渡す前に、以下を実行します:
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を確認します。問題は以下の優先順位で対応します:
- コンテンツが予期せず変更された場合
- 必須セクションまたは見出しが誤って分類された場合
- ページ設定、余白、フォント、行間が間違っている場合
- キャプション、参考文献、表、番号付けが間違っているように見える場合
- レポートの表現やスコアの説明が不明瞭な場合
コントリビューションに適したタスク
初めてのPRとして適しているタスクは、通常以下のいずれかに該当します:
- 学校、ジャーナル、会議のフォーマットルールに対する合成テストを追加する
- スコープを限定した正規表現またはパーサーを使用して、ルール抽出プログラムを改善する
- スコアリングのセマンティクスを変更せずにレポートの明確性を向上させる
docs/regression_manifest.sample.jsonにリグレッションケースを追加する- このスキルのワークフローまたは
agents/openai.yamlメタデータを改善する