pi-recurse
为Pi Agent提供可编程递归调用子代理的能力。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：pi-recurse。 它的用途是：为Pi Agent提供可编程递归调用子代理的能力。 完整的 Skill 内容见：https://321skill.com/skills/pi-recurse/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'使用pi-recurse分析这个项目，先让子代理A检查代码结构，再让子代理B评估依赖，最后汇总报告。'，它会自动创建两个子代理分别执行子任务，并整合结果返回给你一个完整的分析。
介绍
pi-recurse 是一个为 Pi Agent 设计的递归代理扩展，它解决了复杂任务需要分层、分步拆解执行的难题。在传统单次对话中，AI可能难以处理嵌套过深或多步骤的推理任务，该扩展允许主代理根据程序逻辑动态创建子代理，将大问题分解为小任务链式处理。
使用时，开发者通过编程方式调用该扩展的API，在主代理的工作流中定义何时以及如何生成子代理。每个子代理可以专注于一个子任务，并将结果返回给上级，整个过程受到深度防护机制（depth guardrails）的约束，防止无限递归，确保任务可控。
它非常适合需要自动化复杂工作流的开发者、研究者和高级用户，尤其是那些构建多步骤AI应用、自动化脚本或需要层次化问题求解的场景。例如，构建一个能自主规划、执行并汇总多步骤数据分析的AI系统。
建议在使用前充分理解递归逻辑和任务边界，合理设置递归深度限制以避免不必要的资源消耗。注意，它依赖于主Pi Agent环境，确保环境配置正确，并且任务分解的逻辑清晰，否则可能导致子代理任务混乱或效率低下。
核心特点
核心在于提供了程序化生成子代理的API并内置了递归深度防护，而非简单的链式调用或提示工程；这使得复杂任务的自动化分解更可控、更结构化。
注意事项
不适合处理实时性要求极高或递归逻辑不清晰的简单一次性任务。
常见问题
pi-recurse 能防止无限递归吗？
能，它内置了深度防护机制（depth guardrails），可以设置最大递归深度。
需要编程基础才能使用吗？
是的，需要通过编程方式调用API来生成和管理子代理。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/pi-recurse/raw/index.md 读取 pi-recurse 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/pi-recurse/raw/index.md（查看排版版本）