Huoban 是什么?
Huoban 是 AI 系统的开放编排协议:可排版、可润墨、可印刷。 Huoban 活板的设计哲学来自活字印刷术。协议用 10 个顶层 kind 描述能力、上下文、编排、执行快照、决策、安全、外部能力、产物、发现和信任。10 个顶层 kind 是哪些?
Skill、Profile、Flow、Run、Checkpoint、Policy、Adapter、Artifact、Registry、Trust。
Requirement、Preflight、Lifecycle Handler、Lifecycle Event Envelope 和 Preflight Report 不是 kind;它们是嵌入式协议构件。
Huoban 是 agent runner 吗?
不是。当前仓库没有 agent execution runtime,也没有execute CLI。它提供 schema、examples、validate、explain、迁移、dry-run print 和 Preflight reference implementation。
正确的执行准备顺序是什么?
dry-run 与 Preflight 有什么区别?
print --dry-run 从 Flow 生成 mode: dryRun 的 Run,验证入口输入并锁定 refs、bindings、inputBindings 与五个 snapshot hashes。它不检查环境。
Preflight 读取 Run 和 workspace,分别记录 dependency resolution 与 readiness,并生成 Preflight Report Artifact。两步不能互相替代。
PreflightReady=True 是否表示可以执行?
不表示授权。它只是 readiness 前置条件。execute Run 还必须通过 Policy、Trust、Checkpoint、sandbox、平台权限和采用方自己的授权流程。
stage Preflight 能否授权整个 Run?
不能。StagePreflightReady=True 只适用于指定 stage。execute 需要 Run scope 的 PreflightReady=True。
Preflight 默认会联网吗?
不会。默认 offline。 只有显式--live 才会访问声明的 remote context 或 MCP endpoint。即使 live,CLI 也只做 HEAD、MCP initialize 和有界 list discovery,不调用 MCP tool。
inferred Requirement 如何 review?
schema 要求 inferred Requirement 写reviewStatus。needsReview 会让 Preflight resolution/readiness 保持 Unknown。
当前 CLI 没有 review 命令,也不会自动把它迁移为 accepted。采用方必须显式定义 review 与记录流程。
Lifecycle Handler 是 hook 吗?
不是任意 hook。on 必须来自 v1alpha1 有限事件枚举,handler 必须声明 delivery、role、capability、timeout 和 bounded retry。
它只用于观察、上报和清理。状态改变属于 stage,决策属于 Checkpoint,权限属于 Policy,外部能力属于 Adapter。
当前会派发 lifecycle event 吗?
不会。当前只有声明、Run role binding、Preflight、explain 和 invocation status 形状,没有 dispatcher/runtime。Handler 如何绑定实现?
Flow handler 的requires.role 对应 Run.spec.bindings 的 key。例如 stage-reporter 在 Run 中绑定 Adapter/stage-reporting-mcp。
fallback 写在哪里?
写在 Run binding:--fallback 锁入 dry-run Run;Preflight 以与主 binding 相同的 requiredness 检查 fallback 的 capability、Requirement 和关联引用。当前仓库不会执行自动切换。
Run 有哪些 hash?
Run.spec.snapshot 有:
flowSpecHash:Flow spec。profileRefHash:Profile refs 数组。policyRefHash:Policy refs 数组。bindingHash:bindings 对象。inputBindingHash:本次调用的inputBindings,包括类型、内容引用、inline 值与文件 hash。
snapshotHash 另行哈希整个 Run.spec。
Huoban 能导入哪些格式?
当前import 接受一个文件,唯一 target 是 Profile。因此 AGENTS.md、CLAUDE.md 或单个 .mdc 都可以经过通用 Markdown importer,但只有 AGENTS.md 有 public golden fixture。
当前没有 Cursor directory parser,也没有 SKILL.md -> Adapter import。
Huoban 能导出哪些格式?
当前唯一 export target 是AGENTS.md,并要求 --out。CLAUDE.md 与 Cursor Rules round trip 尚未实现。
Huoban 与 MCP 是什么关系?
MCP 描述工具和上下文连接;Huoban 描述 AI 工作对象与编排边界。MCP tool 可以通过 Adapter 进入 Huoban。 当前 Huoban CLI 只在 opt-in live Preflight 中做 MCP discovery;它不提供 Huoban MCP server,也不调用 MCP tool。为什么区分 Profile 与 Policy?
Profile 是分层上下文,影响判断环境。Policy 是副作用、审批和权限规则。把两者混在自然语言里会削弱审计与执行边界。为什么 Flow 引用 capability 而不是具体 Skill?
Flow 表达可复用版式。Run 再把 role 绑定到具体 Skill 或 Adapter,使同一个 Flow 可以在不同环境使用不同实现,同时保留锁定快照。public examples 在哪里?
在huoban source repo 的 examples/。文档中的 examples/... 是 source tree 路径,不是文档站 URL;示例章节 内嵌关键完整 YAML。