物理論文編輯 — 章節 是做什麼的？
適用於任何長度的完整物理章節、技術筆記，或任何超過 12 個印刷句子的物理段落，無論是 LaTeX、Markdown 或純文字格式。對於較短的、非章節的段落，請直接使用 physics-paper-editing。正典（Canon）為 physics-language-principles。
所有舊版/第 1 版的工作階段均為已關閉的歷史記錄。切勿恢復它們，或將其檢查計入當前的完成進度。每一個新的或重複的編輯次（pass）都會啟動一個第 2 版編輯輪次（round），並附帶其自己的輪次識別碼和原始碼快照；請參閱 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。
主導設計
章節的組織圍繞著一個全域物理主幹和一個全域物件分類帳，在優化局部行文之前建立。每個區塊都繼承它們。一個區塊不得引入與全域分類帳衝突的競爭性標準化、因子慣例、重複符號或改變的作用域，除非已與全域分類帳協調一致。
分塊（Chunking）仍然是一種注意力與持久性機制。一位經驗豐富的章節編輯可以直接編寫區塊；一位較不熟悉或未知的編輯則應使用腳手架（scaffold）。每個一般區塊使用微技能的 direct | reviewed 合約。一個無法分割成少於 13 個句子的、原始格式安全的單位，將保留為一個章節所擁有的超大區塊，並直接使用 reviewed 合約，而不是違反定義或方程式邊界。
每個區塊必須保留章節既定的術語和符號標記法。區塊組裝不得引入原始碼和全域上下文中不存在的新簡稱、數學別名或重複名稱，除非 names-and-symbols.md 允許，並且經過審慎協調。
階段
| 階段 | 產出 |
|---|---|
| A | 第 2 版輪次、不可變的原始碼、編輯意圖、語言覆蓋範圍、角色到模型政策、章節範圍 |
| B | 章節物理主幹、段落對應、全域物件分類帳、結構規劃 |
| C | 原始格式安全的論證區塊，通常最多 12 個句子，並定義超大單元的備用方案 |
| D | 每個區塊進行直接或審查編輯；全域分類帳經過審慎更新 |
| E | 章節層級的物理敘事、物件一致性與形式審查：最多兩輪獨立的盲審，結果合併與裁決 |
請勿為每個句子啟動一位審查員。一個被審查的區塊使用一位全文句審查員和一位術語與符號標記法審查員，並可觸發專家審查員。 對於低風險的直接編輯區塊，不需要審查員。僅重新打開那些未能通過所需品質面向的範圍。
在首次回覆使用者時，請遵循微技能的 runtime contract。如果存在現有的專案或對話角色到模型政策，請陳述其對應關係，並繼續執行，無需請求確認。否則，請詢問並等待。將活躍的對應關係記錄在 session.md 中，並將其傳遞給每個區塊和章節層級的審查。區塊不會再次詢問。
每個輪次也需聲明 language_coverage: selective | exhaustive。選擇性覆蓋僅審計已更改或被診斷為有問題的句子，以及區塊層級的行文。全面覆蓋則為每個當前區塊中的每個句子提供當前快照的語言判定。請勿僅因為存在舊的區塊工件就推斷為全面覆蓋；當要求的覆蓋範圍不明確時，請詢問。詳細資訊請參閱微技能的 language-coverage.md。
覆蓋範圍選擇的是句子，而非原則。每個在範圍內的句子都會接受所有 16 項句子檢查，而新起草文字中的每個句子都視為已更改。
持久性
章節工作通常是可恢復的，因此請將每個第 2 版輪次、其不可變的原始章節文字與邊界、當前候選版本、簡報、語境修訂版與物件分類帳修訂版、區塊清單、雜湊值以及品質結果，持久化儲存在 .physics-edit/ 目錄下，具體規範請參閱 disk-layout.md。歷史輪次保持為不可變的證據，且永遠不能用於滿足後續輪次的需求。
面向使用者的語言
在持久化記錄中，請確切保留版本、輪次、快照、路由和狀態詞彙，因為這些是正確性所需的。在對話中，請遵循共用的 user-communication policy：以日常語言描述正在發生的事情，切勿在未立即解釋其對作者文字之意義的情況下，使用內部標籤。
合規閘道
一個輪次的帳務管理由一個程式 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 會每個輪次列印一次，供權衡結果的代理（agent）使用；digest --rulings 會在恢復工作階段後再次列印。沒有任何審查員資料包會攜帶它。
指令：policy、init、chunks、rechunk、pending、prompt、record、digest、waive、stage-e、status、snapshot、defect、revision、gc、check（--help 列出所有選項）。請在以下時刻執行這些指令。必須表示若不執行，程式將拒絕下一步，或者 check 會失敗。
| # | 時刻 | 執行 | |
|---|---|---|---|
| 1 | 輪次開始 | policy show（若遺失：詢問擁有者，然後 policy set）、init、填寫簡報、段落對應與分類帳、check | 必須：policy、init；應該：check（僅簡報、段落對應、分類帳和證明應為開啟狀態） |
| 2 | 在新工作階段或壓縮後恢復 | status、pending、digest --rulings、check | 必須。status 會列出已發出但尚未記錄的資料包：在啟動新的資料包之前，請先記錄或放棄它們 |
| 3 | 某個條目被分割、合併、移動或新增 | rechunk、chunks | 必須。一個至少有半數句子已被審查的區塊，將保留其 id |
| 4 | 每次編輯批次後，在編輯者自身的正典檢查完成後 | record --role editor_closure，然後 digest（不得有未應用的已接受發現）、pending、prompt | 必須：閉合（prompt 在沒有閉合的情況下會拒絕）。一個你決定不應用的 FIX：waive --reason |
| 5 | 啟動審查員 | prompt 列印的模型和努力程度 | 必須 |
| 6 | 審查員結果 | record --packet pNNN --report FILE --model M --effort E | 必須。它會強制檢查模型、努力程度、修訂版本以及對每個範圍內句子的判定。自資料包發出後已更改的句子會被報告，但不會被拒絕：它們的判定僅僅不再匹配 |
| 7 | 句子審查中有原則命中 FIX | 在修復之前執行 prompt --role specialist --principles ... | 必須（閘道每次命中都需要一位專家） |
| 8 | 記錄了一個批次 | pending、digest；決定每個 story_check，然後在第 4 行下編輯 | 應該 |
| 9 | 某個區塊沒有待辦事項 | 對句子審查員和術語審查員執行 prompt --scope close，然後進行第 4 到第 8 行的修復 | 必須：check 需要每個角色都有一個關閉的審查，但選擇性覆蓋下保持不變的區塊除外 |
| 10 | 最後一次編輯後 | snapshot | 必須（check 會失敗，直到快照等於即時文字） |
| 11 | 階段 E 之前 | check 顯示沒有以區塊 id 開頭的行 | 必須：否則 `prompt --role holistic |
| 12 | 階段 E 輪次（至多兩輪） | 每個審查員執行一次 prompt --role holistic 和 --role formal（第 1 輪每個角色 3 次，第 2 輪 2 次；程式會拒絕更多），每次啟動一個新的代理（agent），該代理僅能看到列印的行；每個執行 record --packet；stage-e merge；`stage-e rule --cluster K.. --as applied | waived |
| 13 | 擁有者裁定、階段 E 修復，或區塊間的移動 | 如果記錄了缺陷，執行 defect rule；針對影響範圍執行 pending；更新裁定檔案（rulings-file.md）；僅在主幹、分類帳或審查員據以判斷的慣例發生變更時，執行 revision --yes | 必須執行 defect rule。一次版本更新會列印並丟棄所有當前判定，並拒絕仍在外的資料包。對分類帳、簡報或 reviewer-context.md 的編輯（未伴隨版本更新）僅在記錄資料包時發出警告 |
| 14 | 每次向擁有者報告之前 | check；引用其最後一行；以「與技能要求之偏差：」結尾 | 必須 |
| 15 | 輪次結束時，或當被問及磁碟使用情況時 | gc | 應該。它會列出超過保留期限的輪次，但不會刪除任何內容；gc --compact 會移除大量已過期輪次的資料（原始報告、資料包、句子對應、快照），且僅在獲得擁有者同意時執行 |
完成
一個章節只有在以下條件全部滿足時才算準備就緒：所有區塊均已整合、每個要求的結果與當前區塊和章節快照相符、已宣告的語言覆蓋範圍完整、沒有任何區塊的必要品質面向處於 FIX 或 USER_DECISION 狀態，並且階段 E 已裁決完畢：最多兩輪獨立盲審，所有必須處理的聚類均已應用或豁免（無未處理的聚類，無延遲給擁有者的聚類）。驗證的獨立性與內容品質分開記錄。
對於作者原始碼中存在的、且被要求的任務尚未授權修復的科學缺陷，遵循 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 版的工作階段