用途:把每个任务交付为一个聚焦的拉取请求,并附带证明。规格即工单,可接受 Markdown 规格、GitHub issue 或带验收检查的已决定任务,不另建第二份工作定义。所需技能直接从其 SKILL.md 文件读取为工作流指令,不通过客户端会阻止的技能命令调用。
准备:阅读源码、仓库说明、相关需求与架构、代码和测试;继续工作时复用已有分支、工作树和 PR。确认结果、范围、决策与检查充分;若缺少关键选择,回到 /spec 或先报告所需决策再实现。小且已决定的工作不写规格。较大规格可用 /plan 拆分,每个任务交付一个可用结果,识别依赖并并行启动独立工作。
交付与修复:创建或复用隔离分支与工作树,独立工作从最新远程默认分支开始,遵循仓库命名与工作树规则。实现任务及针对变更行为和受影响失败的有意义测试;变更影响需求、架构和规格时同步更新。用 /test 证明验收与受影响规则,提交前修复失败。创建 Conventional Commit、推送并打开或更新 PR,遵循仓库 PR 模板,先写问题与结果,附证明和来源链接,标记为可审查,并在支持时把跟踪工单移到 Review。用未实现该变更的新子代理执行 /review,等待当前提交上配置的 CI 与自动审查。修复有效发现和由变更导致的失败,对审查发现回复修复或不变更的证据,仅在完全处理后解决线程。修改实现后重复受影响的 /test 检查与新的 /review,提交、推送并再次等待 CI 与自动审查,更新 PR 证明,直到所有可用检查通过且无待处理发现。
依赖:仅当每个前置任务已有打开的 PR、新的 Approve 审查且无已知阻塞发现时,才开始依赖工作,其分支堆叠在已审查的前置之上;多个前置按依赖顺序合并,每个 PR 差异聚焦自身任务。前置变更或合并时,更新依赖分支与 PR 基,针对新基重复受影响测试、独立审查和 CI。
合并权限:仅显式使用 /factory 或 /codex-issue-coordinator 才授予其范围内的合并权限,否则仅在用户要求时合并,自动技能选择不授予该权限。合并前要求:最终提交上完整范围与验收证明;测试、必需 CI 和新的 /review 判定为 Approve;无未解决的可操作审查发现或关键决策;所有仓库要求的批准;PR 就绪、可合并且与所需基同步。按依赖顺序用仓库首选方法合并,绝不绕过分支保护。确认 GitHub 报告合并后,更新来源规格或任务中的交付状态,并更新原始 issue 与项目状态。合并或关闭后移除手动创建的工作树,托管工作树用宿主生命周期工具,保留打开 PR 的工作树。合并权限不授权部署或发布。
返回:报告每个 PR、测试、审查判定、CI 状态和阻塞。除非获得范围内合并权限,否则以通过的 PR 保持打开结束;合并模式下报告已验证的合并和仍需人工处理的工作。限制:资料未提供具体安装命令、收费或平台信息。