Skip to main content
Huoban 是 standard-first、runtime-later。路线图按可验证能力与进入条件描述，不承诺发布日期。

​
当前基线

当前 package 版本是 0.1.0-alpha.0，公共 API 版本是 huoban.dev/v1alpha1。 已经存在并可本地验证：
  • 10 个顶层 kind 的 JSON Schema。
  • 18 个 public YAML objects。
  • validate 与 explain。
  • 通用 Markdown import --as Profile。
  • export --to AGENTS.md。
  • 从 Profile risk layer derive policy。
  • print --dry-run 与 Run snapshot hashes。
  • Run scope / stage scope Preflight。
  • offline-by-default checks 与 opt-in --live discovery。
  • Preflight Report Artifact。
  • Requirement、Lifecycle Handler 与 lifecycle invocation status 的协议形状。
Requirement、Preflight 和 Lifecycle 不是新增 kind。

​
当前没有实现

不要用 authored status example 暗示这些 runtime 已存在。

​
当前工作重点

​
1. 固化执行前契约

目标：让不同实现对同一个 Run 得到可比较的准备结论。 验收条件：
  • Requirement 形状稳定且有真实 Skill/Profile/Adapter examples。
  • resolution 与 readiness 始终分开。
  • Run.spec hash、scope 和 freshness evidence 可审查。
  • stage scope 不被误用为 Run 授权。
  • --live discovery 保持只读、有界且不调用 MCP tool。

​
2. 验证 Lifecycle 声明

目标：验证有限事件、role binding、delivery、timeout 和 retry 能覆盖真实的观察、上报和清理场景。 验收条件：
  • event 继续使用有限枚举，不接受任意 hook string。
  • handler 外部能力通过 Adapter 表达。
  • business state、decision 与 permission 不进入 handler。
  • 至少有重复真实 workflow 证据后才扩展公共语义。

​
3. 扩大可复现迁移

目标：基于 fixture 与 golden output 增加迁移能力，而不是先写承诺。 候选工作必须同时提供：
  • 输入 fixture。
  • schema-valid output。
  • review conditions。
  • round-trip 或不可 round-trip 的明确边界。
  • CLI behavior tests。
这适用于 CLAUDE.md、Cursor Rules 与 SKILL.md Adapter import。

​
runtime 进入条件

reference runtime 只有在以下条件成立后才值得推进：
  • Flow、Run、Policy、Trust、Checkpoint 与 Artifact 的边界经过多个真实 workflow 验证。
  • execute 前置条件明确要求 Run scope PreflightReady=True。
  • authorization 与 readiness 不混淆。
  • capability binding 与 fallback 语义稳定。
  • lifecycle event delivery 与 status 语义有实现测试。
  • sandbox 和平台权限边界可以被明确声明与审计。
runtime 不应通过增加隐藏 prompt 逻辑绕开协议对象。

​
标准提升门槛

公共字段或能力进入核心标准前，应满足：
  • 在重复真实 workflow 中出现。
  • 不绑定单一公司、仓库、agent 或 runner。
  • 可以被 schema 验证。
  • 有 public example。
  • 可以被 CLI 解释。
  • 提升互操作性。
没有重复证据的实践继续留在私有 Profile、Policy、Adapter、Flow 和 Run 中。

​
不提前建设

  • hosted marketplace。
  • hosted trust scoring。
  • 大而全 workflow builder。
  • 在 trust、Preflight 和 Policy 边界不清晰时执行任意外部能力。
  • 只有 prose、没有 schema/example/test 的标准声明。
当前进度可通过以下命令核验：