以 Release 快照为权威事实源
深度解析编码 Agent 依据不可变 Release 快照构建系统的架构逻辑,而非对齐处于草稿态的工作区。
核心约定
Release 快照是产品上下文在特定时间节点的内容级冻结副本。当编码 Agent 构建与调整代码时,必须严格以特定的 Release 版本为单一事实准绳——而不是频繁变动中的工作区草稿,更非不可复现的会话聊天记录。
这是 OriginAI 体系中最根本的工程契约:真正交付实现并作为验收基准的永远是 Release 快照。 平台工作台中的所有可视化编辑与协作能力,最终目的都是为了协助团队稳定产出高品质的 Release 版本。
为什么 Release 快照坚实可信
| 核心特性 | 工程价值与具体体现 |
|---|---|
| 不可变性(Immutable) | 每一份快照均由内容哈希(Content Hash)唯一寻址,发布后永不变更。 |
| Agent 默认读取目标 | CLI 与 MCP 默认返回最新发布的权威 Release,杜绝草稿泄漏。 |
| 交付确定无歧义 | “依据 Release a1b2c3 实现”具备绝对一致性,不存在解释偏差。 |
| 全生命周期可追溯 | 历史版本哈希持久保存,支持追溯审计或精准回锁(通过 --release-tag 参数)。 |
正是因为 Release 具备内容寻址与强不可变特质,“对齐 Release a1b2c3 构建系统”在任何时刻、对团队内任何成员及自动化工具而言,都代表完全相同的确定状态。
仓库同步指针机制
每个与 OriginAI 建立关联的代码仓库,均会在本地 .origin.json 配置文件中记录一个 release_hash。这代表当前代码仓库最近一次完成同步对齐的规格版本,包含三个标准化步骤:
- 执行
get-diff:对比代码仓库当前记录的同步哈希与最新已发布 Release 快照。该操作为纯只读检查,仅罗列规格差异,不移动指针。 - 在代码库中实现变更:编码 Agent 根据规格 Diff 编写或调整工程代码。
- 执行
sync推进指针:当且仅当工程代码完全符合新版规格并通过测试验证后,再执行同步命令推进指针。
在心智模型上,请将 sync 操作视为一次顺利通过的 CI 自动化构建。若在代码尚未对齐实现前轻率推进指针,团队将失去对“代码与规格已同步”这一关键状态的确定性信任。
当编码 Agent 在编码过程中发现产品规格本身需要修订时,该写入不会即时触发新的 Release;而是会自动沉淀为一条等待人类审核的变更请求(Change Request),由人类在工作台中确认批准后再行发布。