Skip to content

refactor(runtime): 运行时契约只留各工作流共用的部分,细节挪到使用方 - #28

Merged
mtmtian merged 2 commits into
mainfrom
claude/slim-runtime-core
Oct 24, 2026
Merged

mtmtian merged 2 commits into
mainfrom
claude/slim-runtime-core

Conversation

@mtmtian

@mtmtian mtmtian commented Oct 24, 2026 •

Copy link
Copy Markdown
Owner

问题与目标

精简评审的第二批。references/runtime.md 原来 14.2KB,每个工作流技能调用时都要先读完它,再读主控适配文件。其中一半内容只有少数技能用得到:xagent 和 panel 的细节、T3 解析、技能编写、会话历史。另外还有一句写死了用户自己的浏览器(ego-browser)。

目标是契约只留各工作流共用的部分,每段细节挪到真正用它的地方,并且一条规则都不丢。上一批(#27)去掉了 26 个独立技能对契约的引用;这一批缩小的是剩下那些技能每次要读的量。

改了什么

内容 之前 现在
runtime.md 14.2KB 8.5KB。Claude 上每次调用要读的契约加适配文件从约 18.8KB 降到约 13.2KB
xagent 调用、effort 上限、证据、panel 成员、重试与未决结果 契约里约 4.7KB,和 xagent 技能部分重复 合并进 xagent 技能的 “With pstack” 一节并去重;契约只留一句:派发 xagent(包括 required_panel_members 加入的 panel)前先读这一节。swarm 和 arena 的重试规则改为链接这一节
T3 的 resolve、候选、@latest 契约两段 T3 overlay 本来已经写了,只补一句“难度规则不共享模型分配”。“候选对象和 @latest 只在 T3 有效,不是原生 Agent 的模型值”这句保留在核心契约,原因见下方验证
技能放置、发现链接、编写 契约一节 新文件 references/project-skills.md,由 automate-me、create-verification-skill、create-formal-verification-skill、reflect、poteto-mode、authoring-a-skill 链接
会话历史 / transcripts.mjs 用法 契约一段 新文件 references/session-history.md,由 recall、correct、automate-me 链接;“不翻无关会话、不写持久记忆”这句留在核心
Antigravity 视图、原生 effort 归属 契约和适配文件各写一遍 只留在 Antigravity 适配文件和 Codex / Claude 适配文件里
ego-browser 契约、poteto-mode、multi-phase-plan、make-bot-ui、Benny 共 6 处 改为“用户或主控指令指定的浏览器”。三端全局规则(~/.claude/CLAUDE.md、~/.codex/AGENTS.md、~/.gemini/config/AGENTS.md)都已写明 ego-browser,而且 Codex 适配文件本身就要求不把用户专属规则写进插件
README、指南 01 和 09、ADAPTATION、denylist 提示语 指向契约 指向新位置;ADAPTATION 记录新的分布和原因
版本 0.15.32-shared.3 0.15.32-shared.4

验证

检查 命令 结果
完整门禁 bash scripts/check.sh all(Bun 1.4.2,GNU coreutils) PASS:fork guards(10 denylist / 34 required,链接检查覆盖新文件和新锚点)、Node 91/91、statechart 63 pass / 101 skip(无 TLC)、Python 五组、Bun 125/125、产物一致
逐句核对 把旧 runtime.md 和旧 xagent “With pstack” 一节拆成句子,在新的契约、xagent 技能、T3 overlay、三个适配文件、两个新 reference 和 setup-pstack 中逐句查找 143 句中 108 句原样还在;其余 35 句逐句确认了去向:32 句改写或合并,含义在新位置;3 句按设计删除(两句用户专属浏览器规则;一句 Bun 重建说明,ADAPTATION 的 Verification 一节已有)
核对抓到的遗漏 用临时配置跑 config.mjs show,看 T3 专用写法在各位置是否被拒绝 共享策略里的 candidates 和 @latest 会被拒绝;但 hosts.claude 里写 @latest 字符串能通过校验。所以“只在 T3 有效”这句对原生主控仍有用,已补回核心契约

| 引用扫描(thermo 审查后补做) | 列出所有“见共享运行时 / 契约规定了什么”的句子,逐条核对所指规则是否还在契约里 | 找到 5 处指向已搬走内容的旧引用(T3 panel 阻断、Claude 适配文件的 xagent 条目、interrogate 的重试、指南第 9 页、statechart 的浏览器),在 8417887 中全部改指新位置;其余引用所指的规则仍在核心契约里 |

风险与未验证项

  • 带 xagent 条目的流程现在要多读一次 xagent 技能。这一节原来分散在契约里,现在集中在一处,读的总量没有变多。
  • 浏览器选择现在完全依赖用户或主控的全局指令。三端全局规则都已写明,但如果在别的机器上用这个插件而没有类似规则,就不会再被提示用 ego-browser。
  • 没有在真实主控里跑 xagent panel 或 host E2E。这次是文本搬迁,没有改代码;合并后需要刷新三端安装、重开会话。

🤖 Generated with Claude Code

- references/runtime.md 从 14.2KB 降到 8.5KB:xagent 调用、effort 上限、证据、
  panel 成员、重试与未决结果并入 xagent 技能的 With pstack 一节;T3 的
  resolve 与候选说明本来就在 T3 overlay,只补一句难度规则;Antigravity 与
  原生 effort 归属本来就在各适配文件。
- 新增 references/project-skills.md(技能放置、发现链接、编写)和
  references/session-history.md(transcripts 列表),由编写技能和
  recall/correct/automate-me 链接。
- 契约和随包技能不再写死用户的 ego-browser:三端全局规则已经写明,
  改为“用户或主控指令指定的浏览器”。
- swarm/arena 的重试规则改指 xagent 技能;README、指南、ADAPTATION 同步;
  版本 0.15.32-shared.4。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Oct 24, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-10-24T22:23:51.366079Z 05436f2 PR opened
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

thermo 审查发现,内容挪走后仍有 5 处写着“见共享运行时”:
- t3-runtime 的 panel 阻断规则、claude-runtime 的 xagent 条目、interrogate
  的 xagent 派发与重试,改指 xagent 技能的 With pstack 一节;
- 指南第 9 页的技能编写流程改指 project-skills.md;
- statechart 的本地渲染不再说“契约指定的浏览器”,改为用户或主控指令
  指定的浏览器。
ADAPTATION 同步列出这些引用方。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@mtmtian
mtmtian merged commit 22ce948 into main Oct 24, 2026
3 checks passed
@mtmtian
mtmtian deleted the claude/slim-runtime-core branch October 24, 2026 22:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant