pi-subagent-toolbudget
为子智能体设置工具调用预算，防止无限循环。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：pi-subagent-toolbudget。 它的用途是：为子智能体设置工具调用预算，防止无限循环。 完整的 Skill 内容见：https://321skill.com/skills/pi-subagent-toolbudget/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“分析这份长文档并总结要点。” 当AI调用 pi-subagents 创建子智能体进行分块分析时，pi-subagent-toolbudget 会确保每个分析子智能体不会因反复查找细节而陷入死循环，在达到调用上限后使其停止并返回已有结果，保证主任务能继续推进。
介绍
该工具旨在解决在使用 pi-subagents 框架创建子智能体时，可能出现的子智能体因逻辑错误或任务不明确而陷入无限循环、反复调用工具，最终导致上下文窗口溢出或资源浪费的问题。它通过设置软性提醒和硬性停止两种预算机制，对子智能体的工具调用次数进行限制。
使用时，只需在 pi-subagents 的配置中引入此工具。当子智能体被创建时，该工具会自动生效。它会监控子智能体的工具调用次数，在接近预设上限时发出软性提醒，鼓励其尽快完成任务；一旦达到硬性上限，则会强制停止其工具调用，使其进入最终状态，避免无休止的运行。
该工具非常适合那些深度使用 pi-subagents 框架进行复杂任务分解和代理协作的开发者或高级用户。当你的工作流依赖于生成多个子智能体来处理不确定或开放式任务时，此工具能提供关键的稳定性保障。
建议在部署包含子智能体的生产环境或处理用户输入不可控的任务时启用此工具。需要注意的是，它仅在 pi-subagents 框架生成的子智能体内部生效，对主智能体或其他非子智能体环境没有影响。预算阈值应根据具体任务的复杂度和工具调用成本进行合理设置。
核心特点
这是专为 pi-subagents 框架设计的配套工具，核心在于其“软提醒+硬停止”的双层预算机制，能在不立即中断任务的前提下，智能地引导“失控”的子智能体优雅结束，而非简单地切断。
注意事项
仅适用于 pi-subagents 框架生成的子智能体，在其他代理框架或主智能体环境中无效。
常见问题
pi-subagent-toolbudget 能防止子智能体无限循环吗？
是的，它通过设置工具调用次数上限来强制停止超限的子智能体，防止其无限循环。
这个工具需要单独配置每个子智能体吗？
不需要，作为 pi-subagents 的扩展，它通常在框架配置中全局启用，对所有生成的子智能体生效。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/pi-subagent-toolbudget/raw/index.md 读取 pi-subagent-toolbudget 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/pi-subagent-toolbudget/raw/index.md（查看排版版本）