2026年8月4日

完成开发分支技能 — 四个选项,无需猜测

Datarim 如何弥合“测试通过”与“工作完成”之间的差距 — 通过结构化的四选项菜单、感知工作树的清理,以及不依赖 stdout 文本的推送验证。

实现完成和分支准备好发布是两件不同的事。finishing-a-development-branch 技能处理两者之间的步骤:它验证测试、检测工作区状态、呈现恰好正确的选项、执行所选选项,并正确清理 — 不会留下孤立的工作树或已合并的分支。

当开发者表示实现已完成时,该技能会运行。其核心流程是:验证测试、检测环境、确定基础分支、呈现选项、执行选择、清理工作区。

四选项菜单

对于普通仓库和命名分支工作树,该技能呈现恰好四个选项:本地合并回基础分支、推送并创建拉取请求、保持分支原样以便稍后处理,或丢弃工作。对于分离 HEAD 工作区 — 即由 harness 外部管理的工作区 — 本地合并选项会被移除,改为呈现三个选项。

该菜单有意保持简洁。添加解释或注意事项是一种反模式;结构本身承载了决策面。丢弃请求需要输入单词“discard”作为确认;没有绕过该步骤的捷径。

通过 SHA 而非 stdout 验证推送

在 git push 之后,显示远程分支引用的规范输出行经常会被钩子包装器重写或截断 — 令牌缩减器、lint 过滤器、终端多路复用器。基于该文本决定下一步,曾导致代理在已经成功的推送操作上等待 15 分钟。该技能通过直接将本地 HEAD SHA 与上游跟踪引用进行比较来验证推送成功:如果匹配,则确认推送成功;如果不匹配,则推送失败,流程停止。

同样的 SHA 相等性检查也适用于拉取和获取操作。当上游跟踪引用尚未配置时 — 在新分支的首次推送时 — 该技能使用 git ls-remote 读取远程 SHA,并将其与本地 HEAD 进行比较。

工作树清理规则

清理仅针对选项 1(本地合并)和选项 4(丢弃)运行。选项 2 和 3 始终保留工作树 — 选项 2 是因为操作员在根据拉取请求反馈进行迭代时需要它保持存活,选项 3 是因为操作员明确选择稍后处理。

当清理确实运行时,该技能会在移除任何内容之前检查来源。代理创建的临时工作树位于 .worktrees/ 或 worktrees/ 下,可以安全移除。~/.config/ 下的外部工作树管理器路径归该工具所有,不得触碰。清理始终从主仓库根目录运行 — 而不是从工作树内部 — 随后执行 git worktree prune 以清除任何过期的注册。

测试失败是硬性停止

如果测试套件报告失败,该技能会在呈现任何选项之前停止。它会显示失败的测试,并声明在它们通过之前不能进行任何合并或推送。这不是建议性的 — 该技能不会提供继续进行的选项。理由是,在损坏的分支上呈现集成选项会创造一个本不应存在的选择。

在什么是 Datarim中了解更多关于 Datarim 流水线的信息,或查看expectations-checklist 技能如何在分支关闭之前确保工作符合操作员的原始意图。