論文ポリッシャーは何をしますか？

適用範囲と参照

このスキルは、TeXセーフな学術英文のポリッシュ、翻訳、校正、ソースから出力への検証、用語・表記のレビュー、数値一貫性レビュー、および明示的に許可された表記の正規化に使用します。

完全な論文、長いセクション、検証、一貫性監査、正規化、または厳格なスタイルガイドの作業については、行動を起こす前に references/tex_safe_polishing.md を読んでください。中国語を対象としたワークフローガイダンスが実質的に有用な場合は、代わりに references/tex_safe_polishing_zh.md を読んでください。単にコンテキストを重複させるために両方をロードしないでください。短いローカルポリッシュの場合は、以下のコアルールを使用し、必要な場合にのみ参照を参照してください。

以下の目的でこのスキルを主要ツールとして使用しないでください：

新規性、貢献の防御可能性、危険なベースライン、または査読者からの攻撃の監査。利用可能な場合は idea-novelty-auditor を使用してください。
文献レビュー、ギャップのフレーミング、参考文献の選択、または引用の役割の割り当て。利用可能な場合は problem-driven-literature-review を使用してください。
広範なストーリーライン、導入部の構造、または実験から主張への再設計。利用可能な場合は paper-argument-reconstructor を使用してください。

リクエストにこれらのタスクとポリッシングが組み合わされている場合は、最初に上流の推論タスクを完了し、最終的な忠実な言語と一貫性のパスにのみこのスキルを使用してください。

モード選択と優先順位

誰が入力を生成したかを考慮する前に、ユーザーの明示的な要求アクションに従ってください。出典情報だけで、ポリッシュ、監査、検証、または正規化の明示的なリクエストを上書きすることはありません。複数のアクションが要求された場合、ユーザーが統合された成果物を要求しない限り、それぞれの成果物とレポートは分離したままにしてください。

モード固有の出力ルールは、ドキュメントの長さに基づく出力ルールよりも優先されます。特に、完全な原稿の検証や一貫性のみの監査は、レポートのみのままです。

ユーザーが表記の正規化と散文のポリッシュの両方を要求した場合は、最初に正規化を実行して承認し、正規化されたTeXを新しいベースラインとして扱い、そのベースラインに対してポリッシュを実行してください。散文と記号の変更を組み合わせたものを1つの正規化比較として検証しようとしないでください。

デフォルトのポリッシュモード

提供されたテキストを、保護されたすべての要素を保持しながらポリッシュまたは翻訳します。完全な原稿の場合は、用語、表記、およびソース内の数値一貫性監査も実行し、ソースレベルの問題を報告しますが、黙って修正はしません。

検証モード

ユーザーが候補をオリジナルと比較または品質チェックするよう要求した場合は、検証モードを使用します。

TeX、数式、数値、単位、符号、引用、技術的意味、または主張の強さに関するすべての比較判断には、オリジナルと候補の両方が必要です。
オリジナルが利用できない場合は、候補の固有の特性のみを検査し、ソース比較チェックはすべて NOT ASSESSED とマークします。候補のみから保存状態を推測しないでください。
検証モードでは、ハードルール違反を含め、候補を書き換えたり修正したりしないでください。各逸脱とその場所を報告してください。修正は、別途明示的に要求された編集ターンまたはモードでのみ適用してください。
候補によって導入された逸脱と、ソースにすでに存在する用語、表記、または数値の矛盾を区別してください。

一貫性監査モード

ユーザーが用語、変数、記号、表記、または数値の一貫性のみを要求した場合は、原稿を書き換えないでください。利用可能な範囲を監査し、該当する TERM-*、SYM-*、および NUM-* の発見事項を報告してください。ソーステキスト、記号、値、単位、および符号は変更しないでください。

承認された表記正規化モード

このモードは、ユーザーが明示的に正規化を要求し、正確な記号マッピングを承認した場合にのみ使用してください。承認されたマッピングは、数学的エンティティ、新旧の記号、影響を受ける範囲または場所、および意図的なエイリアスや除外を特定する必要があります。

承認された記号置換のみを適用してください。定義を再解釈したり、ユーザーに代わって標準記号を選択したりしないでください。
適用されたすべての置換を AUTHORIZED CHANGE として記録してください。マッピングされていない数式、構造、テキスト、または数値の違いはすべてエラーとして扱ってください。
すべての数値、単位、パーセンテージ、寸法、サンプルサイズ、数値トークンの順序、および正、負、またはプラスマイナス記号は変更しないでください。
影響を受ける記号が、利用不可または編集不可能な図アセット、カスタム環境、生成ファイル、または未解決のマクロ展開内で発生した場合は、未解決の場所を報告し、完全な正規化を主張しないでください。
正規化された結果を承認されたマッピングに対して検証してください。マッピング認識比較が利用できない場合は、正規化されたTeXを新しい著者承認ベースラインとして承認を得て、その後のすべてのポリッシュにはそのベースラインに対する厳密な比較を使用してください。

--allow-additions を使用して記号変更を許可しないでください。このスキルでは、NUM-* の矛盾を報告した後でも、どのポリッシャーモードでも数値、単位、または数値記号を変更しないでください。ユーザーにこのスキルの外部でソースを修正し、修正されたTeXを新しい著者承認ベースラインとして提供するように依頼してください。置換値を推測したり適用したりしないでください。

共有カバレッジと結果プロトコル

用語、表記、および数値一貫性監査のそれぞれについて、カバレッジと結果を別々に報告してください。

Coverage: FULL MANUSCRIPT は、以下の完全性ゲートが合格したことを意味します。
Coverage: PARTIAL は、記載されたローカルまたは解決可能な範囲のみが監査されたことを意味します。
Result: PASS は、評価範囲内で矛盾または未解決の曖昧さが見つからなかったことを意味します。
Result: ISSUE REPORTED は、少なくとも1つの明確な矛盾が見つかり、著者の判断を必要とする発見事項が残っていないことを意味します。
Result: AUTHOR DECISION REQUIRED は、少なくとも1つの可能性のある発見事項が原稿だけでは解決できないことを意味します。確認された問題は、個別に ISSUE REPORTED とラベル付けされたままです。
Result: NOT ASSESSED は、その監査または比較がまったく実行できなかったことを意味します。カバレッジが部分的であるという理由だけでこれを使用しないでください。

発見事項の識別子は、ルート相対ファイルとソース順に決定論的に割り当ててください：TERM-001、SYM-001、NUM-001。各発見事項には、ファイルが利用可能な場合は正確なファイルと行の場所を提供し、それ以外の場合は利用可能な最も安定したセクション、式、表、アルゴリズム、キャプション、または引用テキストアンカーを使用してください。

確認された矛盾には ISSUE REPORTED を使用してください。証拠によって、比較された使用法が同じエンティティ、概念、数量、または実験条件を参照しているかどうか、あるいはそれらの違いが意図的であるかどうかを確立できない場合は AUTHOR DECISION REQUIRED を使用してください。矛盾の確実性と是正は別にしてください。確認された矛盾は、著者が依然として置換用語、記号、または値を選択しなければならない場合でも ISSUE REPORTED のままです。

完全原稿完全性ゲート

以下のすべてが真である場合にのみ、FULL MANUSCRIPT カバレッジを主張してください：

信頼できるルートTeXファイルを特定し、ドキュメント順に静的に到達可能なすべての \input、\include、\subfile、\import、および同等のインクルードを解決する。
欠落している、条件付きの、マクロ生成された、生成された、または循環するインクルード、およびすべての表記を含む付録や補足を考慮する。
表記を生成するユーザーマクロとカスタム数式環境を検査する。それらを展開または理解するために保存スクリプトパスに依存しないでください。
散文、式、アルゴリズム、キャプション、表、および提供された図アセット内の表記と数値の主張を検査する。アセットに関連する埋め込みテキストが含まれているが検査できない場合、カバレッジは部分的です。正規化が図に影響を与えるが、編集可能なソースが利用できない場合、正規化は不完全です。
発見事項のルート相対ファイルと行の場所を保持し、要求された範囲がスキップされていないことを確認する。

いずれかの条件が失敗した場合、カバレッジギャップを述べ、Coverage: PARTIAL を使用してください。完全なファイルアップロード自体は、分析カバレッジの完全性を確立するものではありません。

交渉不可能なルール

TeX構造、環境、引用、ラベル、参照、参考文献キー、関数名、モジュール名、データセット名、メトリック名、および技術的意味を保持してください。
\label{...}、\ref{...}、\eqref{...}、\includegraphics{...}、引用コマンド、\bibitem{...}、BibTeXキーなどの構造コマンド内の正確な引数とキーを保持してください。名前を変更したり、マージしたり、削除したり、並べ替えたり、正規化したりしないでください。
コメントおよびリテラルまたはコードのようなソース（comment、verbatim、リスト環境、インラインリテラルコマンドを含む）は、すべてのモードで正確に保護されたソースとして扱ってください。散文をこれらの領域に移動したり、領域から移動したり、インラインコメントを行全体のコメントに変更したり、保護された数式やTeX構造を横切って移動したりしないでください。
ポリッシュ、翻訳、散文追加、検証の際に、すべての元の数式領域とそのドキュメント順を保持してください。唯一の例外は、著者が承認した表記マッピングにリストされた正確な置換です。
ポリッシュ、翻訳、散文追加、検証、一貫性監査、および表記正規化の際に、すべての数値、単位、パーセンテージ、寸法、パラメータ、サンプルサイズ、テーブル値、図報告値、有意性マーカー、数値トークンの順序、および正、負、またはプラスマイナス記号を保持してください。これには、識別子に埋め込まれた数字や、コメント、リテラル例、URL、または保護されたコマンド引数内の数値トークンが含まれます。このスキルには数値編集の例外はなく、--allow-additions はこのルールを緩和しません。
ソースから出力への保存とソース内の一貫性は別々のチェックとして扱ってください。ソース内の用語、記号、値、単位、または記号の矛盾は発見事項であり、編集の許可ではありません。
このスキルで疑わしい値を修正しないでください。NUM-* の発見事項を報告した後、ユーザーに外部でソースを修正し、著者承認ベースラインを返すように依頼してください。
数学的定義、定理条件、証明ロジック、アルゴリズムステップ、実験設定、報告された結果、ベースライン、またはデータセットを変更しないでください。
このスキルで参考文献レコードまたは識別子を変更しないでください。参照クリーンアップリクエストは、別の保護ルールと矛盾しない、数値以外の識別子以外のメタデータ編集のみを許可する場合があります。年、ページ、巻、号番号、DOI/URL/arXiv識別子、およびその他のすべての数値トークンは、paper-polisherの外部で修正し、著者承認ベースラインとして返す必要があります。
主張、実験、保証、展開価値、限界、または結論を発明しないでください。
単に文体の多様性のために技術用語を変更しないでください。エンティティマッピングがサポートされている場合にのみ、標準用語を使用してください。
保護されたコンテンツを変更せずに、文の冒頭、節の順序、態、接続、段落構造の機械的な繰り返しを避けてください。
著者が書いた原稿散文でダッシュ区切りを使用しないでください。語彙上のハイフン、数学のマイナス記号、符号付き値、保護されたキー、URL、DOI文字列、ファイル名、引用キー、参考文献メタデータは正確に保持してください。

要求された編集がこれらのルールに違反し、正確な承認されたマッピングによってカバーされていない場合は、その編集を停止し、不足している承認またはソース情報を報告してください。あなた自身のドラフトがルールに違反している場合は、返却する前に修正してください。

ワークフロー

ユーザーの明示的な意図からモードを選択し、提供された範囲を特定する。
完全な原稿の作業には、完全性ゲートを適用し、解決されたドキュメント順を保持する。
関連する台帳を構築する：
- 用語：エンティティ、標準用語、許可された文脈形式、定義、および場所。
- 表記：数学的エンティティ、記号、定義と使用法、範囲、タイプまたは次元、フレーム、およびエイリアス。
- 数値：測定または設定された数量、値、単位、符号、条件、ソースの場所、および対応する散文/表/図での使用法。
ポリッシュモードでは、保護された数式と数値トークンの順序を固定したまま散文を修正する。節や文を並べ替えるのは、保護された数式、数値、単位、または符号の順序が変わらない場合のみ。
双方向の一貫性チェックを実行する：エンティティから用語または記号へ、用語または記号からエンティティへ、および数量または実験条件から報告された値、単位、符号へ。
評価範囲全体にわたって、文構造、ダッシュなしの散文、客観的なトーン、および主張の境界のチェックを実行する。
オリジナルファイルと候補ファイルが利用可能な場合は、保存チェッカーを実行する。複数ファイルの原稿にはプロジェクトモードを使用する。
モード固有の出力を返し、承認された変更、ソースレベルの発見事項、候補によって導入された逸脱、および評価されなかったチェックを区別する。

保存チェッカー

1つのオリジナルと候補のTeXファイルについて、厳密な比較を実行します：

python3 paper-polisher/scripts/check_preservation.py original.tex candidate.tex

--allow-additions は、ユーザーが通常の散文追加を承認した場合にのみ使用します：

python3 paper-polisher/scripts/check_preservation.py original.tex candidate.tex --allow-additions

このオプションは、新しい構造キー、数式領域、数値トークン、単位、または記号の追加、削除、変更、または並べ替えを許可しません。認識されたコメントおよびリテラルまたはコードのような領域は、インライン対行全体のコメント境界と、保護された数式およびTeXに対するそれらの順序を含め、正確に保護されたソースのままです。カスタムまたは認識されないリテラルマクロは手動で比較してください。新しい図、表、式、参照、画像アセット、または記号マッピングは許可されません。意図的な保護された構造変更については著者承認ベースラインを確立するか、数値コンテンツをpaper-polisherの外部で修正する必要があった場合は、外部で修正され著者承認されたTeXを新しいベースラインとして使用してください。

複数ファイルの原稿の場合は、2つの信頼できるルートTeXファイルを渡し、プロジェクトトラバーサルを有効にします：

python3 paper-polisher/scripts/check_preservation.py original/main.tex candidate/main.tex --project

プロジェクトモードは、各ルートから静的に到達可能な \input、\include、\subfile、\subfileinclude、\import、\subimport、\inputfrom、\subinputfrom、\includefrom、および \subincludefrom ディレクティブを解決します。

論文ポリッシャー