name: background-agent-pings description: 后台代理进度通知 user-invocable: false
后台代理进度通知
信任系统提醒作为代理进度通知。不要轮询。
模式
当您启动后台代理时,继续处理其他任务。系统将在以下情况通过提醒通知您:
- 代理有进展:
Agent <id> 进展:X 新工具使用,Y 新令牌 - 代理写入输出文件(检查您指定的路径)
应该做
1. Task(run_in_background=true, prompt="... 输出到:.claude/cache/agents/<type>/output.md")
2. 立即继续下一个任务
3. 当系统提醒显示代理活动时,检查输出文件是否存在
4. 仅在代理发出完成信号时读取输出文件
不应该做
# 错误:轮询浪费令牌和时间
Task(run_in_background=true)
Bash("sleep 5 && ls ...") # 轮询
Bash("tail /tmp/claude/.../tasks/<id>.output") # 轮询
TaskOutput(task_id="...") # 淹没上下文
为什么这很重要
- 轮询通过重复检查消耗令牌
TaskOutput用完整代理转录淹没主上下文- 系统提醒是免费的 - 它们自动推送给您
- 在等待时继续生产性工作
来源
- 本次会话:意识到轮询代理输出浪费时间,而系统提醒已经提供进度更新