物理学論文編集 — セクション は何をしますか?
物理学セクション全体(任意の長さ)、テクニカルノート、または12タイポグラフィ文を超える物理学パッセージ(LaTeX、Markdown、プレーンテキスト)に使用します。より短い非セクションパッセージには直接 physics-paper-editing を使用してください。正準規範は physics-language-principles です。
すべてのレガシー/バージョン1セッションはクローズされた履歴記録です。これらを再開したり、現在の完了に向けたチェックに計上したりしないでください。新しいパスまたは繰り返しのパスはすべて、独自のラウンド識別子とソーススナップショットを持つバージョン2編集ラウンドとして開始されます。disk-layout.md を参照してください。
読み取り順序
- 最初のユーザー向け応答の前に、マイクロスキルの runtime-contract.md と user-communication.md を読みます。以降のユーザー向け応答の前には、コミュニケーションポリシーに従います。
- 再開時には、
CURRENTを通じてアクティブなバージョン2ラウンドを解決し、そのラウンドのsession.mdを読み、次に cross-skill.md を読みます。再開の自動化境界については、automation.md も読みます。 - stages.md と disk-layout.md を読みます。
- チャンク編集の前に、chunk-contract.md とアクティブなマイクロ SKILL.md を読みます。
- ステージBまたはEのレビューのために、scope-and-verifiers.md を読みます。プロジェクトに判定ファイル(rulings file)がある場合は、rulings-file.md も読みます。
- 完了前に、test-checklist.md を読みます。
基本設計
セクションは、ローカルの散文が最適化される前に、グローバル物理スパイン(global physics spine) と グローバルオブジェクト台帳(global object ledger) を中心に整理されます。すべてのチャンクはこれらを継承します。チャンクは、グローバル台帳と調整することなく、競合する正規化、因子規則、重複する記号、または変更されたスコープを導入してはなりません。
チャンク分割は、注意と永続性のメカニズムに留まります。強力なセクションエディタはチャンクを直接作成できます。エコノミーなエディタや未知のエディタはスキャフォールドを使用します。各通常チャンクは、マイクロスキルの direct | reviewed 契約を使用します。ソースフォーマットセーフな単位で13文未満に分割できないものは、セクション所有の特大チャンクとして扱われ、定義や方程式の境界を侵害することなく、直接レビュー契約を使用します。
すべてのチャンクは、セクションで確立された用語と表記法を保持しなければなりません。チャンクの組み立ては、names-and-symbols.md で許可され、意図的に調整されない限り、ソースとグローバルコンテキストに存在しなかった新しい短縮ラベル、数学的別名、または重複する名前を導入してはなりません。
ステージ
| ステージ | 成果物 |
|---|---|
| A | バージョン2ラウンド、不変ソース、編集意図、言語カバレッジ、ロール対モデルポリシー、セクションスコープ |
| B | セクション物理スパイン、段落マップ、グローバルオブジェクト台帳、構造計画 |
| C | ソースフォーマットセーフな引数チャンク(通常最大12文)、定義された特大単位フォールバック付き |
| D | チャンクごとの直接またはレビュー編集。グローバル台帳は意図的に更新 |
| E | セクション全体の物理ストーリー、オブジェクト一貫性、形式的レビュー:最大2ラウンドの独立ブラインドレビューア、統合および裁定 |
1文あたり1人のレビューアを起動しないでください。レビューチャンクでは、1つの全体文レビューアと1つの用語・表記法レビューアに加え、必要に応じて専門家を起動します。 低リスクの直接チャンクにレビューアを要求しないでください。必要な品質軸に失敗したスパンのみ再開します。
最初のユーザー向け応答では、マイクロスキルの ランタイム契約 に従います。進行中のプロジェクトまたは会話のロール対モデルポリシーが存在する場合は、そのマッピングを宣言し、確認を求めずに続行します。それ以外の場合は質問して待機します。アクティブなマッピングを session.md に記録し、すべてのチャンクとセクション全体のレビューに渡します。チャンクは再度質問しません。
各ラウンドは language_coverage: selective | exhaustive も宣言します。選択的カバレッジは、変更された文または診断された文とチャンクレベルの散文を監査します。網羅的カバレッジは、現在のすべてのチャンク内のすべての文に現在のスナップショットの言語判定を与えます。古いチャンクアーティファクトの存在だけで網羅的カバレッジを推測しないでください。要求されたカバレッジが曖昧な場合は質問してください。詳細はマイクロスキルの language-coverage.md を参照してください。
カバレッジは文を選択し、原則を選択しません。スコープ内のすべての文は16の文チェックすべてを受け、新しくドラフトされたテキスト内のすべての文は変更されたものとしてカウントされます。
永続性
セクションの作業は通常再開可能であるため、各バージョン2ラウンド、その不変の元のセクションテキストと境界、現在の候補、ブリーフ、コンテキストリビジョンとオブジェクト台帳リビジョン、チャンクマニフェスト、ハッシュ、品質結果を、disk-layout.md で指定されているように .physics-edit/ の下に永続化します。履歴ラウンドは不変の証拠として残り、後のラウンドを満たすことはありません。
ユーザー向け言語
永続化された記録では、正確なバージョン、ラウンド、スナップショット、ルーティング、ステータスの語彙を保持します。これは正確性のために必要です。会話では、共有の ユーザーコミュニケーションポリシー に従います。何が起こっているかを日常言語で説明し、内部ラベルを提示する場合は、それが著者のテキストにとって何を意味するかを即座に説明します。
コンプライアンスゲート
ラウンドのブックキーピングはプログラム scripts/check_edit_round.py です(python3 で実行。パッケージは不要。--root のデフォルトは現在のgitリポジトリのトップレベル)。これは文ごとの判定を保持し、表示するテキストのハッシュを含むレビューアパケットを発行し、レビューアレポートを記録し、check でラウンドが準備完了として報告できるかを判断します。LLMを呼び出さず、原稿テキストを変更しません。リポジトリルートのプロジェクトのロール対モデルポリシーは、アクティブなホストプラットフォーム用の physics-edit-policy-<platform>.json です(例:Antigravityでは physics-edit-policy-antigravity.json、Claude Codeでは physics-edit-policy-claude.json。ホスト環境から自動選択、または --platform <platform> で指定)。フォールバックは physics-edit-policy.json です。スキルはデフォルトを保存しないため、欠落している場合は所有者に質問し、policy set(または policy set --platform <platform>)で回答を書き込みます。
リポジトリに project-vocabulary.json があり、兄弟スキル physics-vocabulary がインストールされている場合、check はレビューされたすべての文(キャプションを含む)を、レジストリ全体の avoid_names についてスキャンします(コメント、ラベル、パスは読み取られません)。ヒットがあった場合、文が修正されるか、単語が登録された概念を指していない場合に waive --roles terminology が理由を記録するまで、ラウンドをブロックします。ヒットをチャンクの用語レビューアに渡します。文レビューアと用語レビューアのパケットには、チャンクの前の段落全体と、scripts/check_prose_patterns.py のチャンクに関するアドバイザリレポートも含まれます。ステージEのホリスティックパケットにはテキスト全体のレポートが含まれます。レビューアはその候補を確認または却下します。レポート自体がラウンドをブロックすることはありません。各パケットは、そのチャンクの段落マップの行を含みます(ステージEではマップ全体)。リポジトリに RULINGS.md がある場合、digest と stage-e merge はラウンドごとに一度それを印刷し、所見を評価するエージェントに渡します。digest --rulings は再開後にもう一度印刷します。レビューアパケットにはそれを含めません。
コマンド: policy, init, chunks, rechunk, pending, prompt, record, digest, waive, stage-e, status, snapshot, defect, revision, gc, check(--help でオプション一覧)。以下のタイミングで実行します。Must とある場合、そのコマンドを実行しないとプログラムが次のステップを拒否するか、check が失敗します。
| # | タイミング | 実行 | 備考 |
|---|---|---|---|
| 1 | ラウンド開始 | policy show(欠落時:所有者に質問→policy set)、init、ブリーフ・段落マップ・台帳の記入、check | must: ポリシー、init;should: check(ブリーフ・段落マップ・台帳・証明書のみがオープンであるべき) |
| 2 | 新しいセッションまたはコンパクション後の再開 | status, pending, digest --rulings, check | must。status で発行済み未記録のパケットを一覧:新しいものを起動する前に記録または破棄 |
| 3 | 箇条書きの分割・マージ・移動・追加 | rechunk, chunks | must。すでに半分以上の文がレビュー済みのチャンクはIDを維持 |
| 4 | 各編集バッチ後、エディタ自身のカノンチェック完了後 | record --role editor_closure、続けて digest(受け入れられた所見は未適用であってはならない)、pending, prompt | must: クロージャ(prompt はそれがなければ拒否)。適用しないことを決定したFIX:waive --reason |
| 5 | レビューアの起動 | prompt が印刷するモデルと努力量 | must |
| 6 | レビューア結果 | record --packet pNNN --report FILE --model M --effort E | must。モデル、努力量、リビジョン、スコープ内の全文に対する判定を強制。パケット発行後に変更された文は報告されるが拒否はされない:その判定は単に一致しなくなる |
| 7 | 原則ヒット FIX を含む文レビュー | 修正前に prompt --role specialist --principles ... | must(ゲートはヒットごとに専門家を必要とする) |
| 8 | バッチ記録 | pending, digest;すべての story_check を判断、その後行4に従って編集 | should |
| 9 | チャンク内に保留なし | 文レビューアと用語レビューアのために prompt --scope close、その後行4〜8による修正 | must: check にはロールごとのクローズレビューが必要。選択的カバレッジで変更されていないチャンクは除く |
| 10 | 最終編集後 | snapshot | must(スナップショットがライブテキストと一致するまで check は失敗) |
| 11 | ステージE前 | check がチャンクIDで始まる行を表示しないこと | must: そうでなければ `prompt --role holistic |
| 12 | ステージEラウンド(最大2回) | レビューア1人につき prompt --role holistic と --role formal を1回ずつ(ラウンド1ではロールあたり3人、ラウンド2では2人、プログラムはそれ以上を拒否)。それぞれ新しいエージェントとして起動し、印刷された行のみを取得。各 record --packet。stage-e merge。`stage-e rule --cluster K.. --as applied | waived |
| 13 | 所有者の裁定、ステージEの修正、チャンク間の移動 | 欠陥が記録された場合は defect rule。ブラスト半径については pending。判定ファイルを更新(rulings-file.md)。スパイン、台帳、またはレビューアが判断する規則が変更された場合のみ revision --yes | must: defect rule。バンプは現在のすべての判定を印刷して破棄し、まだ発行中のパケットを拒否。台帳、ブリーフ、または reviewer-context.md の編集がバンプなしの場合、パケット記録時に警告のみ |
| 14 | 所有者への報告前 | check;その最終行を引用;「スキルからの逸脱:」で締めくくる | must |
| 15 | ラウンド終了時、またはディスク使用について尋ねられた時 | gc | should。保持期間を過ぎたラウンドを一覧表示し、削除はしない。gc --compact は期限切れラウンドの大部分(生レポート、パケット、文マップ、スナップショット)を削除し、所有者の同意がある場合のみ実行 |
完了
セクションが準備完了となるのは、すべてのチャンクが統合され、必要なすべての結果が現在のチャンクおよびセクションスナップショットと一致し、宣言された言語カバレッジが完了し、チャンクの必要な品質軸が FIX または USER_DECISION でなく、ステージEが裁定された場合のみです。最大2ラウンドの独立ブラインドレビューア、すべてのmustクラスターが適用または免除され(オープンなし、所有者に延期なし)、検証の独立性はコンテンツ品質とは別に記録されます。
要求されたタスクがすでに修正を許可していない、著者のソース内の科学的欠陥は、quality-contract.md のルールに従います。defect add で記録し、それに依存しないチャンクの作業を続け、著者が裁定するまでラウンドを needs_user のままにします。欠陥を完了時の制限に変換しないでください。
関連スキル
- physics-paper-workflow — 論文全体のマスターレシピとステージマップ
- physics-paper-outline — アウトライン、4段落の序論フォーミュラ、本文と付録の境界
- physics-paper-framing — 抄録、要約段落、結論と序論の整合性
- physics-language-principles — 草稿およびレビューのカノン
- physics-paper-editing — 最大12文のパッセージ、およびすべてのチャンク
- physics-paper-author-read — 著者自身の編集とマージンコメントへの応答。その言語はこのスキルを経由する
範囲外
- 最大12文の非セクションパッセージ
- 欠落した物理的意味の創作
- チャンク境界をグローバルオブジェクトのローカル再定義の許可として扱うこと
- レガシー/バージョン1セッションの再開または再活性化