SuperAPI AI 工具集

agent-deadline-setup

智能体与模型

查看项目

更新于 10-15 20:07

技能介绍

用途:为 Claude Code 子智能体提供软性墙钟预算(soft wall-clock budget)。Claude Code 本身没有针对子智能体的墙钟超时,maxTurns 只在回合上限处停止;该技能通过两个自包含钩子实现提醒与收尾引导。

主要能力:PreToolUse 钩子 agent-deadline-guard.mjs 按 agent_id 记录已用时间,在预算 80% 时给一次非阻塞的“收尾”提示;超过 100% 后拒绝除收尾工具集之外的工具调用;超过 hardStopRatio(配置键,默认 2,须大于 1)后允许集收缩为 Write、Edit。SubagentStop 钩子 agent-deadline-cleanup.mjs 删除已结束智能体的状态文件。收尾工具集在指令中声明 Read、Write、Edit、MultiEdit、NotebookEdit、TodoWrite、TaskUpdate;实际通过 100% 后的还包含 TaskCreate、BashOutput、TaskOutput(此为设计,非缺陷)。AskUserQuestion 被有意拒绝。

使用方式:技能本身是安装/配置器,只决定模式、范围与预算,具体文件操作交由 brewcode:hook-creator 智能体按 runbook 执行。任何模式都先探测状态,再安装、重装或移除。资产位于 $BT_ROOT/skills/agent-deadline-setup/assets/,包含 INSTALL.md 及两个钩子文件。不要对 ~/.claude/* 使用 Write/Edit(受保护路径),全局操作仅通过 Bash 工具进行。该钩子为选择性启用(opt-in),插件安装本身不会注册它们。

适用场景:需要给子智能体设置软性时间约束、避免无限等待人工回答或长循环的场景。

限制:时间仅在工具调用边界采样,单次长 Bash 调用期间无法观测,属软性截止而非超时,长命令应使用 BASH_MAX_TIMEOUT_MS 限制;时钟从智能体首次工具调用开始;PreToolUse 匹配器为 .*,每次工具调用都有开销(全局安装会给所有会话每次调用增加约 60 毫秒);钩子为 fail-open;主会话无 agent_id/agent_type,始终为空操作。byAgentType 的插件智能体取值未在实机验证,不匹配时静默回退到 defaultMinutes。具体命令、配置字段与安装步骤以 INSTALL.md 为准;资料未提供收费与价格信息。