@adamjen/pi-agent-turn-limiter
限制Pi编排器连续工作轮次，避免陷入无限循环
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@adamjen/pi-agent-turn-limiter。 它的用途是：限制Pi编排器连续工作轮次，避免陷入无限循环 完整的 Skill 内容见：https://321skill.com/skills/adamjen-pi-agent-turn-limiter/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'安装pi-agent-turn-limiter后，当我使用Pi编排器处理大型项目时，它会自动计数轮次，并在连续3轮未委托子代理时提醒我委托。' 安装后，你只需正常使用Pi，状态栏会显示‘🔄 orch: 2/3’等实时计数，当计数达到3/3时，系统会自动注入提醒文字，引导编排器切换到子代理分工模式。
介绍
这个Skill解决了Pi编排器容易陷入无限工作循环的问题。在实际开发中，当你交给Pi一个大型任务时，编排器可能会忘记委托子代理，而是自己连续执行文件读取、代码搜索、内容编写等操作，经过20多轮后依然没有触发任何子代理分工。这会导致任务卡在编排器自身，不仅效率低下，还会让系统失去作为协调者的角色定位。
使用方式很简单，你只需要通过npm安装该扩展，然后启动Pi会话即可。它会在后台自动检测编排器角色，以3轮准备阶段+3轮有效工作轮次为上限，当编排器连续3轮未委托子代理时，系统会向上下文中注入一条温和的提醒提示，而非强制阻塞。状态栏会实时显示当前轮次计数和委托状态，让你一目了然。
它非常适合需要频繁使用Pi编排器进行复杂任务拆解和协调的开发者。尤其是那些使用本地模型、指令遵循能力较弱的场景，编排器更容易忘记委托规则，此时这个限流器能有效弥补模型的行为偏差。此外，它也可以与限制子代理并行数量的扩展搭配使用，形成完整的代理协作管理方案。
建议在开发需要多步骤协调的AI应用时统一安装此工具，避免因编排器长期占用导致上下文耗尽。需要注意的是，它仅对编排器生效，不会干扰普通子代理的正常运行，并且不会强制中断任务，只是通过警告促使编排器回归委托角色。如果你希望更强硬的限制，可能需要配合其他扩展共同使用。
常见问题
这个扩展会强制阻止编排器继续工作吗？
不会，它只在轮次达到上限时向系统提示注入提醒，不会阻塞任何工具调用，编排器仍可继续执行，但上下文会提示其应委托子代理。
安装后是否需要手动配置？
不需要，安装后自动生效，所有设置使用默认值（3轮准备+3轮有效工作），你可以在Pi TUI底部看到实时状态。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/adamjen-pi-agent-turn-limiter/raw/index.md 读取 @adamjen/pi-agent-turn-limiter 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/adamjen-pi-agent-turn-limiter/raw/index.md（查看排版版本）