Skip to main content
当前 source repo 没有 L0-L5 conformance level，也没有 huobanConformance 声明 schema。可验证的实现范围由 10 个顶层 kind 的 JSON Schema、examples 和现有 CLI 命令构成。 因此，“兼容”只能具体说明支持了哪条已实现路径，不能用 source 中不存在的等级、字段或 Full Runtime 标签代替证据。

​
Conformance 声明字段

Trust.spec.level 是 Trust 对象自己的来源审查字段，不是 conformance 等级。 Requirement、Preflight Report、Lifecycle Handler 和 Lifecycle Event Envelope 是共享 fragment，也不是 conformance level 或新增 kind。

​
当前命令矩阵

​
Validation

validate 当前执行：
  1. 展开 YAML/JSON 文件或 glob；YAML 可以包含单文档或多文档。
  2. 对带 apiVersion / kind 的顶层对象，按小写 kind 名选择对象 schema。
  3. 对没有资源外壳、但符合 Lifecycle Event Envelope 识别形状的文档，使用对应 fragment schema。
  4. 报告必填、枚举、正则、条件 schema 和 additionalProperties 错误。
  5. 对 file-backed Artifact 检查本地文件存在并验证原始 bytes SHA-256；对 Preflight Report 验证 canonical object data SHA-256。
它不检查引用目标、generation 匹配、role binding、Requirement readiness、Policy 或 Trust 语义。除上述 file-backed Artifact 外，它也不读取外部内容。

​
Explain 的准确边界

多对象 explain 会统计 kinds，并描述 Flow、Run、Adapter、Policy 和 Artifact。当前缺失引用诊断只覆盖：
  • Flow 的 Profile/Policy refs。
  • Run 的 Flow、Profile/Policy refs 和主 Skill/Adapter bindings。
  • Adapter 的 trustRef。
它不检查 Run fallback、Skill adapterRef、Trust subject/Policy refs、Checkpoint/Artifact 关系或 Registry source。explain 也不会先调用 schema validator；需要形状保证时应先运行 validate。Preflight 会进一步检查当前 Run 可达的 fallback、Skill adapterRef、Adapter Trust subject 和 Trust/Profile Policy refs，但不会扫描未使用对象。

​
Dry-run 与 Preflight

dry-run 先验证 required、unknown 和 type-mismatched --input，再生成 Run 计划及五类 snapshot hash：flowSpecHash、profileRefHash、policyRefHash、bindingHash、inputBindingHash。它不执行 stage，不探测依赖。 Preflight 默认 offline，检查锁定 Run 的可达引用、generation、capability binding、入口 binding、结构化 stage source、Requirement 和当前环境，并输出 Artifact 证据。文件输入按原始 bytes 复核 hash。只有显式 --live 才进行远程 context/MCP discovery；不会调用 MCP tool。 execute 计划必须有 Run scope 的 PreflightReady=True 才能通过当前 gate。stage scope 结果不能授权整次 Run；任何 Preflight readiness 都不能替代 Policy、Trust 或 Checkpoint。 详细字段见 Run 与 Preflight。

​
合法、可验证示例

保存为 YAML 后，以下命令构成当前可复现的对象形状证据：
预期成功输出形如：
这只确认对象通过 Skill schema，不代表它已注册、被 Run 绑定、环境就绪或获准执行。

​
尚未实现

source repo 明确是 standard-first、runtime-later。当前不存在以下可声明为已兼容的行为：
  • Flow 或 Skill executor。
  • Lifecycle event dispatcher、timeout 或 retry runtime。
  • Policy rule evaluator 和 enforcement。
  • Trust signature verification 或 sandbox runtime。
  • Checkpoint 决策 runtime。
  • Registry loader、远程分发或 marketplace。
  • MCP tool 调用式执行。

​
草案兼容边界

当前 v1alpha1 是 alpha 协议，尚未承诺同版本内的前向兼容。不要声称旧 reader 会忽略新字段：多数对象和嵌套结构使用 additionalProperties: false，未知字段会直接校验失败。实现与文档应绑定明确的发布版本或 schema revision。

​
相邻概念边界

​
常见错误

  • 宣称支持 L0-L5，尽管 source 中没有这些等级。
  • 在对象中增加 huobanConformance、supportedKinds 或顶层 kind: Conformance。
  • 把 explain 的有限 reference check 当成完整 workspace validation。
  • 把 dry-run 当成执行结果，或把 Preflight 当成授权结果。
  • 仅凭能读取 YAML 就声称支持 10 个 kind 的完整语义。
  • 声称旧 v1alpha1 reader 对同版本后续字段前向兼容。