@adamjen/pi-one-subagent-at-a-time
强制子代理顺序执行，杜绝单GPU模型交换开销
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@adamjen/pi-one-subagent-at-a-time。 它的用途是：强制子代理顺序执行，杜绝单GPU模型交换开销 完整的 Skill 内容见：https://321skill.com/skills/adamjen-pi-one-subagent-at-a-time/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'帮我分析三个不同数据源，顺序执行子代理，不要同时启动'。安装此Skill后，无论你如何调用subagent()，AI都会自动排队执行第一个子代理，完成后才启动下一个，避免因模型切换导致的长时间等待。
介绍
这个Skill解决了单GPU环境下并发子代理导致模型交换开销爆炸的问题。在实际开发中，当使用llama-swap等工具在子代理间切换模型时，并发生成多个子代理会触发频繁的模型加载卸载——每次切换耗时数秒，加上上下文重载，原本10秒的任务可能拖到60秒以上。
使用方式很简单，你只需要通过pi install安装该扩展，无需任何配置即可生效。之后所有subagent()工具调用都会自动排队：当第一个子代理运行时，后续调用会被阻塞并返回清晰提示，直到前一个完成。pi TUI界面会显示“🔒 agent-gate active”状态指示。
它非常适合需要在单GPU上运行多个Agent的开发者或团队。尤其是那些使用RTX 3090/4090等有限显存硬件、依赖模型切换来调度不同子代理的用户，以及希望避免并行混乱、追求可预测顺序执行的工作流。
建议在统一使用llama-swap或类似模型交换工具时搭配此Skill。需要注意的是，它仅作用于pi框架内的subagent()调用，不会影响其他外部并行任务，且硬限制为1个并发，无法动态调整。
常见问题
安装后需要额外配置吗？
不需要，开箱即用，默认限制1个并发子代理，pi TUI会显示状态指示。
会影响其他并行工具或脚本吗？
不会，它只拦截pi框架内的subagent()调用，不影响外部并行任务或系统级并发。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/adamjen-pi-one-subagent-at-a-time/raw/index.md 读取 @adamjen/pi-one-subagent-at-a-time 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/adamjen-pi-one-subagent-at-a-time/raw/index.md（查看排版版本）