用途:管理 agy 的后台 staffer、研究、评审与实现任务,包括收集结果、查看状态、取消、延续对话与可选的权限设置。状态按仓库保存在 .agy-staff/ 目录,仅 ask 为同步运行。
主要能力:通过命令 node "<skill-dir>/../../companion/agy-companion.mjs" <command> [args] 调用。支持 observe [id](仅在用户明确要求进度或失败/需干预后诊断时使用,返回有界 JSON,不含报告正文)、status [id](列出任务或显示某任务状态与日志尾部)、result [id](重打印已存输出,默认最新已完成任务)、cancel <id>(停止该任务执行,中断 wait 不会取消任务)、continue --job <id> --prompt "..."(以原模式/模型/配置续接对话并创建关联新任务)、restart <id>(用原任务配置重新开始,不带原对话,创建关联新任务)、setup [--apply] [--restrict <modes|none>](可选权限设置,需先阅读 references/setup.md)。
使用方式:默认流程为准备提示 → 派发 → 等待最终结果 → 按需验证。运行中不要主动调用 observe/status、读日志或检查中间产物,也不要创建 sleep/observe 循环。保留返回的 job id,在后台以与启动相同的非沙箱上下文运行 wait <id> --timeout 10m,每个任务单独 wait,切勿在同一 shell 中串行等待多个任务。wait 需按退出码分支:0 表示调用结束并已交付响应文本,评估是否满足任务;2 表示仍在运行、wait 软过期,对同一任务再次 wait,附带快照不是要求检查进度或干预;3 表示错误或崩溃;4 表示已取消;5 表示需注意的可恢复超时,检查局部工作区变更并询问是否用建议超时继续或停止,仅在用户明确确认后继续;1 表示无效命令或其他命令错误。
限制与注意:done 只描述调用与响应交付,不代表任务被接受;应保留 agy-cli 响应文本与诊断信息,非空响应可能仅确认已启动后台工作。成功但带警告的调用会在 stderr 给出有界日志尾部及完整日志指针。仅当用户明确要求进度时使用 observe <id>,已返回的快照可回答问题,不要重复或转为持续观察。等待过期不会停止 worker;仅在任务需要停止时取消。worker 默认硬限制 60m,可用 launch --timeout 配置至多 120m;超时后不要自动重试、重启或续接,需用户明确确认后再执行建议的恢复。续接与重启可从同一 worktree 的根目录或任意子目录发起,执行回到原 cwd。取消不会回滚编辑。恢复前应检查 git status 与 git diff。沙箱/权限错误或疑似崩溃时,确认收集使用与启动相同的非沙箱上下文。