skills/skills/init-workspace/assets/sections/herdr.md

Herdr Collaboration

共同协作要求

• 本工作区采用 Herdr 管理并行 worker，具体操作遵循 $herdr。遇到环境问题时，参考 init-workspace 的环境检查；需要重新扫描时，请用户以“只检查环境”调用该 skill。
• 主控负责拆分、共同接口、唯一任务负责人、跟踪、评审、集成、验收与清理；worker 只完成明确授权的任务。遵守用户的工具选择和宿主委派限制，冲突时报告；主控不重复实现已委派范围。
• 只读调研和评审不额外创建 worktree。并行修改源码的 worker 通过 Herdr 的 worktree 功能管理独立工作树与 workspace；建在实际源码仓，不在外层资料目录建树。同一文件同时只有一个写入负责人，共享契约、依赖、锁文件和公共配置由主控指定修改者。
• 共同接口未定时先设计、核验，不为填满并发提前实现。发现上游错误或需要跨范围修改时，回报成因与所需改动，不在调用方吞错或堆兼容分支。
• 任务书写明目标、仓库/分支/基线提交、共同接口、允许修改的文件、必读材料、依赖、验收命令及失败情形、停下报告的条件、提交授权和交付接收方。共同要求通过可读引用传递；worker 的 cwd/worktree 中不可见的工作区规则提供可读副本或必要摘录。
• 每个任务独立使用测试数据、临时目录和端口，共享依赖明确使用约束。worktree 不隔离凭据或外部文件，不是安全沙箱。
• 交付报告包括完成情况、提交（或未提交原因/不适用）、改动、实际检查与结果、限制和需要主控的动作。idle / done 或自动完成通知只说明运行状态，不表示验收通过。
• worker 交付后，没有补充任务、修改要求或待澄清事项时，主控不发送“收到”等确认性消息，直接评审或收尾。worker 等待明确指令，不主动续聊；修改要求、阻塞解除和任务取消仍须通知相关 Agent，主控仍向用户交付最终结果。

任务交互

• Pi 任务优先使用已配置的 Shepherdr agents，按工具帮助下发任务、发送消息和读取结果。Shepherdr 任务由 worker 的最终答复交付，主控等待插件通知。
• 未使用 Shepherdr 的任务按 $herdr 交互；worker 完成或阻塞时，通过 Herdr 向实际主控主动回传一次交付报告。
• 任务是否接收不明时，先查原任务状态，不立即降级重发。
• worktree、布局、原始终端及其他 CLI agent 由 Herdr 管理。

验收与收尾

• worker 只在授权分支提交；主控按范围检查、独立评审、依赖集成、集成验证、验收的顺序推进。push、安装、发布另按项目授权执行。
• 检查命令取自项目指令和实际配置；局部/全量测试、类型检查、真实模型、浏览器和宿主验证分别报告，不能相互替代。测试失败、实现不完整或关键条件未验证时保持未完成或阻塞，不用 skip 消除问题。
• 收尾包括源码集成、Herdr 资源和工作区文档三部分，不以关闭 worker 代替。主控按授权合并分支或应用提交，执行集成验证；Herdr workspace 是终端组织，不代替 Git 合并。
• worker 后续不再需要，且交付已送达、提交已保全、未提交文件已处理后，及时按当前工具契约关闭本轮创建的 Agent/pane，不为等待确认回复保留进程。仍需返工或澄清时可暂留并记录原因。
• 核验成果已集成或另有可恢复副本、没有活动进程和待处理文件后，按授权移除本轮无用的 worktree、分支和空 Herdr workspace。仍需使用的终端按当前 CLI 支持的方式整理到保留布局，移动后使用返回的新 ID，不搬动他人资源。关闭进程不授权删除未集成成果，无法证明可清理时保留并报告。
• 同步本轮相关的工作区文档：写入有效结论、验证和后续动作，更新任务状态与目录地图，按项目约定及授权归档或删除失效临时计划。保留仍有效的决定、风险和阻塞，不借收尾清理无关材料。
• 只清理本轮创建且已无用途的资源；移除共享依赖链接与目录前先核验，不关闭他人的终端。剩余任务和暂留资源登记负责人、保留原因及下一步，恢复时重新查询状态和 ID。