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

Herdr Collaboration

• 本工作区采用 Herdr 管理并行 worker。操作前检查 HERDR_ENV=1，读取宿主可访问的 $herdr；宿主未列出时，在 Herdr 内运行 herdr --skill 并读取返回指令。核验 CLI 与当前会话，以当前 skill 和 CLI 帮助为准。不可用时串行推进或请用户进入 Herdr，不从外部操控会话或绕用其他后台方式。
• 主控负责拆分、共同接口、任务负责人、跟踪、评审、集成、验收与清理；worker 只完成明确授权的任务。主控自身的子任务可以串行委派。
• 只读调研和评审不额外创建 worktree。并行修改源码的 worker 通过 Herdr 的 worktree 功能管理独立工作树与 workspace；建在实际源码仓，不在外层资料目录建树。
• 每项任务有唯一负责人；同一文件同时只有一个写入负责人。共享契约、依赖、锁文件和公共配置由主控指定修改者。共同接口未定时先设计、核验，不为填满并发提前实现。
• 发现上游错误或需要跨范围修改时，回报成因与所需改动，不在调用方吞错或堆兼容分支。
• 任务书写明目标、仓库/分支/基线提交、共同接口、允许修改的文件、必读材料、依赖、验收命令及失败情形、停下报告的条件、提交授权和交付接收方。材料必须在 worker 的 cwd 或 worktree 中可读。
• 后台创建保持用户焦点；使用返回的 workspace/pane ID 和唯一 Agent 名称。启动后核验身份、模型、cwd、分支、必需 skill 的可访问性和可接收任务状态。只读任务也要明确使用的代码基线。
• 每个任务独立使用测试数据、临时目录和端口；共享依赖明确使用约束。worktree 不隔离凭据或外部文件，不是安全沙箱。
• 双向消息以 [主控] 或 [任务名] 开头。完成或阻塞时按本节开头的方式获取并读取 Herdr 指令，通过 Herdr 向实际接收方主动回传一次：完成情况、提交（或未提交原因/不适用）、改动、实际检查与结果、限制、需要主控的动作。只在自己的终端打印不算交付。
• worker 回传后，没有补充任务、修改要求或待澄清事项时，主控不发送“收到”等确认性消息，直接评审或收尾，避免触发无效模型回合。worker 等待明确指令，不主动续聊。修改要求、阻塞解除和任务取消仍须通知相关 Agent；主控仍向用户交付最终结果。
• 回传不等待主控当前任务结束；发送失败时保留消息并报告，不连续重发或操纵对方按键。idle / done 只是运行状态，不表示验收通过。
• worker 只在授权分支提交；主控按范围检查、独立评审、依赖集成、集成验证、验收的顺序推进。push、安装、发布另按项目授权执行。
• 检查命令取自项目指令和实际配置；局部/全量测试、类型检查、真实模型、浏览器和宿主验证分别报告，不能相互替代。测试失败、实现不完整或关键条件未验证时保持未完成或阻塞，不用 skip 消除问题。
• 收尾包括源码集成、Herdr 资源和工作区文档三部分，不以关闭 worker 代替。主控按授权合并分支或应用提交，执行集成验证；Herdr workspace 是终端组织，不代替 Git 合并。
• worker 后续不再需要，且交付已回传、提交已保全、未提交文件已处理后，及时通过 Herdr 关闭本轮创建的 Agent/pane，释放资源，不为等待确认回复保留进程。仍需返工或澄清时可暂留，并记录原因。
• 核验成果已集成或另有可恢复副本、没有活动进程和待处理文件后，按授权移除本轮无用的 worktree、分支和空 Herdr workspace。仍需使用的终端按当前 CLI 支持的方式整理到保留的布局，移动后使用返回的新 ID；不为整齐搬动他人资源。关闭进程不授权删除未集成成果，无法证明可清理时保留并报告。
• 同步本轮相关的工作区文档：将有效结论、验证和后续动作写入对应文档，更新任务状态与目录地图，按项目约定及授权归档或删除已失效的临时计划。保留尚有效的决定、风险和阻塞，不借收尾清理无关材料。
• 只清理本轮创建且已无用途的资源；移除共享依赖链接与目录前先核验，不关闭他人的终端。剩余任务和暂留资源登记负责人、保留原因及下一步，恢复时重新查询状态和 ID。