用途:agent-return-setup 是一个安装/配置型技能,负责接入一对钩子及其共享模块,为每个子代理的最终返回消息设置大小预算,也可配置或移除它们。运行行为全部位于钩子文件与 JSON 配置中,技能只决定模式、范围与两个阈值,然后按 runbook 交由 brewcode:hook-creator 代理完成文件操作。
主要能力:三个文件作为一个整体安装——agent-return-budget.mjs(共享模块:配置发现、阈值解析、estimateTokens、契约文本,从不注册)、agent-return-contract.mjs(SubagentStart,无 matcher,注入返回契约作为 additionalContext)、agent-return-guard.mjs(SubagentStop,无 matcher,对 last_assistant_message 计大小,最多阻止一次并给出压缩或归档指令)。阈值 t = Math.ceil(length/4):t <= passTokens 通过;passTokens < t <= fileTokens 阻止并要求压缩;t > fileTokens 阻止并要求把细节写入 .claude/reports/YYYYMMDD-HHMMSS_<agent-slug>/ 后仅返回路径、结论与不超过 3 行。默认 passTokens 1000、fileTokens 2500。
使用方式:先解析插件根目录(从技能自身目录,而非 CLAUDE_PLUGIN_ROOT),再执行状态探测,随后按 INSTALL.md runbook 安装项目级或全局级、升级、启用/禁用、卸载或清除。全局操作只能通过 Bash 工具(cp/node/rm),不得对 ~/.claude/* 使用 Write/Edit。写入配置时附带 version、content_version、generated_by、last_updated 四个元数据键。
适用场景:希望控制管理会话中子代理返回消息带来的上下文开销。
限制:每个代理最多阻止一次;仅对最终助手消息计大小,不约束工作过程;使用 chars/4 启发式而非分词器;passTokens < fileTokens 未被钩子强制校验;各处失败开放,除阻止外不退出 2;缺少同目录的 agent-return-budget.mjs 无法被捕获,会导致退出 1 并显示钩子错误横幅;SubagentStop 钩子附件不会记录到 transcript。该钩子默认不注册,需运行本技能才生效。