Files
Agent-Workbench/docs/GIT-DELIVERY.md
T

3.1 KiB

内置本地Git交付契约

本切片把已审核文件、实际工程检查、只读提交预览、持久提交job和交付报告绑定到同一个Task。代码检查不等同于业务需求已验收;报告只陈述已有证据。

准入与范围

  • 当前工程必须是自己的Git仓库,已有HEAD;不自动初始化、推送或创建worktree。
  • 本机需要可用的Git;当前实现使用Git索引及prepare/commit引用事务,已在Git for Windows 2.54.0验证。便携包随附Node/npm,Git使用本机安装。
  • 只接受当前Task中已应用的普通文本文件。连续提案的基线链必须一致,当前文件SHA256必须等于最新已应用提案。
  • Git HEAD中的内容必须与该修改链起点一致。选中文件已有其他人的工作区修改、暂存修改、未合并或特殊索引标记时拒绝提交。
  • 新文件必须由本Task从不存在的基线创建。其他未跟踪文件不会进入提交。
  • 完整有界源码快照和至少一项实际有测试数量的通过记录必须一致;跳过、取消、未知、损坏日志和过期检查均不能准入。
  • 不执行自定义Git内容过滤器、外部diff或fsmonitor。本地提交不执行仓库hooks和GPG签名,预览明确说明该策略;依赖这些检查的团队工程须通过自己的Git流程交付。
  • 源码指纹与Git执行基线分别保存。文件未变化时,提交不使已有测试过期。

提交与保留

确认只接收已保存的planId。预览包含任务、HEAD/ref、作者、实际消息、明确文件清单、diff、检查记录和策略;任一基线变化需要新计划。

执行宿主持有项目互斥。Git使用参数数组、明确路径、受限环境和独立索引构建交付树;原索引持有标准index.lock,保留不属于此任务的所有索引条目。Git引用事务先比较原HEAD并prepare锁定HEAD和当前分支,再核对实际分支引用后commit或abort;支持已有命名分支。提交记录含唯一Workbench-Delivery trailer,禁止以重试生成第二个提交。

完成必须核对实际提交的父节点、树、路径、文件blob、唯一trailer、原工作区源码与无关索引条目。未知状态不会伪装成完成。

停止与恢复

job持久保存queued/preparing/prepared/publishing/committed/completed阶段及索引锁的本次身份。发布前停止不会更新HEAD;已发布后的停止继续核对实际结果,不能假定取消了提交。

服务实际退出后不自动重放。显式“核对提交结果”先只读确认预期提交和引用;只有本次持有的遗留索引锁及原索引SHA均匹配、原进程已结束时,才修复本次索引发布。遇到外部索引/引用变化保留需处理状态,不删除别人的锁、不覆盖外部修改。

交付报告

JSON和Markdown工件从实际Task、Run、模型快照、usage、提案、检查日志、源指纹及Git结果生成;带SHA256并可查看/下载。无需额外模型调用。报告明确区分待审核、需检查、检查通过待提交、已验证提交和结果待核对,不把模型文字中的“完成”作为交付证据。