物理论文编辑——章节 是做什么的?
用于任意长度的完整物理章节、技术笔记或任何超过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。
- 阅读 scope-and-verifiers.md 用于阶段B或E的审核。当项目存在裁决文件时,还需读取 rulings-file.md。
- 在完成之前,阅读 test-checklist.md。
管理设计
章节围绕一个全局物理脊线和全局对象账本组织,优先于局部散文的优化。每个语块继承它们。一个语块不得引入冲突的归一化、因子约定、重复符号或更改的作用域,除非与全局账本协调一致。
语块划分仍然是一个注意力和持久化机制。一个强大的章节编辑可以直接创作语块;一个经济型或未知的编辑器则使用脚手架。每个普通语块使用微技能的 direct | reviewed 合同。一个无法分割到13个句子以下、且源格式安全的单元,将保持为一个章节拥有的超大语块,并直接使用已审核合同,而不是违反定义或方程边界。
每个语块必须保留章节既定的术语和符号。语块组装不得引入在源和全局上下文中不存在的新缩写标签、数学别名或重复名称,除非 names-and-symbols.md 允许,并且经过有意识地协调。
阶段
| 阶段 | 产出 |
|---|---|
| A | 版本-2轮次、不可变源、编辑意图、语言覆盖范围、角色到模型策略、章节范围 |
| B | 章节物理脊线、段落映射、全局对象账本、结构计划 |
| C | 源格式安全的论证语块,通常最多12个句子,带有已定义的超大单元回退方案 |
| D | 每个语块的直接或已审核编辑;全局账本得到有意识地更新 |
| E | 章节级的物理故事、对象一致性和形式化审核:最多两轮独立盲审,合并并裁决 |
不要为每个句子启动审稿人。一个已审核的语块使用一个整单元句子审稿人和一个术语与符号审稿人,外加触发的专家。 不要要求为低风险的直接语块配备审稿人。只重新打开那些在必需质量轴上失败的跨度。
在第一个面向用户的回复中,遵循微技能的 运行时合同。如果存在常设项目或会话的角色到模型策略,请说明其映射并继续,无需请求确认。否则,请求并等待。将活动映射记录在 session.md 中,并将其传递给每个语块和章节级审核。语块不再询问。
每个轮次还声明 language_coverage: selective | exhaustive。选择性覆盖审计更改或诊断的句子以及语块级散文。详尽覆盖为当前每个语块中的每个句子提供当前快照的语言判定。不要仅因存在旧的语块工件就推断详尽覆盖;当请求的覆盖范围不明确时请询问。详情:微技能的 language-coverage.md。
覆盖范围选择句子,而非原则。每个在范围内的句子都接受全部16项句子检查,并且新起草文本中的每个句子都被视为已更改。
持久化
章节工作通常可以恢复,因此将每个版本-2轮次、其不可变的原始章节文本和边界、当前候选、摘要、上下文修订和对象账本修订、语块清单、哈希值以及质量结果持久化存储在 .physics-edit/ 下,如 disk-layout.md 中所述。历史轮次作为不可变证据保留,并且永远不会满足后续轮次。
面向用户的语言
在持久化记录中保留确切的版本、轮次、快照、路由和状态词汇表,这些对于正确性是必需的。在对话中,遵循共享的 用户通信策略:用普通语言描述正在发生的事情,并且永远不要在不立即解释其对作者文本意味着什么的情况下呈现内部标签。
合规门控
轮次的簿记是一个程序 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 列出选项)。在以下时刻运行这些命令。必须 表示程序拒绝下一步或 check 在没有它的情况下失败。
| # | 时刻 | 运行 | |
|---|---|---|---|
| 1 | 轮次开始 | policy show(如果缺失:询问所有者,然后 policy set),init,填写摘要、段落映射和账本,check | 必须:策略,init;应该:check(仅摘要、段落映射、账本和声明应处于开放状态) |
| 2 | 在新会话中或压缩后恢复 | status, pending, digest --rulings, check | 必须。status 列出已发出但未记录的数据包:在启动新数据包之前记录或删除它们 |
| 3 | 一个项目被拆分、合并、移动或添加 | rechunk, chunks | 必须。一个至少一半句子已被审核的语块保留其ID |
| 4 | 在每个编辑批次之后,编辑器自己的规范检查完成后 | record --role editor_closure,然后 digest(没有已接受的发现可以未被应用),pending,prompt | 必须:闭包(prompt 在没有它的情况下拒绝)。一个你决定不应用的建议: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个;程序拒绝更多),每个作为一个新代理启动,只获得打印的行;每个的 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的会话