SuperAPI AI 工具集

integrate-delivery

编程与开发

查看项目

更新于 10-15 21:41

技能介绍

用途:当 deliver-task 已完成当前实现与审查,且一个仍可访问的 Git branch/worktree 需要收尾时使用。核心原则是不验证旧的交付证明,而是重新验证当前 Git 状态;handoff 仅用于定位 live source,任何测试摘要、review 结论或 .dev-task/ 文件都不能替代本轮 fresh verification。integration 动作由人选择,选择前只做只读检查和验证。

输入:接受 live source workspace 的绝对路径,以及可选自然语言 handoff,需指出 base branch/base commit、当前 branch 或 detached HEAD、完整 HEAD OID、是否有未提交业务变化和上一轮实际运行的验证。不要求 delivery.json、claims、validate-result 或 close-check;.dev-task/ 存在时可读取 task.json、execution.json、artifacts/workspace.json 帮助定位。

主要能力:一是在提供集成选项前重验 live source,确认 workspace 存在、属于预期 Git repository,读取 git-dir、git-common-dir、workspace root、branch/detached 状态、完整 HEAD OID 和 dirty 状态;确定 base branch,无法唯一确定时向人确认,不猜 main;handoff 与现场不一致时标为 stale 并以现场继续;运行完整测试套件,失败或无法确定可信验证入口时停止,不提供 merge/PR 菜单。execution.architecturePath 非 null 时运行 fresh Architecture Drift Review,只阻塞与已确认 Architecture 决定相冲突的 drift;path 无法读取、出现 [ ] 或 review 无法闭合时停止。

使用方式:根据 source 状态只提供可安全执行的动作并等待明确选择。named branch 已提交且 clean 可选本地合并、push 并创建 PR/MR 或保留;detached HEAD 已提交且 clean 可选 push 为新分支并创建 PR/MR 或保留;存在未提交业务变化且 commitPolicy 为 required/allowed 时保留,需集成则回到 deliver-task;commitPolicy 为 forbidden 时只能保留;相对 base 无业务变化则保留或在明确 cleanup 授权下结束 workspace。“收尾”“处理一下”不自动授权 merge、push、PR、删除 branch/worktree 或 discard。执行写动作前再次读取完整 HEAD OID 和 dirty 状态并与本轮 fresh verification 比较,相同才继续,不同则重新验证。

执行:本地合并仅适用 named branch,需定位 base 所在主 workspace 并确认 clean,按 fast-forward-only 更新,merge 已确认的完整 source HEAD OID,在 merged tree 重跑测试和 Drift Review,全部通过才 cleanup。Push 并创建 PR/MR 只有人选择后才产生远端副作用。Cleanup 仅在本地合并成功或用户明确确认 discard 时考虑,只正常删除由当前流程或 deliver-task 默认 .worktrees/、worktrees/ 创建且 clean 的 worktree,provided、external、detached 或 host-managed workspace 原样交还 owner,dirty/untracked 不 force remove,branch 只用安全删除,禁止 git branch -D,PR/MR 与 keep 都保留 source。

限制:不生成第二套 result schema、delivery proof 或 lifecycle artifact。最终以简短 Markdown 报告 source、fresh verification、Architecture Drift Review、action、merged destination 和 cleanup 事实。