mathrsi-handoff · git:20261104.98e7ce5 · 2026-11-04 · sha256 b3eca2e43747d6d6
mathrsi-handoff git:20261104.98e7ce5A
Immutable. This exact content never changes and is served at /api/v1/blob/b3eca2e43747d6d6.
No tool to install first
claude plugin marketplace add https://markdownregistry.com/mp/a/art_sk3gd2s2xj3lmu55/b3eca2e43747d6d6e533541b3a1c569ef4b7edd9873444ff8b9c58a87ee243ba.json
Then /plugin install mathrsi-handoff@markdownregistry-sk3gd2s2xj3lmu55 in Claude Code. It installs this exact version, the one graded A here, pinned to the commit it was graded at, and leaves it there.
---
name: mathrsi-handoff
description: 将数学研究的原题、可读证明和真实验证证据整理成可复现交付与恢复入口,按需求调用 ARIS render-html、引用审计或编译,准备独立目录复现材料、最终 wiki 与 NEXT_SESSION。支持准确部分交接,不重开已闭数学或把展示成功当证明。
---
# MathRSI 可读交付与研究交接
本技能是研究主线的交付阶段。它消费原题、证明、真实验证和当前未闭义务,整理给读者使用的正文、复现入口、需要的文件包以及下一会话状态。用户只要阶段性交接、当前研究需暂停,或证明已完成等待分享时,都可以进入;交付内容的状态跟随实际数学证据,不能因排版漂亮或ZIP生成而升级。
本阶段不重选求解方法,不默认重做证明,不把交付失败当作先前定理失效。若发现真实数学缺口,交回 [mathrsi-prove](../mathrsi-prove/SKILL.md);若仅验证证据待补或某版本未审,交回 [mathrsi-verify](../mathrsi-verify/SKILL.md)。已有原题证明成立而一项展示、外部复现或所需审阅尚缺时,分别报告,不合成一个模糊的PASS或FAIL。
**组合调用完成指定scope后返回原caller。** 正常交付、部分交付或发现缺口,都把实际产物与建议下一动作交回唯一主dispatcher,不自行再启动prove/verify或另一轮handoff。本文“回verify/prove”表示后继建议;内部所需assemble、引用审计、渲染或复现仍实际执行并回到本handoff。独立调用只做用户授权的交付;若用户明确要求持续研究,由本agent接主调度一次处理缺口,避免父子double-dispatch。
## 从验证结果到读者入口的实际流程
先读当前正文和真实verification,确认这次交的究竟是完整原定理还是部分成果;据此选正文、证据和复现命令。随后只制作用户要的阅读版本与包,读回生成结果并执行所需复现,最后把可用入口与准确剩余写进HANDOFF、原wiki和恢复页。若只要一份短证明,正文链接加准确说明就可以完成这条链,不必生成HTML、PDF和ZIP全套。
| 进入时的实际状态 | 先做什么 | 结束时返回什么 |
|---|---|---|
| 原题与所需核验已完成 | 读取被验证的正文和证据,整理读者入口 | 已证范围、可读正文、实际复现入口及用户要求的交付物 |
| 数学已成立,HTML/包制作中断 | 从失败的生成或读回步骤继续,复用未变正文和audit | 修好的交付物与实际展示/解压结果,不重开数学审计 |
| 正文新改动尚未被现有证据覆盖 | 说明差异影响哪条声明,保留可用版本和其它独立交付 | 版本对应及verify建议,由原caller调度所缺核验 |
| 研究未完成,用户要求暂停交接 | 整理严格部分、条件工具、失败边界和最小剩余 | 可直接恢复的caller与下一动作;交接完成,原题仍开放 |
中间每步都消费实际文件:renderer退出后打开HTML;编译后读PDF;打包后解压读入口;命令执行后读退出码和完整范围。若某一步失败,修它对应的输入/工具问题后继续;需新数学或超出授权资源的工作则把准确缺口交回caller。后文给出这些动作的实际技能和输入。
## 进入与恢复
先读原规格、实际证明入口、`VERIFICATION.md`或现用验证记录,以及最新恢复页。检查引用的真实audit、计算/形式证据是否存在,当前证明是否正是这些证据所支撑的版本。不凭一个状态标签重新解读所有日志;只深入与本次交付结论有实际关系的材料。
明确本次读者需要什么:单份Markdown证明、LaTeX/PDF、离线HTML、源码和证书、可解压的复现包,还是未完成工作的精确恢复。沿用用户已有名称;没有约定时,交接说明用 `HANDOFF.md`,恢复用 `NEXT_SESSION.md`,证明入口与verify阶段一致。目录只为实际材料出现,不建立一套所有任务都必须填满的空树。
恢复交付时,先查看上次哪项失败:渲染、引用查验、文件缺件、独立目录执行、还是数学/审阅未完成。已有正确正文和有效证据直接复用;修对应问题并读回产物。旧研究暂停保持暂停,整理资料本身不启动Goal、模型研究或云发布。
交接所选领域时实际读取[领域调用与返回](../../../docs/DOMAIN_ROUTING.md)末节和该插件的复现reference/evidence。取当前已采用证明、证书与命令,由本流程写可读正文和包;缺流、历史构建和本次重放在对应命令处说明。ECC/两个hypercube/Happy Ending的局部核验范围按其返回保留,不因作为新插件发布而升级原题数学状态。
## 1. 整理读者可以从头读通的正文
证明正文先陈述对象、主要结果和证据,再按定义、定理/引理、证明组织有效论证。必要假设放在使用处,引用指向实际版本与定理/公式/页码。读者应能看出原输入怎样进入归约、计算或形式接口,又怎样回到结论。正文不堆内部任务指令、已废弃错误和模型对话;相关历史通过研究记录查阅。
若原稿已经完整而准确,直接使用其Markdown或TeX,不为展示多造一份canonical正文。只是标题、符号解释、引用定位或衔接不够,可在不改变数学的范围内修订。需要重写章节时可内部调用 [mathrsi-assemble](../mathrsi-assemble/SKILL.md)来使用proof-writer,并让它返回本handoff;保持已有证明和verification的对应关系。引入新断言、改假设或改结论时,将影响交回原caller建议verify检查,不能把它当纯排版。
部分交接也应有可读结果:正式写明已经证明的条件引理、局部定理或已核见证,保留准确适用域。原题未完成则在交接入口直说尚缺哪一个全称连接、分支或核验,不将一堆局部文件包装成原题解答。对外正文直接呈现正确内容,细节失败留在适当研究记录。
## 2. 按实际引用形态完成引用核查
关键进口在证明推进和verify中已经核过的版本、条件和实际调用可以复用;本阶段检查正文是否仍准确引用它。新增bibliography、正式paper或用户要求引用审计时,读 [citation-audit Codex](../skills-codex/citation-audit/SKILL.md)/[Claude 主线](../citation-audit/SKILL.md)并执行。其原生合同读取 `.bib`与TeX cite contexts、实际外部检索并保存 `CITATION_AUDIT.{md,json}`,选择的reviewer还须能完成独立web lookup,文件只读意见不能冒充检索。
只有Markdown中的少数准确文献定位时,可以按实际一手来源核查每条被用的定理及上下文,记录版本、位置和结果;不要宣称这种人工核查已经执行完整citation-audit。若为了正式审计准备TeX/bib输入,保留原句和引用对应,不能凭空发明条目。单独需要字段级比对时再读 [citation-crosscheck Codex](../skills-codex/citation-crosscheck/SKILL.md)/[Claude 主线](../citation-crosscheck/SKILL.md),保留其真实blind能力边界。
引用条目真实不证明所引数学推论正确。未核关键进口保持准确pending;若影响定理接受范围,回verify明确它的状态。若只是待补年份或链接,修相应条目和正文,再做相称检查。无需把所有旧参考从零多模型复查。
## 3. 生成用户需要的阅读版本
需要HTML时,完整读 [render-html Codex](../skills-codex/render-html/SKILL.md)/[Claude 主线](../render-html/SKILL.md)执行,传入真正正文及需要展示的真实验证JSON,不用render替代数学审计。其脚本与模板位于技能自己的 `scripts/`,不是 `base/tools/render_html.py`;按[仓内调用约定](../../../docs/ARIS_REUSE.md)绑定本副本。
如果用户要完整证明阅读页,传给renderer的源稿必须实际包含定义、引理和证明,不能只渲染一份外链目录或摘要HANDOFF。现稿分散时先把有效论证汇入阅读输入;原TeX为canonical时,可用已有文档转换流程生成忠实的派生阅读稿,再核对公式与依赖,不另立第二份可独立改数学的正文。HTML正文收入核心论证,源码、全量表和原始日志保留深入链接。只要求导航页时才可交目录式页面,并明确用途。
例如在任务工作区,下面是本副本实际脚本的调用形态;路径按当前克隆位置填写:
```bash
export ARIS_REPO="/path/to/MathRSI/base"
python3 "$ARIS_REPO/skills/skills-codex/render-html/scripts/render_html.py" \
PROOF.md --template academic --out PROOF.html --title "Proof"
```
这只是生成步骤;完整render-html技能的展示保真review、实际浏览检查与sidecar状态仍须按其合同消费。检查公式、表格、源码链接和窄屏是否可读;展示审阅只判正文到视图的保真,不判定理真。失败时保留原正文,修实际展示问题,不改数学适应渲染器。
完整调用还需交代读者与保真范围,例如:“读取本仓当前宿主render-html,正文是已核PROOF.md,audit JSON只用于展示真实范围;输出PROOF.html,按academic合同做fresh保真审阅并返回sidecar,检查公式、引用和长表,完成后回到本handoff。”把上层已经选择的reviewer/backend/model/effort覆盖项继续传给渲染、引用审计或其它reviewer-bearing子调用;缺少覆盖项时按各技能的项目/宿主路由解析。真实MCP首轮、续接、cwd、身份与失败取证依 [REVIEWER_MCP](../../../docs/REVIEWER_MCP.md),不让每个子调用静默换回默认模型。所选route不支持视觉或独立web查验时,保留那个slot的准确pending,文件只读意见不能补成已完成的展示或引文核查。
脚本 `--offline` 去除CDN而保留raw math,不会把公式预渲染成离线SVG。用户要求真正离线排版公式时,复用任务已有可用生成流程或适合的文档工具,检查离线实际显示后再宣称达标;不能用该flag名称冒充完成。用户要PDF且已有LaTeX时,可读 [paper-compile Codex](../skills-codex/paper-compile/SKILL.md)/[Claude 主线](../paper-compile/SKILL.md)执行相应构建与版面检查,报告实际工具和结果。没有PDF/HTML要求,不强迫所有短证明多导出一套网页。
## 4. 准备可在独立目录执行的复现材料
依据verify中的实际义务—证据连接,选取复现所需原规格、正文、源代码、输入/证书、依赖锁定与已有运行命令。小纯解析证明不需要附一个虚构脚本;计算证明给准确参数域和实际checker入口;Lean项目给固定toolchain、package/manifest、真实主模块及audit命令。不要把作者私有缓存或整个历史工作区打包为普通读者必须读取的输入。
若成果由优化或多轮搜索产生,交付实际已接受的最终证书与其覆盖证据;探索最佳、最后迭代和已接受最佳各指向自己的文件,不能按“final”文件名选择。发现脚本会重写证书时,不把它作为读者默认重放入口;优先用已有只读checker或在副本执行,复核依赖与可选搜索依赖分别说明。没有轻量checker时如实给真实依赖和可执行范围,不为了形式上的分离再建一套平台。
混合Lean交接随最终export附显式参数/展开定义及外部证据的对应:哪些归约和实际矩阵已核内证明,哪些分类/扫描/文献命题仍被作为参数接受。把这份范围连到正文、复现命令和剩余义务;“仅标准公理”不能单独表述为外部计算全部核内化。带标记归约的映射/恢复入口和有限证书到全称结论的证明桥也应随必要材料交付,避免读者只有一份局部PASS而不能回原题。实例见[v3证据](../mathrsi-meta-evolve/references/v3-evidence.md)。
在交接说明写明入口、执行顺序、预期输出/范围和实测资源。命令必须从包或明确的任务材料中找到输入,不能暗中依赖作者另一个工作区。已有远端大证据按用户认可的存储和获取方式说明;没有复制进包就别说包完全离线自包含。凭据、机器专用工具链和无关缓存不进入共享材料。
用户要求或任务验收需要独立目录复现时,将必要材料放到任务授权的独立目录或解压副本,再运行与本次结论有关的复现命令,记录实际cwd、输入、退出码、输出和覆盖。尽量复用兼容依赖缓存,避免破坏原工程;复算会更改文件时就在副本进行。重放一个固定证书、重建项目输出、全域独立第二实现是不同范围,按真正完成者报告。第二目录由同一代理执行也不是“他人独立复现”。
Lean按原技能验证实际模块和导出,不用默认lake build成功替代;Mathlib缓存可复用时不删全库、不执行lake update漂移锁文件。具体独立目录步骤读 [Lean handoff reference](../skills-codex/lean-formalize/references/verification-and-handoff.md)(Claude的[同名reference](../lean-formalize/references/verification-and-handoff.md)),其例名和版本相关命令按真实项目调整。
执行因缺依赖/资源无法完成时,把准确待执行项和现有证据一起交出,不自动安装大型运行环境,不宣称失败命令已通过。没有要求重建所有历史结果就不重跑它们;本次选取的复现范围应足以支撑要交付的结论。若检查暴露代码与数学不符,回verify/prove修实质问题。
用户需要ZIP或其他包时,在材料和入口就绪后生成,解压读回关键入口、相对链接、源码与输入,必要复现放解压副本执行。包名和目录可按项目惯例,不要求额外hash框架;原audit已有freshness字段保持其既有合同,不以新散列替代读回或数学核验。
具体交接任务可直接交给独占目录的执行者:“读取VERIFICATION里证书C的谓词、输入和真实重放命令,把本次必要源和证据复制到交付副本,保持相对路径;从副本执行该命令,交回cwd、退出码、输出与覆盖,以及必须另取的依赖。”收回后读取实际文件和结果,再将该命令及预期输出写进HANDOFF。若返回只重放保存证书,就按这个范围写;不扩大成全域重搜或独立第二实现。共享正文、总交接入口和wiki由handoff协调者唯一更新。
## 5. 更新原wiki与下一会话入口
先消费prepare、route-loop、prove、verify已经写回的实体与准确范围,只补本次新材料和未同步事项;handoff不是研究中第一次写wiki。按[WORKSPACE §7](../../../docs/WORKSPACE.md#7-五阶段的-wiki-读取与写回)读回更改的实体,将路径交给下一会话,不重复未变记录或将原始日志全部抄入wiki。
读本仓 [research-wiki Codex](../skills-codex/research-wiki/SKILL.md)/[Claude 主线](../research-wiki/SKILL.md),沿用原任务唯一wiki及canonical helper,不新建“交付wiki”。正文阅读到的真实论文、可复用引理条件、研究失败与重启理由接到适当原记录;graph和generated Connections用真实helper维护。自动query pack不保证列出每项关键结论,恢复页直接链接相关实体。
proof-axis claim的出生与升级沿proof-checker真实audit与其wiki hook。handoff不能凭正文完成或zip成功自行add verified claim;缺audit时保留普通研究记录和准确状态,若任务需要canonical claim再返回verify走实际流程。已存在claim需同步新审计范围时,引用真实audit和声明,不能伪造模型认可或扩大进口状态。经验性搜索结果另作实验/idea证据,不改成全称定理。
协调者将`NEXT_SESSION.md`或已有恢复页更新为当前快照:原题入口、当前严格结果与scope、完成还是未闭、关键证据链接、尚需的数学/验证/交付、在途任务及下一动作。替换已失效的状态,不在末尾追加另一份完整阶段报告;独有历史先保存到原研究记录再链接,具体见[WORKSPACE恢复约定](../../../docs/WORKSPACE.md#4-恢复入口应短于完整研究史)。完成就写明交付入口;部分交接给最小未闭义务和实际caller,接手者能直接继续。
最终 `HANDOFF.md`将读者需要的结论放前面,再给正文、verification、复现命令和已知依赖。它应明确区分“原命题已证”“只证某变体/子域”“Lean核验”“计算核验”“模型静态审阅”“独立目录复现”“另一人复现”,只陈述真正发生的事实。用户要求的某项交付缺失时列为pending;没有此要求就不主动制造验收障碍。
## 调用与继续例
```text
读取本仓 mathrsi-handoff/SKILL.md 并执行。
原题 FORMAL_SPEC.md,正文 PROOF.md,真实验证 VERIFICATION.md。
保留已核数学,生成所需可读HTML并检查实际公式显示;
把证明、证书、checker及固定依赖整理到可独立解压的材料中,
在副本运行交接所需的证书重放,准确报告范围。
本次需要ZIP,同时更新原wiki和NEXT_SESSION.md。
若正文中的新数学缺口出现,返回原caller并建议verify/prove,
不自行重复派发后继,也不靠排版补成已证。
```
若用户说“先暂停,交接尚未完成的证明”,同一流程消费当前严格部分,不必先求出整题。最终应交出已证什么、原题缺什么、从哪里恢复;不把“交接完成”写成“数学Goal完成”,也不由文档状态恢复暂停研究。
主流程组合调用到此只收到一次handoff返回,依据实际交付和数学状态决定完成、继续或等待;不由handoff与父流程各自再启动一次验证。独立交付请求到授权范围即结束,明确的持续授权才由本agent转入单一主调度。
一次可消费的返回应像这样具体,已有文件名按原项目沿用:
```text
原题与正文:FORMAL_SPEC.md、PROOF.tex。
数学范围:原定理已由VERIFICATION中所链接的真实证据支持;
或:仅引理L及域D已证,原题仍缺共同选取C。
交付:HANDOFF.md、所需阅读页/包的实际路径;
已读回入口和相对链接,复现执行范围及输出见handoff中的记录。
尚缺:明确列出数学、验证或交付项;没有则写本次授权范围已完成。
返回原caller:可结束本题;或建议verify/prove处理所列准确义务。
```
## 已有交付怎样收束研究
Property B T33在实际新Main、原题复述与传递公理审计完成后,交付页说明 `m(5)≥34`、模型静态审阅范围和本机增量构建,保留他人可复现入口;HTML的1049公式及窄屏检查另作展示证据。它没有据此宣称第二台机器复现、等号或后来35/36目标已解。更新导航为本题完成,避免旧“尚余23点”的快照让接手者重开该题。原始动作和范围见 [REAL_PROJECT_TRANSITIONS案例6](../../../development/workflow-redesign/REAL_PROJECT_TRANSITIONS.md)。
ECC旧43/10材料则分清完整F生成、pair见证重放、文献进口与原题归约;一次只读交接或dry-run没有启动扫描,就不能写成当次全域复算。大见证未随包附带时,列出实际获取依赖;旧题完成与后来的45/11开放分开。对于仍未完成的Property B36,交接把可复用局部工具和八类主要剩余同时保留;不因完整阅读包做完便改写原题状态。这些案例用来选择本次交付实际需要的材料,不要求重跑旧研究或将历史作者机器作为包的隐含依赖。