学习精选 · AI 工具
Codex

delivery-loop:让 Claude Code 和 Codex 从工单一路跑到交付的插件

DEV Community2026-11-17约 5 分钟读完AI 整理查看原文

作者开源了一个叫 delivery-loop 的插件,把任务从工单、实现、验证到交接串成十个阶段的闭环。真正让它能跨团队复用的不是流程本身,而是把团队惯例按组织、项目、仓库分层写进 profile,并持续校验是否过期。文中还分享了一个真实踩坑:规则明明在集成分支上,代理却因为从旧分支启动而没读到。

今天就能做

  • 把团队惯例按「组织级、项目级、仓库级」分层写成 profile,就近覆盖,避免复制粘贴到每个仓库。
  • 给 AI 代理读的指令文件要设过期机制:定期重验、冲突时以新日期为准,别默认写对就一直对。
  • 会话从非集成分支启动时,让代理从实际工作的分支重新读取指令文件,否则可能漏掉新规则。

十阶段闭环:理解、构建、证明、交接

  • 任务分四组十个阶段,小任务可跳过规格、开放问题和计划,直接进入实现。
  • Understand 阶段会检查工作是否其实已完成(比如工单标着 pending 但改动早已通过未引用它的 PR 上线),创建隔离工作区,把工单拆成带稳定 ID 的要点,并让另一个代理先审计划。
  • Build 阶段先写测试再改代码,提交与 ID 绑定,之后由 profile 指定的审阅者独立评审。
  • Prove 阶段不等部署报成功,而是等测试环境真正跑在那个 commit 上,再逐条核对 ID,能看的用截图或录屏上传到工单,API 和队列则用真实响应作证据。
  • Hand over 阶段完成上线或明确交接,工单带着证据关闭,分支、工作区和测试数据一并清理。

惯例写一次、写在它成立的层级

  • 插件核心不绑定任何工具,所有具体做法放进 profile,层级对应惯例原本所在的位置:全组织适用的(如上线由平台团队负责)放组织层,单个仓库的(如集成分支是 develop)放仓库层。
  • 层级由远及近合并,就近优先,但像「绝不拿生产环境做测试」这类不变量,低层级不能放宽。
  • 组织把 profile 放在一个私有仓库,新人装好插件跑一个脚本,就能拿到组织 profile 加上自己有权限的项目的 profile。
  • 首次运行会自动探测能探测的部分,剩下的一次性问答补齐,答案按层级写入并发布到共享仓库,之后的人不用再答一遍。

两个组织、同一套核心

  • 作者在两个工作方式完全不同的组织里用同一个插件:一个用 develop 集成、靠单独的配置仓库改版本进测试环境、上线归别的团队;另一个是多个客户项目各有环境和发布流程,客户仓库绝不能收到己方文件。
  • 所有差异都只是各层级 profile 里的一行,核心代码在 Claude Code 和 Codex 里完全不变。
  • 个人 profile(账号、机器限制、浏览器工具)只写一次且永不进共享仓库,共享仓库的 CI 会检查共享文件里不含个人数据。
  • 客户仓库的 profile 留在 .git 内本地保存,不会被推送出去。

profile 会过期,所以要反复校验

  • 每个任务开始时做一次低成本比对,发现 profile 与仓库实际不符就更新对应层级并在报告里记一行。
  • 超过 30 天的数据在循环依赖它之前必须重新验证。
  • 两个来源冲突时以日期较新者为准,并把过期的在它所在的层级修好,让修复惠及所有共享者。
  • 任务进行中还会重新合并 profile,因为规则可能中途变化。

踩坑:规则在另一条分支上

  • 仓库在 PR 清单里新增了「AI 生成的代码必须有人工确认」的规则,同一次会话停下来要求确认,但之前两次会话却直接合并了。
  • 原因:三次会话都从旧分支的 checkout 启动,指令文件是规则加入前的版本,工作虽在集成分支的新 worktree 里进行,但只有一次碰巧重新读了那里的指令。
  • 修复方案:会话若不是从集成或生产分支启动,插件就从工作实际发生的 workspace 读取指令文件,并记录它们来自哪个分支。

开工前先探测能力,减少中途提问

  • 任务开始前对要用到的每个能力做真实调用探测,因为「已配置」不等于「已认证」,「已认证」不等于「能用」,gh auth status 报告的账号和实际执行命令的账号可能不是同一个。
  • 失败项汇总成一轮提问,答案按层级保存,之后不再重复问。
  • 留给人的只剩真正属于人的决策:业务判断、面向客户的文案、以及那条规则要保护的人工确认。

原文:The Rule Was on the Other Branch

来源:DEV Community · 2026-11-17

查看原文

本文由 AI 阅读原文后整理,未经人工逐字核对,内容以原文为准。

登录后可以点赞、查看和发表评论