用途:这是“worker-protocol”行为契约,用于约束被派出执行任务的 worker 智能体,通常由 worker-dispatch 嵌入到 worker 提示词中,让每个 worker 按统一规范启动、汇报、退出与交接。核心原则为:单一用途、自我记录、优雅退出。
主要能力:
- 隔离要求:worker 必须在独立的 git worktree 中工作,禁止直接在主仓库操作。开工前须先验证隔离环境,确认当前目录是 worktree 且处于 feature 分支而非 main/master,否则立即停止、向 issue 报错并退出。
- 启动清单:验证 worktree 隔离、完整阅读被分配的 issue、查看 issue 评论中的上下文与历史、确认处于正确 feature 分支、检查 worktree 是否干净(git status)、运行现有测试建立基线、向 issue 发布启动评论(含 Worker ID、尝试次数、分支、理解与计划)。
- 进度上报:在启动、里程碑、阻塞、完成时向 issue 发帖,格式包含状态、轮次计数与勾选清单。
- 退出条件:任意一个条件满足即退出并返回结构化 JSON。COMPLETED(成功,返回含 pr 与 summary)、BLOCKED(穷尽选项后遇到外部依赖阻塞)、HANDOVER(接近轮次上限时准备交接)、FAILED(需要研究)四种,各自有对应评论模板与返回字段。
- 评审门禁:创建任何 PR 前必须完成 comprehensive-review(7 项标准),将评审产物以指定注释标记发到 issue,处理全部发现项(未处理数为 0),状态为 COMPLETE。PreToolUse 钩子会阻止没有有效评审产物的 gh pr create。
- 安全敏感文件:若修改 auth、api、password、token、secret 等路径,需完成 security-review 并纳入产物。
- 行为规则与提交格式:仅处理分配的 issue、TDD 先写测试、频繁提交并使用描述性信息、提交信息含类型与 issue 号及 Worker ID;不得开启其他 issue、改无关代码、跳过测试、无评审产物就建 PR、超过 100 轮继续。
- 轮次感知:0-80 轮正常作业,80-90 轮监控并按需准备交接,90 轮以上定稿并交接。交接时向 issue 发布带 HANDOVER 标记的内容、提交全部工作并以 HANDOVER 状态退出。
使用方式:作为协议文档嵌入 worker 提示词,worker 按其中清单与模板执行。集成要求遵循 issue-driven-development、strict-typing、ipv6-first、tdd-full-coverage、clean-commits、worker-handover、comprehensive-review、apply-all-findings、security-review、deferred-finding、review-gate 等技能,并由 PreToolUse 与 Stop 钩子强制校验。
适用场景:多 worker 并行、按 issue 驱动的自动化开发与代码交付流程。
限制:目前仅见协议与流程说明,具体安装方式、依赖版本与运行环境要求暂未提供。