Next options 是一个用于规范 AI 智能体回复结尾格式的技能。其核心目标是让用户能够快速浏览回复,并通过回复一个字母来做出选择。该技能要求在整个对话过程中对每一条回复都遵循这些规则,直到用户要求恢复正常回复为止。被委派的任务向其协调者汇报时,按其简报要求的形式呈现,不带选项。
用途与结尾选择
该技能根据“下一步由谁行动”来决定每次回复的结尾方式。智能体在约定范围内继续执行可逆步骤;一个要求行动的问题(如“你能……吗?”)被视为指令,应当执行;而关于“哪一个、何时、是否、为什么”的问题则给出回答,其隐含的变更成为选项 a,而不是直接编辑。
当智能体自己会继续推进时(例如启动了子智能体、委派任务、工作流、后台命令或监视),回复以一行普通文字结尾,说明接下来要做什么以及它在等待什么,例如 Next:我会在探索智能体完成后撰写报告。除非回复中已经说明,否则加上“Nothing needed from you.”。当没有任何东西会唤醒智能体时,则在本轮继续工作。
当工作需要等待用户回答时,回复以带字母的选项结尾。这些情形包括:只有用户才能通过的节点(合并、部署、强制推送、生产写入;推送到他人拥有的分支或会驳回审批的分支;向某人发送消息;范围、接口或产品决策;凭据、支付或物理步骤;根因修复后仍失败的检查;活动工作流保留的审批);回答完问题或只读请求后,后续需要用户选择;或者只剩下 CI、机器人、他人评审或非自己发起的讨论串,且没有自己启动的东西会唤醒自己。当用户回答与自身工作同时进行时,用一行说明仍在运行的内容,然后以选项结尾。
当工作完成时,没有人需要行动,回复以“Done”结尾,不带选项:小任务用一行,或列出已完成和仍开放的事项。已完成的阶段若其下一阶段等待用户批准,则以选项结尾。
在全自主授权下(如“run until done”),智能体自行决定授权覆盖的每个调用并报告,而不是提供选项。授权留给用户的范围、接口或产品决策,智能体会应用一个默认值并报告原因,用平实语言说明用户可以如何告知不同意见,而无需回复字母。其他只有用户才能通过的节点仍然等待用户,并以带字母的选项结尾。
格式
选项格式示例如下:
Next
a→ fix 1 (currency column) and 2 (null dates), one commit each, and re-review until clean · recommendedb→ also add 3 (timeout test)c→ open the draft PR now and track 3 (timeout test) as a follow-up
最多三个选项,从 a 到 c。它们是本轮唯一的问题,因此回复不会同时以“Should I……?”结尾。只有真正的选择才作为选项:每个选项都等待用户挑选。智能体无论如何都会做的工作,即使只剩一步,也放在普通下一步中。a 是推荐项:只将其选项文字加粗并添加斜体标签。它服务于会话目标,附带工作放在其他字母下,并列出它创建的每个推送、帖子、PR 或 issue。除非用户本次会话要求,否则它不创建 issue、不向任何人发消息、不改变任何 PR 的状态。每个选项都是用户自然会采取的下一步,用平实语言表达,并像示例那样列出所引用的每一项。选项应基于本轮检查过的 PR、CI、讨论串或 issue 状态构建,并去掉该状态已使其无意义的内容。
智能体应自己完成:当 CLI、MCP 服务器(如 Executor)或计算机控制可以完成时,选项绝不应当是用户的步骤。只有凭据、支付或物理操作才交给用户,并说明原因。
等待:当下一步等待 CI、机器人、构建或其他讨论串时,先做范围内下一个独立工作。当没有其他事情可做时,a 是监视(T3 Code 中的 watch_pull_request)。
手动检查:在以 PR 监视结束一轮之前(包括每次唤醒后),运行 node ~/.agents/skills/next-options/scripts/pr-waiting-on.ts <PR>,或该技能安装位置旁的同一脚本。当判定为“person”(例如必须接受的 Chromatic 基线或等待批准的部署)时,即使用户的其他检查仍在运行,也由用户行动:停止监视(T3 Code 中的 unwatch_pull_request),将每一项及其链接放在“Needs you”下,并以选项结尾。这样的检查永远不会自行完成,因此等待它会阻塞 PR。
应省略填充项,如 stop、done、列出开放项或“其他”,以及用户在前两次列表中都已跳过的任何选项,包括过去的 a。
编号条目
发现、问题和开放项在整个会话中保持其编号,新项目继续计数。摘要或交接时,每个编号与其名称保持对应。用户可以回答 3 来讨论第 3 项、skip 3、? 查看当前步骤和开放项,或使用组合如 a, skip 3,或用自己的话回答。这些回答永远不会得到选项行。
工作流交接
当该库的流程某一阶段完成时,通常的 a 是用户尚未确定的下一阶段:
- /grill-with-docs 完成后,a 通常是 /pstack-mode 来构建已商定的设计,或 /to-spec 将其拆分为工单。
- /to-spec 完成后,a 通常是 /to-tickets,在针对任何可通过运行来确定的开放问题制作原型之后。
- /to-tickets 完成后,a 通常是 /implement-spec。
- Pstack 原型完成后,a 通常是通过 Pstack 的 Feature playbook 构建推荐变体,或 /architect 确定其形态。
- 实现完成但评审发现仍开放时,a 是修复它们并重新评审。
- 干净评审但没有 PR 时,a 是通过 /pr 打开草稿 PR。
- 草稿 PR 时,a 是监视它,或处理其评审评论。
设置
要在每个 Claude Code 和 Codex 会话开始时加载这些规则,请在用户要求时遵循设置参考。