用途:herdr-pm-agent 是 mounted by herdr-pm-init 的 per-tab operator brain,作为单个被管理智能体的技术 PM/CTO,与其在同一 herdr 标签内并排运行。它阅读该智能体会话、判断重点、向人类展示评分选项,并通过 herdr 驱动既有智能体完成工作;独立任务会 fan out 为并行 worktree 通道。它是 conductor:负责编排与验证,不自己写代码。
进入方式:一种是由 launcher(herdr-pm-init)spawn 并附带 assignment block;另一种是人工直接在某标签调用它,此时没有 assignment block,需先自举:确定所管理的标签、询问模式(power/light)与 autopilot、必要时搭建 power world,并写自己的 assignment 文件。assignment 字段包括 managed_pane、managed_term、session_id、repo、mode、autopilot、language、your_term、world。缺失字段应向人类询问一次,不要猜测 pane id 或 session id。
主要能力与流程:核心循环为 ONBOARD(仅 POWER)→ BRIEF(读被管理会话与 git 实际状态)→ ASK(给出情境简报与恰好 5 个 Impact×Effort 评分选项,首项为推荐,可多选)→ DRIVE(把选择转化为 mission 级指令,独立任务并行到 worktree 通道,其余交给被管理智能体,等待、读取、验证标记)→ REPORT(迷你变更日志与后续 ≤3 项)→ LOOP(按选定 autopilot 级别继续)。
必要用法:确认 HERDR_ENV=1;若 shell 找不到 herdr,运行 command -v herdr >/dev/null || export PATH="$HOME/.local/bin:$PATH"。先运行 pm.py capabilities 作为 boot doctor。通过 pm.py 的 CLI 封装操作,例如 pm.py read、pm.py status、pm.py dispatch、pm.py spawn-exec、pm.py diagnose、pm.py review、pm.py await、pm.py keys、pm.py notify,以及 herdr wait output、herdr agent wait、herdr pane read 等。
限制:human-gated 决策必须主动提问而非搁置;大多数“下一步”分叉应由 PM 自行决定。pane id 会重新编号,不可信任保存的 pane id,应通过稳定 terminal id 重新解析。~/.local/state/herdr-pm/PAUSE 文件存在时 pm.py 拒绝变更类操作,应置状态为 paused 并等待其被移除。等待应采用后台双路等待,避免 fire-and-forget;长任务超时通常表示仍在工作,应 peek 后重新布防。
资料未提供的内容:收费、价格、支持平台清单、具体效果指标等。