SuperAPI AI 工具集

synthesis-agent-conformance

智能体与模型

查看项目

更新于 10-22 16:15

技能介绍

Synthesis Agent Conformance 是一个面向跨智能体一致性的审计技能,用于验证 synthesis 在 Claude Code、Codex 和 Muse 中是否表现一致。它把跨智能体可移植性视为一个持续测试的系统,而不是文件数量的比较。

用途 该技能审计五个层面:源码(source)、已安装(installed)、运行时(live)、连续性(continuity)和能力(capability),使用 v5 工具进行修复,并保持常驻指令足够小,以适应每个运行环境。

绑定规则

  • 一致性必须经过测试,不能推断。清单或版本标签匹配不等于一致;自我报告只是一种声明,因此要比较已安装的字节,并读取每个运行环境自己的回答。
  • 事实冲突时指明层面。运行时状态是当前行为;源码是下一次部署产生的结果。
  • UNKNOWN 永远不会变成 PASS。无法运行的检查报告为 unknown,并说明它需要什么。
  • 永远不要写入运行环境的信任状态。Codex /hooks 信任和 Muse 钩子批准是人的决定;报告需要批准的内容。
  • 从源码修复,绝不在已安装副本或缓存中修复。保持共享行为智能体中立,把运行环境差异放入适配器。
  • AGENTS.md 是规范;CLAUDE.md 恰好是 @AGENTS.md。私有技能放到 ~/.claude/skills 和 ~/.agents/skills,绝不放到 ~/.codex/skills。
  • 遵守 Codex 的预算。指令保持在 project_doc_max_bytes 减去 4 KiB 以下,技能目录在上下文的 2% 以内,专家技能显式调用,路由器负责路由。
  • 仅当生成器支持的产物可验证为生成器输出时才遵循它。手工制作的决策包会跳过生成器保证的内容。
  • 当桌面客户端无法读取受保护文件时,找到负责的引擎并报告 UNKNOWN,直到观察到的检查显示相反结果。

内容

  • 过程(见下):按顺序进行审计。
  • references/audit.md:五个层面、源码 lint、每个 doctor 检查、运行时和连续性检查、技能目录契约、技能输出来源、修复规则。审计前或检查失败时阅读。
  • references/architecture.md:所有权、指令发现、部署、生命周期控制、项目交接、跨机器同步、一致性契约。设计或更改安装、插件、钩子集或同步时阅读。
  • references/instruction-kernel-pattern.md:薄内核结构、四种执行类别、不弱化证明、预算门。常驻指令文件接近预算或规则移到技能、钩子或配置时阅读。
  • references/macos-file-access.md:归因受保护文件拒绝并跨更新接受权限。桌面客户端无法访问文件时阅读。
  • references/autopilot-browser-quality.md:在外部目标(账户、存储状态、排除项)上审查结果。外部目标工作时阅读。
  • references/coverage-map.md:1.14.1 的每一节去向(裁决 D8)。
  • references/preserved.md、references/preserved-architecture.md、references/preserved-hermes-cli-pilot.md、references/preserved-provider-change-intake.md、references/preserved-report-contract.md、references/preserved-signed-observations.md、references/preserved-vendor-demo-protocol.md、references/preserved-vendor-review-packages.md、references/preserved-yaml-runtime.md:1.14.1 文本逐字保留。仅在审查被删减内容时阅读。

过程

  1. 源码。在源码检出中运行:python3 -m pytest -q tests/test_source_lint.py。每个失败都会指出要修复的文件或技能。
  2. 已安装。运行 synthesis doctor(加 --latest 与已发布版本比较)。第一行说明健康或问题数量;后续每行是 ok、warn、fail 或 info、检查名称及其发现。从源码修复每个 fail,然后重新运行。
  3. 运行时。在每个运行环境中启动新会话,确认其 SessionStart 上下文命名了活动项目。请人在 Codex 的 /hooks 中信任已更改的钩子,并在 doctor 列出待处理钩子时运行 muse plugins approve synthesis-skills。
  4. 连续性。在一个运行环境中运行 synthesis use <project> 和 synthesis brief;打开另一个运行环境,不粘贴任何记录,确认相同的阶段、计划和下一步行动。对于另一台 Mac,synthesis handoff 推送本次会话声明中的记录。
  5. 指令。对于 doctor 在指令适配器下列出的每个文件夹,使 AGENTS.md 成为规范,CLAUDE.md 恰好为 @AGENTS.md;绝不盲目覆盖有分歧的一对,先在源码中合并。
  6. 收尾。将真实的运行环境差异记录为带证据的边界;仅当每个层面都通过时才报告一致。

适用场景 适用于需要验证 synthesis 在多个智能体运行环境(Claude Code、Codex、Muse)中行为一致性的场景,包括源码 lint、已安装一致性、钩子接线与信任、AGENTS.md/CLAUDE.md 指令适配、跨机器交接与连续性检查。

限制 资料未提供具体的收费、价格、平台支持范围或效果保证。部分检查依赖人工批准(如 Codex /hooks 信任、Muse 钩子批准),无法自动完成。无法运行的检查只能报告为 UNKNOWN。