用途:把代码审查委派给一个在 Herdr 当前工作区同级窗格中新建的编码代理,由该代理端到端执行 team-code-review 技能并返回报告。本技能只负责交接和审查代理的生命周期,不亲自做审查。
主要能力与流程:
- 先判断是否应委派:检查 HERDR_ENV=1;若不在 Herdr 内则说明无法控制 Herdr,改为在当前代理运行 team-code-review;若当前任务带 HERDR_CODE_REVIEW_REVIEWER=1 标记,说明自己就是被派出的审查者,不得再派生代理,直接执行 team-code-review。
- 发现调用方:加载 herdr 技能,用 herdr pane current --current 与 herdr agent get <caller-pane-id> 解析调用窗格,审查者必须与调用方为同一代理运行时/类型(pi→pi、claude→claude、codex→codex),不得从模型供应商或名称推断。
- 准备自包含交接:仓库/工作树绝对路径、调用方工作目录、自有工作还是他人 PR、已提交审查的 base/head SHA、未提交工作是否含暂存/未暂存/未跟踪文件、用户约束、非目标、已运行的检查,以及 team-code-review/SKILL.md 的绝对路径。
- 每次新审查或复审都要替换旧审查者:保留旧报告,用 herdr agent get 核对身份,再用 herdr pane close <previous-reviewer-pane-id> 关闭已验证的专用审查窗格,确认关闭后再启动新代理。
- 启动一个全新审查者:用 herdr pane layout 查看布局,herdr pane split --current --direction <right-or-down> --cwd "$PWD" --no-focus 拆分同级窗格,读取新窗格 ID,检查 herdr agent list 后以 herdr agent start <reviewer-name> --kind <caller-kind> --pane <new-pane-id> 启动,并通过 herdr agent prompt 提交带 HERDR_CODE_REVIEW_REVIEWER=1 标记的自包含提示。
- 收集报告:用 herdr agent prompt <reviewer-name> <prompt> --wait --timeout 120000,超时后用 agent get/agent read/agent wait 继续;用 herdr agent read <reviewer-name> --source recent-unwrapped --lines 200 读取完整报告,若被截断可让审查者把完整报告写入临时 Markdown 文件再读取。
适用场景:在 Herdr 工作区内需要把完整团队代码审查交给独立、全新上下文的代理执行,并希望保留审查窗格供检查时。
限制与护栏:审查为只读,调用方与审查者都不得编辑、暂存、提交、推送或发布评论;每轮审查只派生一个审查者,使用现有工作区与调用方 cwd;用 --no-focus 保留用户焦点;ID 必须从 JSON 响应解析;不得绕过审批或权限控制;若用户明确要求在当前代理审查,则不要委派。官方文档未提供更多安装或收费信息。