跳转到主要内容
一张 Issue 沿着 ai-* 标签从 ai-ready 走到 ai-merged,而这些标签本身就是这次交付的记录。 Orbi Cloud 不另外维护一份「真相面板」。你 Issue 上的标签、Orbi 留下的评论、它提交的 pull request,就是一次交付的全部状态。所以你只靠 GitHub 就能读取、审计和纠正所有东西。

状态机

每个标签的含义

最右一列是状态页在「任务记录」里给这个标签显示的状态标记。 没有合并就关闭的 Issue 显示「已关闭(未合并)」。 下面两个标签分别记录任务类型和人工确认: 引擎有一道人工验收门禁,开启后交付要等人确认检查清单才继续。Orbi Cloud 没有开启它,所以交付不会停下来等 ai-human-review。 所有在等你的事,也就是「卡住」「等您批准」「待补充」,还会被提到状态页顶部,在主卡显示原因和操作。

时间

工作环境就绪、额度可用、版本范围允许且有执行名额时,打上 ai-ready 后通常一分钟左右开始。标签事件会唤醒 runner,另有每五分钟一次的定时认领;这不是排队任务最长五分钟的保证。前面的任务、未关闭的依赖或版本范围都可能让它继续等。 开始后的耗时取决于任务大小和修复轮次。任务上报用量后,「任务记录」会显示用时、AI 调用和 token(含缓存)。

独立评审

评审 pull request 的那个会话不是写它的那个会话。它从头读 diff,重新跑测试,然后要么给出干净结论,要么提交发现的问题。 提交了问题之后,Orbi 修掉它们,pull request 再进下一轮。这个循环是有界的:如果轮次用尽仍然没拿到干净结论,Issue 会被标成 ai-blocked,不会无限循环下去。发生这种情况时 pull request、分支和工作区全部保留,什么都不会丢。 只有干净的评审结论才能进入合并门禁。基础分支前进且没有冲突时,Runner 可以吸收更新,等新 head 的 CI,不必重复独立评审;外部修改 PR head 时需要重新评审。合并前仍核对当前 head 和 base,见引擎的评审与合并说明。

让正在跑的交付转向

你不用等一次交付跑完才能纠正它。Issue 处于 ai-in-progress 时,加一条写着新决定的评论,或者改 Issue 正文。两条通道等价,正在跑的会话会带着你的纠正重启,通常一分钟内。 工作跑偏时就这样给它重新定向,你不需要取消任何东西。 有两个限制值得知道: 转向是有界的。 一次交付默认接受 3 次转向重启。超过之后,后续的纠正不会再重启它。让这次交付跑完,把修订后的范围放进一张后续 Issue。 只有可信的评论者能让它转向。 来自实际拥有仓库 write 权限的人的评论能让一个 run 转向;来自任意公众评论者的评论按设计被忽略,否则任何能在你 Issue 下评论的人都能改变 agent 在做什么。

ai-blocked 是决策点,不是失败

ai-blocked 是一个终态,意思是必须由人决定接下来怎么办。Orbi 在 Issue 上留下的评论会说明为什么自动恢复做不到。有几种暂停会自己恢复,不用你换标签:基础分支本身的检查没通过,等它们变绿后 Orbi 会接着做(见问题排查里「基础分支自己的检查没通过」);读取检查结果的权限补上后;在 Cloud 里把不存在的基础分支改对后,相关的票会重新排队。 决定下一步可以是改代码、改验收条件,也可以是关掉 Issue。修好原因后,还有开放 PR 就把 ai-blocked 换成 ai-fix-needed;没有 PR 就换成 ai-ready。只摘掉卡住标签不会重启。 怎么读一条 blocked 评论,见问题排查。

分享一次交付

交付合并后,Orbi 会在 pull request 上留一条评论「✅ Orbi 已交付 · 查看交付证明 →」(Orbi 消息语言是英文时为英文),链接指向 orbi.build/proof/<owner>/<repo>/<issue> 上的交付存证页。这个页面列出 Issue、pull request、评审,发版之后还会写明「已发布于」哪个版本。 公开仓库里已合并的交付,页面上有「复制链接」和「分享到 X」两个按钮。公开仓库的话,拿到链接的人都能打开;私有仓库只有用能读这个仓库的 GitHub 账号登录的人才能打开,所以分享链接不会泄露私有代码。 项目级交付记录在 orbi.build/proof/<owner>/<repo>,每张 Issue 取最近一次合并,最多列 100 条,顶部显示总数。公开仓记录可直接访问;私有仓需要 GitHub 登录且有仓库读取权限。公开的真实项目还提供 README 徽章。

任务类型

ai-ready 是所有类型任务的执行开关。第二个标签决定跑哪套 playbook: 还有一个标签影响的是顺序而不是行为:p0 把一张 Issue 标为紧急,Orbi 认领打了 p0 的 Issue 优先于打了 bug 标签的,后者又优先于没打标的。
这一页讲的是你在 Cloud 上看到的生命周期。引擎自己的参考,包括每一次状态转移、接续(resume)的确切语义和完整的配置面,在 docs.orbi.build/zh/workflow。