OriginAIProduct specs for Claude Code, Cursor, and Codex

以 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。这代表当前代码仓库最近一次完成同步对齐的规格版本,包含三个标准化步骤:

  1. 执行 get-diff:对比代码仓库当前记录的同步哈希与最新已发布 Release 快照。该操作为纯只读检查,仅罗列规格差异,不移动指针。
  2. 在代码库中实现变更:编码 Agent 根据规格 Diff 编写或调整工程代码。
  3. 执行 sync 推进指针:当且仅当工程代码完全符合新版规格并通过测试验证后,再执行同步命令推进指针。

在心智模型上,请将 sync 操作视为一次顺利通过的 CI 自动化构建。若在代码尚未对齐实现前轻率推进指针,团队将失去对“代码与规格已同步”这一关键状态的确定性信任。

当编码 Agent 在编码过程中发现产品规格本身需要修订时,该写入不会即时触发新的 Release;而是会自动沉淀为一条等待人类审核的变更请求(Change Request),由人类在工作台中确认批准后再行发布。

相关内容

On this page