SuperAPI AI 工具集

refit

智能体与模型

查看项目

更新于 10-16 02:15

技能介绍

Refit 是一个跨会话的环境回顾(retrospective)技能。它审视的不是代理产出的代码——评审与验证另有归属,也不是单次启动运行的教训——那由 sediment 环节负责,而是代理工作所处的环境本身。每一类工作都会留下摩擦痕迹:ralph 循环反复卡在同一个检查上、autopilot 运行停在等待信号处、某次调试会话中决定性的输出从未被记录到任何地方。OMC 对这些都有埋点,Refit 读取这些仪器数据,把记录到的摩擦转化为环境改动,让下一次运行从更好的场地开始。

一、证据优先 回顾从 OMC 的仪器出发,而不是从清单出发。在向用户询问任何内容之前先读取:

  • trace_timeline / trace_summary:回合在哪里停滞、重复或无谓发散。
  • omc session friction report:会话对自身记录的摩擦。
  • .omc/logs/ 与会话状态:错误、重试、被吞掉的失败。
  • 计划记事本 .omc/notepads/*/issues.md 与 problems.md:跨计划累积的问题。
  • 仓库自身的检查面(package.json scripts、CI workflows):在提出任何新检查之前先读取,因为“检查已存在但未接线或静默失效”本身就是发现,而不是要重新发明的东西。

发现来自数据所示。空回顾是有效结果,应如实陈述;编造发现与跳过回顾是同一种违规。一个没有任何已接线自动化检查的仓库本身就是一项发现,而不是中性的默认状态。

二、四个修复归属面 每项发现都要指明对其修复负责的归属面。不适合任何归属面的发现应被明确拒绝并说明原因。

  • 确定性检查:失败是机械性的——固定语法模式、被禁用的 API、导入形态、文件位置规则。修复是 lint 规则、hook 或 CI 任务,以仓库现有护栏中最省成本者为准。默认做法是构建检查,而非撰写规则。
  • 引导面:失败是任何护栏都无法替代的判断性问题:跨文件一致性、与周围风格匹配。修复落在对应的 docs/standards/ 卷宗,或在启动 sediment 环节所定义的 thin-entry 预算内落入 CLAUDE.md/AGENTS.md。指针导航优先于散文叙述。
  • 工具面:拖累来自工具本身——昂贵或 token 效率低的 MCP 调用、缺失自动化、检查慢到在关键时刻无法运行。修复落在 .mcp.json、scripts/、hooks 或 OMC 配置。
  • 信息面:代理需要却无法触及的信号——开发服务器日志、服务状态、第三方只读访问。修复方式是 tee 日志、暴露状态或记录访问路径。

这一划分基于强制力所在位置:实现类上下文承担最多强制力(探索、编写、调试同时进行);评审类上下文只收到一个 diff,不承担任何强制力。因此标准属于评审者与检查——绝不作为更多指令加载到实现者身上。

三、提案与落地 按严重程度排序列出发现,每条以“发现 → 归属面 → 拟议改动”呈现,并附一行仪器证据(哪个仪器、显示了什么)。 停下等待用户批准。每一行都可单独批准或否决。 将已批准的发现写入其归属面。在写入任何引导性散文之前,调用 Skill 工具执行 agent-doc-discipline 并通过其验证清单。新安装的确定性检查必须在被证明有效后才算落地:先干净运行一次,再在故意引入违规时演示其失败,然后回退该违规。无法被演示失败的检查应退回提案——没有谁见过它触发的护栏是装饰,不是保护。 记录每项发现的落点——每行一个文件位置——以便下一次 Refit 从记录开始,而非从记忆开始。对启动运行会话执行的 Refit 从该次运行的 sediment 列表开始;启动运行可以将某条教训命名后推迟到后续 Refit。

四、无头 Refit(无人值守调用) Refit 由用户调用,但其回顾本身不需要用户坐在键盘前才能运行——只需要用户来处置结果。宿主调度器(cron、CI 定时器、自动化工具)可以启动一个无头代理会话调用此技能;回顾在同一契约下运行至其自然边界:

  • 回顾读取相同仪器,不向任何地方落地:无头 Refit 只产出提案列表——发现 → 归属面 → 拟议改动,每条附一行仪器证据——写入 .omc/refit/pending-proposals.md,并在配置了通知渠道(configure-notifications)时在此汇总,以便用户得知有待处理的回顾。
  • 未经用户批准,任何内容都不会到达归属面,与交互式 Refit 完全一致:提案排队等待,每条可单独否决,下一次交互式 Refit 从待处理列表开始,而不重新运行回顾。
  • 空回顾应如实陈述(“无发现”),绝不填充——编造发现与跳过回顾是同一种违规。

五、输出

  • 按严重程度排序的发现,每条含证据、归属面与拟议改动——每行可独立决定。
  • 批准后:落地了什么、落在哪里。
  • 被拒绝的发现及原因。