Skip to main content
AI 原生工作正在从一次性 prompt 变成可复用能力、上下文资产、编排流程和执行记录。但今天的 skill、MCP tool、AGENTS.md、CLAUDE.md、Cursor Rules、workflow 和运行结果仍然分散在不同工具里,缺少共同对象语言。 Huoban 的判断是:AI 工作不应该只存在于一次聊天或一个工具内部。AI 工作的最小可治理单位,是一组可以被命名、验证、组合、校对、复用和治理的标准对象。 Huoban 活板的设计哲学来自活字印刷术。活字印刷术真正带来的不是“有字”,而是一套生产方法:字可以被标准化、收纳、选择、排布、润墨、试印、校对、印刷、拆版、复用。 Huoban 把这套方法应用到 AI 系统:把能力、上下文、编排、执行、依赖准备、验版、校对、权限、生命周期观察和产物拆成可排版、可润墨、可印刷的开放编排结构。
Huoban(Huó Bǎn)活板
可排版、可润墨、可印刷
把分散在不同工具里的 AI 工作,整理成一套可验证、可组合、可审查的开放对象语言。
字架 / 对象资产
先把能力、上下文、规则和来源变成可命名、可审查、可替换的对象。
Skill
Adapter
Profile
Policy
Registry
Trust
墨方 / Profile
项目规则、领域语言和历史决策进入上下文层,改变判断标准,但不污染 Skill 本身。
印坊规矩 / Policy
副作用、审批和权限边界必须显式声明,不能留给工具默认行为。
版盘 / Flow
Flow 按 capability-first 排列阶段、校对点和产物;只声明版式,不绑定 runner。
capability
stage
checkpoint
artifact
profileRef
policyRef
印张 / 事实链
一次 AI 工作必须留下可校对、可复盘、可迁移的记录。
Run snapshot
Checkpoint
Artifact
开放标准
同一套对象语义,可被不同 agent、tool、MCP server 和 runner 解释与绑定。

可排版:能力必须能被重新排列

可排版

把能力、阶段、校对点和产物声明拆成可重新排列的 Flow
可排版意味着能力不能只是一段临时 prompt,也不能只绑定在某个工具按钮里。能力必须能被命名、索引、选择、组合和替换。 如果 skill 不能从具体工具里拆出来,它就无法跨项目复用;如果编排只存在于人的操作习惯里,它就无法被审查、迁移或自动验证。 在 Huoban 中,Skill 是活字,Flow 是版式,Registry 是字架,Adapter 是异形活字转接件。 Flow 不是脚本,也不是某个执行环境的配置。它描述的是“这项工作需要哪些能力、如何排列、在哪里停顿、产出什么”。具体由哪个工具、模型或执行环境完成,是后续 binding 和 Run 的问题。 这也是为什么 Huoban 优先引用 capability,而不是把 Flow 永久绑定到某个具体 skill。这样同一个 Flow 可以在不同团队、不同工具、不同执行环境中复用。 继续阅读:Flow 模型Skill 对象Adapter 对象

可润墨:上下文必须成为对象

可润墨

把团队规则、项目结构、领域语言和历史决策沉淀为可审查的 Profile
可润墨意味着上下文不能散落在聊天历史、个人习惯或不可验证的项目说明里。上下文必须成为可以分层、合并、审查、导入和导出的对象。 如果 context 只留在 prompt 或聊天历史里,团队无法知道 agent 依据了哪些规则,也无法判断一次输出是遵循了项目约束,还是偶然命中了正确答案。 在 Huoban 中,Profile 是墨方。它不改变 Skill 本身,但会改变同一个 Skill 在不同项目里的判断标准。 一个 Profile 可以包含:
  • 团队规则
  • 项目结构
  • 领域语言
  • 架构边界
  • 历史决策
  • 输出风格
  • 风险偏好或 Policy 派生提示
这对应今天常说的 context engineering,但 Huoban 不把 context 只看成“塞进 prompt 的材料”。Huoban 把 context 变成 Profile 对象,让它能被版本化、校验、引用和迁移。实际副作用、审批和权限边界仍然进入 Policy AGENTS.md、CLAUDE.md 和 Cursor Rules 通常应作为上下文文件导入为 Profile 对象。如果文件包装的是外部能力、工具行为或 skill-like 指令,则应通过 Adapter 表达,并经过 review。Profile 适合进入跨工具的标准对象模型,而不是只被某个 agent 工具读取。 继续阅读:Profile 模型导入 AGENTS.md导入 CLAUDE.md导入 Cursor Rules

可印刷:执行必须留下可审查快照

可印刷

Run、Preflight、PolicyCheckpointArtifact 留下一次工作可复盘的事实链。
可印刷意味着一次 AI 工作不能只留下聊天记录或不可复现的结果。它应该留下可审查的执行快照、权限边界、校对记录和产物。 如果执行没有 RunCheckpointPolicyArtifact,一次 AI 工作就很难被复盘:无法确认当时用了哪个 Flow、注入了哪些 Profile、允许了哪些副作用、在哪个判断点继续或停止。 在 Huoban 中,Run 是锁版印刷,Checkpoint 是校对,Policy 是印坊规矩,Artifact 是印张,Trust 是来源信任记录。 没有 Checkpoint,agent loop 只能依赖聊天里的临时停顿。Huoban 把停顿变成对象:在哪个 run 和 stage 停下、为什么停下、需要哪些决策动作、关联哪些产物,都必须显式。 没有 Policy,读文件、写文件、执行命令、访问网络、发布远端变更或访问密钥就只能靠工具默认行为。Huoban 把这些副作用放进审查边界。 Trust 不替代 PolicyCheckpoint:它记录对象来源、审查状态、信任等级和 sandbox 要求;权限边界仍由 Policy 声明,决策动作由 Checkpoint 要求,产物验收在 Artifact.review 中表达。 继续阅读:Run 模型Checkpoint 模型Policy 模型Trust 模型

备料、验版与报工:不要等开印后才发现阻塞

活字印刷不会在开印后才确认字、墨、稿件和器具是否齐备。Huoban 也不能等 stage 已启动,才发现 Skill 未安装、MCP tool 不存在、上下文来源不可读或凭据未配置。 这些都不是新的顶层 kind。Requirement 嵌入对象,Preflight 证据进入 Run status 与 Artifact,Lifecycle Handler 嵌入 Flow 并通过 Run binding 选择 provider。 Preflight 不是授权:字、墨和机器齐备,不代表这次印刷已获准。PolicyTrustCheckpoint 与执行环境权限仍然独立生效。Lifecycle Handler 也不是任意 hook;业务动作应写成 stage,判断应写成 Checkpoint,权限应写成 Policy。 继续阅读:RequirementPreflightLifecycle Handler

开放标准:不要把对象锁进单个工具

开放标准

先定义共享对象语言,再让不同工具、模型和执行环境围绕对象做解释和绑定。
Huoban 要定义的是对象语言,不是单一工具的内部格式。对象模型应该能被不同 agent、tool、MCP server、模型和执行环境共同理解。 这也是 Adapter 的哲学位置:Huoban 不要求已有生态全部重写成原生对象。外部 skill、MCP tool、AGENTS.md、CLAUDE.md、Cursor Rules 都可以先通过 Adapter 或 Profile 进入 Huoban 对象模型。 Adapter 不是简单调用桥。能力类外部来源至少要声明 sourcecapabilitiessideEffects;外部文件、程序或服务依赖进入 requirements[]mappingcheckpointtrustRef 在可推断或已审查时补齐。这样外部能力才能被同一套 Flow 排版、被同一套 Preflight 检查、被同一套 Policy 审查。 开放标准的目标不是让所有工具消失,而是让工具之间可以共享对象语义。 Huoban 不要求所有工具使用同一个执行器。它要求不同工具能理解同一组对象:同一个 Flow 可以被不同执行环境解释,同一个 Profile 可以被不同 agent 注入,同一个 Policy 可以被不同系统检查。

v1alpha1 已经承诺

对象拆分、schema、examples、解释和验证路径已经进入公共标准边界。

v1alpha1 尚不承诺

hosted registry、marketplace 和完整执行系统兼容性还不是已经完成的公共承诺。

对象边界:为什么不能合并

Huoban 的对象不是为了多造概念,而是为了防止不同层次的责任互相污染。能不能合并,判断标准只有一个:合并之后是否还保留可验证、可替换、可审查的边界。

Skill / Adapter

Skill 声明标准化能力;Adapter 把外部 skill、MCP tool、导入格式或外部能力转成标准对象。合并后,外部指令会被误认为原生可信能力。

Profile / Policy

Profile 注入上下文和判断标准;Policy 声明权限、副作用和审批边界。合并后,危险动作可能藏进上下文。

Flow / Run

Flow 是可复用版式;Run 锁定 flowRefprofileRefspolicyRefsmodebindings,并可记录 snapshot。合并后,历史执行会被后续 Flow 修改污染。

Checkpoint / Artifact.review

Checkpoint 声明需要哪些决策动作并关联 run、stage 和 artifact;Artifact.review 表达产物是否被验收。合并后,审查链路不可追踪。

Trust / Policy

Trust 记录对象来源、审查状态、信任等级和 sandbox 要求;Policy 约束一次工作允许哪些副作用。合并后,可信来源可能被误解成自动有权限。
这就是第一性原理上的边界:Flow 解决“如何排”,Profile 解决“按什么上下文判断”,Requirement 解决“依赖什么”,Preflight 解决“当前是否就绪”,Policy 解决“什么动作被允许”,Run 解决“这一次到底引用并绑定了什么”,Checkpoint 解决“在哪里需要显式决策动作”,Artifact 解决“产出了什么”,Trust 解决“这个对象来自哪里、是否可信”,Lifecycle Handler 解决“在哪些有限事件上观察和上报”。

最小验证例子:idea-to-spec-review

标准对象必须能串成一条可验证链路,而不是停留在概念解释里。当前 examples 中的 idea-to-spec-review 可以这样读: 这条链路说明 Huoban 的重点不是让 agent “看起来自动化”,而是让 AI 工作可以被解释、检查、复盘和迁移。

对象映射

从一次 AI 工作看排印流程

1

取字:选择能力

Registry 提供对象来源和索引范围;能力匹配由后续工具或解释层完成。
2

排版:组织 Flow

Flow 安排 stage、capability、artifact 和 checkpoint。
3

润墨:注入 Profile

Profile 注入团队规范、项目结构、领域语言、历史决策和输出要求。
4

立规:套用 Policy

Policy 声明副作用、审批、权限和危险动作边界。
5

锁版:生成 Run

Run 锁定一次执行使用的 Flow/Profile/Policy 引用、mode、bindings,并记录当前 schema 支持的 snapshot hash。
6

备料与验版:Requirement / Preflight

检查对象引用、capability binding、文件、程序、MCP、凭据和上下文来源,并留下 Run scope 证据。
7

校对:进入 Checkpoint

在高判断力或高风险节点进入 Checkpoint,声明需要 approve、request changes 或 reject。
8

付印:产出 Artifact

把代码 diff、文档、报告、决策记录或发布结果保存为 Artifact
9

报工:记录 Lifecycle invocation

运行时实现应在有限事件上执行经绑定和授权的观察性处理器,并把 event id、尝试次数和结果写入 Run status。当前 reference implementation 只验证声明、binding 与就绪性,不提供 dispatcher。
10

归架:进入 Registry 和 Trust

采用 Huoban 的系统应把可复用能力、产物来源、审查结果和信任等级归档,进入下一次复用循环;当前仓库只定义这些对象和引用关系,不提供托管归档服务。

设计边界

对象模型优先

Huoban 先定义共享对象语言。执行环境可以有多种实现,但不能反过来决定标准对象边界。

公共标准与公司实践分开

公司实践可以反馈标准,但不能把一次私有 workflow 直接提升为公共对象。

上下文必须显式

AGENTS.md、CLAUDE.md、Cursor Rules 等上下文资产应进入 Profile 或 Adapter,而不是停留在不可验证的聊天历史里。

副作用必须可见

副作用由 Policy 声明和审查,Run 记录本次使用的 policyRefs 和 bindings,Trust 记录对象来源和 sandbox 要求。

设计原则

  1. 标准化活字,不标准化文章。
  2. Skill 尽量无状态。
  3. Profile 是上下文层,不是 Skill 本身。
  4. Flow 描述能力编排,不绑定单一执行环境。
  5. Run 必须可追溯。
  6. 副作用必须可见。
  7. 校对是一等能力。
  8. Adapter 是标准化边界,不是临时胶水。
  9. Flow 也应该可分享。
  10. 文化隐喻必须进入结构,而不是停留在命名和文案上。
  11. 依赖就绪、治理授权和业务成功必须分别验证并独立记录。
  12. 生命周期观察不能成为隐藏控制流。

一句话定位

Huoban 的对象边界不是概念堆叠,而是治理、复用和审查所需的最小结构。AI 工作应该像活字一样可拆、可排、可校、可复用。 Huoban 是 AI 系统的开放编排协议:可排版、可润墨、可印刷。