愿景与开源策略

​

项目定位

• 能力怎样被命名、组合和替换？
• 上下文怎样被分层、审查和迁移？
• 一类工作怎样形成可复用版式？
• 一次工作怎样锁定 refs 与 bindings？
• 执行前怎样检查并记录依赖就绪状态？
• 哪些行为必须受 Policy、Trust 或 Checkpoint 约束？
• 产物与生命周期观察怎样留下可复盘事实？

​

第一批用户

• 在多个 agent 或 IDE 间迁移规则与 skill 的开发者。
• 需要组合多个 Skill、MCP tool 和上下文来源的团队。
• 需要在真实公司项目中审查副作用、依赖和执行证据的平台工程团队。
• 构建编排系统、希望采用开放对象边界而不是自造私有 DSL 的实现者。

​

第一个不可替代价值

1. 对象语义与边界。
2. JSON Schema 与真实 examples。
3. validate、explain、import/export、dry-run。
4. Requirement 与 Preflight。
5. Policy、Trust、Checkpoint 和 Artifact 证据链。
6. 多实现 conformance。
7. 完整 runtime 后置。

​

十个顶层对象

​

共享执行契约

​

Capability-first 与 binding

stages:
  - id: review
    requires:
      capability: huoban.dev/designReview
      role: primary-review

bindings:
  primary-review:
    adapterRef: grill-me-skill-md

​

完整执行前链路

​

当前 reference implementation

• 十种对象与共享 fragment 的 v1alpha1 schema。
• 覆盖对象链路的 YAML examples。
• validate、explain、import/export 与 print --dry-run。
• Run/stage scope Preflight、默认 offline，以及显式 --live 的只读 context source HEAD 与有限 MCP discovery。
• Preflight Report Artifact、Run conditions/status 与 lifecycle invocation 结构。
• Lifecycle Handler 声明、有限事件枚举与事件信封示例。

• 完整 stage 执行 runtime。
• Lifecycle dispatcher 或实际 MCP tool 调用。
• Policy/Trust evaluator 和审批系统。
• hosted Registry、marketplace 或远程对象分发。
• 自动依赖安装、credential 获取或 fallback 热切换。

​

兼容与版本策略

• 新 validator 必须继续接受此前合法且未被明确收紧的 v1alpha1 对象。
• 旧 validator 会因 additionalProperties: false 拒绝新字段，不能声称旧 reader 前向兼容。
• 在发布稳定版本前，任何字段变化都必须同步 schema、CLI、tests、examples、source docs、Mintlify 与 changelog。
• 进入 beta/stable 后，破坏性变更必须升级 API 版本并提供迁移说明。

​

公司实践如何反馈标准

1. 至少两个独立真实 workflow 反复出现。
2. 不依赖某家公司、单一 agent 或隐藏 prompt 行为。
3. 能被 schema 验证、CLI 解释并由 example 展示。
4. 提升跨实现互操作性，而不是只方便一个 runtime。
5. 安全、兼容和失败语义已经明确。

​

开源协作与治理

• schema 和 fragment 变更。
• 至少一个真实 example。
• 行为测试与生成产物。
• 规范、模型、迁移和安全文档。
• changelog 与兼容性说明。
• 对抗审查记录或等价 review。

​

成功标准

• 同一 Flow 能被不同实现解释，role/capability 语义一致。
• 同一 Profile 能跨工具迁移，内容与来源依赖可审查。
• 同一 Run 能解释 refs、bindings、snapshot 与 Preflight 证据。
• 不同实现对缺失依赖、未知 readiness、Policy 与 Checkpoint 给出一致边界。
• 公开 examples 能在多个实现中得到语义等价结果。

​

非目标

• 在对象模型验证前完成通用 runner。
• 把任意 shell hook 标准化为 Lifecycle Handler。
• 把所有 prompt、tool、resource 或 permission 升级为新 kind。
• 在 Trust 和分发语义稳定前建设 marketplace。
• 用视觉编排器掩盖未稳定的文本协议。
• 把某家公司的一次实践直接写成行业标准。