# Huoban

> Huoban 是 AI 系统的开放编排协议：可排版、可润墨、可印刷。

## Docs

- [AI-Native 文档](https://huoban.dev/ai-native.md): Huoban 文档如何同时服务人类读者、AI agent、机器验证和公司实践反馈。
- [版本记录](https://huoban.dev/changelog.md): Huoban 的公开版本变更记录，当前记录 0.1.0-alpha.0 初始协议发布。
- [兼容等级](https://huoban.dev/conformance.md): Huoban 的分级兼容模型：完整对象宇宙，低门槛实现。
- [贡献与治理](https://huoban.dev/contributing-governance.md): Huoban 的贡献方式、对象变更流程、标准提升条件和轻量治理原则。
- [Huoban 活板设计哲学](https://huoban.dev/design-philosophy.md): Huoban 活板的设计哲学来自活字印刷术：可排版、可润墨、可印刷。
- [示例：idea-to-spec-review](https://huoban.dev/example-idea-to-spec-review.md): Huoban 第一条 demo flow：从想法到规格审查，展示 Flow、Run、Checkpoint 和 Artifact。
- [示例：导入 AGENTS.md 为 Profile](https://huoban.dev/example-import-agents-profile.md): 把 AGENTS.md 中的工程规则迁移成 Huoban Profile 对象的示例。
- [示例：SKILL.md Adapter](https://huoban.dev/example-skill-md-adapter.md): 把现有 SKILL.md 适配为 Huoban Adapter 的示例。
- [示例总览](https://huoban.dev/examples-overview.md): Huoban 示例集合：Profile 导入、idea-to-spec-review Flow、SKILL.md Adapter。
- [FAQ](https://huoban.dev/faq.md): Huoban 的定位、边界和与 MCP、runner、skills、AGENTS.md 的关系。
- [Flow 模型](https://huoban.dev/flow-model.md): Flow 是 Huoban 的版式：声明 capability、stage、checkpoint、artifact 和默认上下文。
- [术语表](https://huoban.dev/glossary.md): Huoban 的核心术语、活板隐喻和英文对象名对照。
- [导入 AGENTS.md](https://huoban.dev/import-agents-md.md): 把 AGENTS.md 从自然语言指令文件迁移为 Huoban Profile。
- [导入 CLAUDE.md](https://huoban.dev/import-claude-md.md): 把 Claude Code 项目记忆迁移为 Huoban Profile。
- [导入 Cursor Rules](https://huoban.dev/import-cursor-rules.md): 把 Cursor Rules 迁移为分层 Huoban Profile。
- [导入 SKILL.md](https://huoban.dev/import-skill-md.md): 把现有 SKILL.md 适配成 Huoban Adapter 或 Skill 对象。
- [Huoban 简介](https://huoban.dev/index.md): Huoban 是 AI 系统的开放编排协议：可排版、可润墨、可印刷。
- [对象模型](https://huoban.dev/object-model.md): Huoban 的声明式资源对象模型、核心对象、扩展对象和状态边界。
- [Profile 模型](https://huoban.dev/profile-model.md): Profile 是 Huoban 的墨方：结构化、分层、可合并、可快照的上下文对象。
- [快速开始](https://huoban.dev/quickstart.md): 安装 Huoban，运行 npm test、validate、explain 和 print dry-run，并验证核心 examples。
- [路线图](https://huoban.dev/roadmap.md): Huoban 从文档、对象模型、schema 到 reference runtime 的阶段路线。
- [安全策略](https://huoban.dev/security.md): Huoban 的早期安全边界、报告方式，以及 Policy、Trust、Checkpoint、Run 的安全模型。
- [Adapter 对象](https://huoban.dev/spec-adapter.md): Adapter 是 Huoban 的外部能力标准化边界，把 SKILL.md、MCP tool 或上下文文件等来源转成兼容对象。
- [Artifact 对象](https://huoban.dev/spec-artifact.md): Artifact 是 Huoban 的产物对象，记录一次 Run 产生的文档、代码、diff、报告或决策记录。
- [Checkpoint 对象](https://huoban.dev/spec-checkpoint.md): Checkpoint 是 Huoban 的校对对象，用于暂停、审查、批准、拒绝或修改一次 AI 工作。
- [Flow 对象](https://huoban.dev/spec-flow.md): Flow 是 Huoban 的版式对象，声明 stage、capability、profile、policy、checkpoint 和 artifact。
- [Policy 对象](https://huoban.dev/spec-policy.md): Policy 是 Huoban 的权限和副作用规则对象，按 capability 与 side effect 控制执行边界。
- [Profile 对象](https://huoban.dev/spec-profile.md): Profile 是 Huoban 的上下文对象，负责 data/content 双层、layer 合并和运行时快照。
- [规范参考总览](https://huoban.dev/spec-reference.md): Huoban v0.1 对象规范的阅读入口：版本、字段约定、对象分类和实现边界。
- [Registry 对象](https://huoban.dev/spec-registry.md): Registry 是 Huoban 的字架对象，用于组织、索引和发现 Skill、Adapter、Flow 与 Profile。
- [Run 对象](https://huoban.dev/spec-run.md): Run 是 Huoban 的一次锁版印刷，冻结 Flow、Profile、Skill binding 和 Policy 快照。
- [Skill 对象](https://huoban.dev/spec-skill.md): Skill 是 Huoban 的原子能力对象，声明 capability、输入输出、上下文需求和副作用。
- [Trust 对象](https://huoban.dev/spec-trust.md): Trust 是 Huoban 的信任元数据对象，描述来源、审查、签名、sandbox 和风险边界。
- [标准化路径](https://huoban.dev/standardization.md): Huoban 的标准边界、进入核心标准的条件、发布就绪标准和公司实践反馈循环。
- [信任模型](https://huoban.dev/trust-model.md): Huoban 的 trust、policy、side effects、checkpoint 和 sandbox 边界。
- [愿景与开源策略](https://huoban.dev/vision-and-strategy.md): Huoban 的官方项目定位、对象模型、开源策略和早期路线。