@marks/pi-subagent
为Pi AI创建并管理角色化子代理的扩展工具。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@marks/pi-subagent。 它的用途是：为Pi AI创建并管理角色化子代理的扩展工具。 完整的 Skill 内容见：https://321skill.com/skills/marks-pi-subagent/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“请调用`subagent`工具，启动我的‘代码审查专家’角色。”，它会读取对应Markdown文件并生成一个新的Pi子进程窗口，这个新窗口将专门用于审查您提交的代码，遵循预设的审查规则和格式。
介绍
这个Skill解决了Pi AI在处理复杂或多角色任务时，需要调用不同专长子代理的需求。它允许用户通过一个简单的工具命令，快速创建并启动一个具有特定角色和指令的子Pi进程，从而将主会话中的任务委托给更专业的“助手”。
使用方式非常直接：用户在Pi的对话中调用subagent工具，并指定一个角色名称（该角色对应的Markdown文件需预先存放在~/.pi/agent/agents/目录下）。该工具便会启动一个新的、独立的Pi子进程，这个子进程将完全按照Markdown文件中定义的角色、系统提示和上下文来运行，与主会话并行工作。
它非常适合那些经常使用Pi进行多线程工作、希望将不同类型任务（如代码审查、创意写作、数据分析）分离到不同会话中的高级用户或开发者。通过预定义角色，他们可以快速切换到特定工作模式，保持主会话的整洁和专注。
使用建议是，在开始前，花些时间规划和编写清晰、具体的角色Markdown文件，这是发挥该Skill效能的关键。注意事项包括：每个子代理都是独立进程，会消耗额外资源；角色间的通信和上下文共享需要用户手动管理；需确保Pi客户端环境支持子进程创建。
核心特点
其核心区别在于极简设计和本地化角色管理：它仅提供一个`subagent`工具，功能高度聚焦；所有角色定义都以本地Markdown文件形式存储，无需云端配置或复杂脚本，赋予了用户完全的控制权和隐私性。
注意事项
不适合需要子代理间紧密协作、实时数据同步或对系统资源占用非常敏感的场景。
常见问题
如何创建或修改一个角色？
在`~/.pi/agent/agents/`目录下创建或编辑对应的.md文件，按Markdown格式编写角色指令。
可以同时运行多个子代理吗？
可以，每次调用`subagent`工具都会生成一个独立的子进程。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/marks-pi-subagent/raw/index.md 读取 @marks/pi-subagent 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/marks-pi-subagent/raw/index.md（查看排版版本）