不知道下一步该做什么
看状态页上的开通步骤清单，高亮步骤会告诉你在等什么。安装 App、连接仓库、写第一个需求这三步有「看这一步怎么做 ▶」视频。快速开始提供完整文字步骤。 环境就绪后，Orbi 会读仓库并生成建议，通常 2 分钟。「Orbi 正在读…」时可以先离开；建议就绪后，新任务点「查看需求」，确认草稿再交付，已有 Issue 点「让 Orbi 做这个」直接派发。没有建议可点「获取建议」，也可直接「写需求」。见第一张 Issue和写需求。打了标签但什么都没发生
按顺序查：- 这张 Issue 真的带了
ai-ready吗？ 这是最常见的原因。光写 Issue 不够，开始干活的信号是这个标签。去 GitHub 上看一下 Issue 的标签。状态页的「让 Orbi 做这个」和写需求页的「交给 Orbi 开始做」会替你打上这个标签。 - 它在已连接的仓库里吗？ Orbi 只读你连接的仓库里的 Issue。看状态页上的项目概览。
- 工作环境准备好了吗？ 开通步骤清单里的「准备工作环境」必须显示「已完成」。在那之前没有环境可以跑交付。
- 过了 5 分钟吗？ 打上标签后一般 1 分钟内就会唤醒 Orbi，每 5 分钟一次的定时器是兜底。
- 标签是不是被摘掉了，还多了一条评论？ 你的免费交付用完了，见额度与限制。订阅，然后重新打标签。
- 页面上写着「本月 AI 用量已用完，暂停接新任务」吗？ 新 Issue 会一直等到额度重置，或者等你绑定自己的模型 key，标签不会被摘。见额度与限制。
- 页面上写着「有任务不在当前版本里，暂时不会做」吗？ 你设了当前版本（交付范围），而这张 Issue 不在那个版本的里程碑里。把它挪进这个版本，或者切换当前版本，见发版。
- 这张 Issue 是不是已经带了别的
ai-*标签？ 已经是ai-in-progress或ai-merged的 Issue，再打一次ai-ready不会重新派发。
ai-blocked
ai-blocked 是有意的停止，不是崩溃。它的含义是：自动恢复不安全，需要一个人来决定下一步。状态页会显示「Orbi 卡住了，需要您看一下」，并写明是哪张 Issue。
先读 Orbi 留在 Issue 上的那条评论，它写了为什么进行不下去。Orbi 记下了原因时，状态页上的卡片会用一句话概括，卡片上的「查看 Orbi 的说明」按钮直接打开那条评论；没有记下原因时，按钮是「在 GitHub 查看（Issue #N）」。常见原因：
- 修复循环跑完了允许的轮次，仍然没拿到干净的评审结论。
- 缺少一个外部前置条件，也就是交付自己无法安全判断或修复的东西。
- 发版用的里程碑不存在。遇到这种情况，状态页会提供「创建版本并继续」。
- Issue 要求的事情，交付环境做不到（见下）。
ai-blocked 换成 ai-fix-needed，Orbi 会在同一个 PR 上接着改，评审轮次重新计算；还没有 PR 的，把 ai-blocked 换成 ai-ready。修根因经常意味着改 Issue 本身：把验收标准写清楚、删掉做不到的要求，或者拆成更小的 Issue。
只摘掉
ai-blocked 标签不会重启任何东西，只留一条评论也不会。修掉原因，再按有没有 PR 换成 ai-fix-needed 或 ai-ready，这才是把 Issue 放回队列的动作。环境满足不了的验收标准
Issue 被 block 的一个高频原因，是要求了交付环境里不可能存在的证据。那个环境有你的仓库和你的测试，没有你的生产凭据、第三方账号、对着线上站点的真实浏览器，也没有你的部署流水线。 写着「部署到生产并确认」「登录线上后台截图」「用真实失效的 token 复现」这类验收标准的 Issue，会空转然后 block。把它改写成仓库内可验证的东西，比如断言渲染出的文案、断言错误分类、断言不该出现的内容；生产侧的证据由你自己去取。Orbi 需要更多信息
任务状态显示「待补充」（ai-needs-detail），状态页上会出现一张「需要您补充信息」的卡片，写明需求还缺哪三件事：做完后用户能看到什么变化、怎么算做完、一次只提一件事。点「补充需求」。这会打开写需求页，你在那里补充好的内容会追加到 Issue 正文，Issue 也会自动回到 ai-ready。
也可以在 GitHub 上处理：把缺的内容补进 Issue 正文，然后重新打上 ai-ready。Orbi 再次认领时读的是 Issue 正文，只在评论里回答是不够的。
Orbi 已经给出方案时
有时 Orbi 的评论里已经带了方案，状态页的卡片会直接把它列出来：- 「Orbi 建议把这张票拆成 N 张」：每张一行标题、一行验收。点「按这个拆分开工」，Orbi 开出这几张票，每张单独开发、单独合并；原票变成父票，拆出来的票都完成后自动关闭。
- 「Orbi 帮您补好了验收条件」：列出 Orbi 根据你的描述补的几条验收条件。点「就按这个开工」，这几条会写进原票，Orbi 随即开工。
/orbi split 或 /orbi amend 评论，所以你要有这个仓库的写权限；自己在 GitHub 上回复这条命令，效果一样。点完卡片显示「已提交，Orbi 正在处理」，一般一两分钟。过了几分钟卡片还停在「已提交」，到这张 Issue 上看 Orbi 对这条命令的回执：没执行时回执写明原因。按原因直接在 GitHub 上修改 Orbi 那条建议评论，再在这张 Issue 下重新评论同一条命令（/orbi split 或 /orbi amend）。
配置的基础分支不存在
进「管理项目 → 改基础分支」，选择已有分支，点「保存基础分支」。因旧分支不存在而卡住的 Issue 通常 1–2 分钟会自动重新排队。不用为此断开重建项目或手动换标签，见修改基础分支。基础分支自己的检查没通过
同一项检查在 Orbi 评审过的 PR 上和基础分支本身都没通过时，这个 PR 修不好它，Orbi 就不合并，把交付暂停在ai-blocked。状态页卡片会说明这次改动已经写好、评审通过、测试也过了，并逐项列出基础分支上没通过的检查。
点「让 Orbi 开修复票」，Orbi 会为每项没通过的检查开一张修复票并排队，卡片显示「已提交，Orbi 正在开修复票。」基础分支变绿后，Orbi 自动接着做原来那张需求，标签不用你动；它照常要过评审、CI 和分支保护才会合并，仓库要求人工批准时仍要批准。自己修好基础分支，效果一样。这个按钮用你自己的 GitHub 账号发一条 /orbi fix-base 评论，所以要有仓库写权限。基础分支过了七天还没变绿，Orbi 会提醒一次，然后不再等；等它变绿后，自己把 ai-blocked 换成 ai-fix-needed。
没收到 Telegram 消息
检查「设置 → 通知」是否开启、已保存的 Chat ID 是否正确，以及机器人能否发言。请求测试后等 1–2 分钟，到 Telegram 看实际收件；配置修改可能需要 1–10 分钟。通知失败不会改变任务结果，期间仍用 GitHub 或状态页查任务。见通知排错。PR 在等我批准
标题显示「需要您在 GitHub 上批准这次改动」，任务状态显示「等您批准」。你的分支保护要求一个 approving review，而 Orbi 不能自己批准自己。批准这个 PR，或者改掉这条规则，见分支保护。PR 写得不对
在 Issue 上评论说明要改什么，或者直接编辑 Issue 正文。正在跑的交付会带着你的修正重启，不需要关掉什么，也不需要取消。见中途调整交付。 如果这个工作干脆不要了，关掉 Issue。如果那是一次免费交付，关闭且未合并会把名额退回来。工作环境准备失败
状态主卡会说明这件事是需要你处理、正在重试，还是平台正在恢复；点「查看原因与处理方法」会跳到「用量与设置」→「已连接的项目」，那里有原因、发生时间、「出错编号」和下一步。一共四类，完整说明在准备工作环境：
联系支持时把出错编号一起发过去。旁边的邮件联系链接会自动把出错编号写进邮件标题。
连不上仓库
完整说明见连接仓库。