用途
Dispatch Authoring 用于把一个已规划好的变更交接给编码智能体,使其能在无人监督的情况下执行,并产出一份人类可审查的结果。它适用于以下场景:将已规划变更交给智能体独立运行;把工作排入队列,让它在夜间或后台运行;把规格或工单集转成智能体可执行的简报;标准化交接流程,使智能体运行结果可比较、可衡量;在派发单发出前审查草稿。
它不适用于:编写派发单所实现的规格或 PRD;编写用于跟踪工作的工单;审查智能体返回的 PR;长期衡量智能体通道的表现;与智能体交互式配对完成小改动(派发单面向无人值守运行)。
主要能力
该技能定义了派发单的七个组成部分,每一部分回答智能体本需猜测的一个问题:
- 头部:日期、目标仓库、可见性、通道、分支名和角色(谁规划、谁执行、谁合并)。
- Gate 0:智能体在任何写入前运行的检查,每项检查都配有失败时的停止动作,包括核对远程仓库的准确所有者与名称、核对可见性、使用全新工作树或分支而非规范检出或默认分支、按顺序阅读仓库的编写指南、贡献指南、最近示例和将调用的脚本、记录生成文件的产生方式(哪个脚本、哪个参数),绝不手工编辑生成文件。
- 范围:先写纳入,再写排除;点名可变更的文件或区域,以及不得变更的部分。
- 规格说明:详细到智能体无需提问;指向源规格而非粘贴,除非智能体无法访问;给出约束、约定和可参照的示例;需要判断时说明优化目标。
- 验证:智能体证明工作完成的方式,包括精确命令、每条命令的预期结果、要回读的文件;要求粘贴输出而非总结。
- 交付:分支名、提交结构、保持草稿状态的 PR、PR 正文格式和清理责任。智能体以草稿形式打开 PR 后停止,永不合并。
- 停止条件:Gate 0 检查失败、缺少必需脚本、规格存在影响结果的歧义、操作具有破坏性或不可逆(强制推送、改写历史、删除数据、触碰默认分支)时,智能体必须停止并报告。
每份派发单都应声明的原则:智能体永不合并,人类在落地前阅读差异;诚实的停止优于编造完成;工具成功消息不是证据,要回读文件、运行检查并粘贴输出;一个工作树只对应一份派发单,并行派发在同一检出中会冲突;在运行时推导数量和列表,写“文件夹中的每个技能”而非“42 个技能”,硬编码数字会过时。
使用方式
工作流程:确认计划就绪(规格存在、工单就绪、验证命令已知);从 references/dispatch-template.md 开始;填写头部并对照实际远程仓库核对所有者、仓库和可见性;使用 references/gate-zero-checklist.md 编写 Gate 0,每项检查都有停止动作;先写范围再写规格说明;写验证(精确命令、预期结果、回读文件);写交付和停止条件,仅草稿 PR,PR 正文格式见 references/pr-body-template.md;以智能体视角通读,找出所有需要提问之处并在派发单中回答或转为停止条件;发出后记录派发日期和结果,以便衡量通道。
输出格式:每份派发单一个 markdown 文件,命名为 dispatch-[short-name]-[YYYY-MM-DD].md,按七部分顺序排列,保存在规划者自己的记录中而非目标仓库;智能体的 PR 正文遵循 references/pr-body-template.md。
参考文件:references/dispatch-template.md(可填写的七部分派发单)、references/gate-zero-checklist.md(写前检查及对应停止动作)、references/pr-body-template.md(智能体返回的草稿 PR 正文,含验证输出和未决问题)、references/example-dispatch-new-skill.md(向虚构技能目录添加一个技能的已填写示例,用于校准细节和语气)。
必要输入
智能体将实现的计划或规格;目标仓库及其可见性(公开或私有)和默认分支;仓库自身的贡献和编写规则(如有);证明工作完成的命令(测试、lint、构建、生成器);谁合并、谁在事后清理。如果不知道工作将如何验证,应停止并查明;没有验证的派发单等于要求自信猜测。
适用场景与限制
适用场景包括夜间无人值守运行、后台队列工作、把工单集转为可执行简报、标准化智能体交接。限制与常见失败模式:缺少 Gate 0 会导致写错仓库、分支或规范检出;把“让它工作”作为验证会导致智能体报告成功;授予合并权限会移除唯一的人类检查;硬编码数量会过时;缺少停止条件会让智能体在缺脚本或规格歧义时即兴发挥;粘贴并转述规格会产生两个版本的真相;范围只写“纳入”会让智能体顺手整理附近代码;同一检出中的两份派发单会互相冲突;信任智能体总结而非阅读差异和验证输出;在公开仓库派发单中泄露私有路径、客户名或私有仓库名。该技能本身的价格、平台支持范围等细节资料暂未提供。