pi-agent-switcher
让用户通过Markdown定义并切换AI角色
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:pi-agent-switcher。 它的用途是:让用户通过Markdown定义并切换AI角色 完整的 Skill 内容见:https://321skill.com/skills/pi-agent-switcher/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“切换到‘代码审查员’模式。”,它会立即从刚才的聊天助手转变为严格的代码审查专家,依据你预定义的规则检查你提供的代码片段。之后你可以说:“现在用‘写作助手’帮我润色这段文字。”,AI又会切换为注重文笔和结构的写作伙伴。
介绍
Pi Agent Switcher 是一个 Pi 平台的扩展,它解决了用户在单一对话中需要AI扮演不同角色(如代码审查员、写作助手、数据分析师)时,需要反复手动描述角色或切换对话的痛点。它允许用户通过编写Markdown文件来预先定义多个AI代理(Agent),每个代理都有其独特的角色、指令和上下文,用户可以在对话中通过简单的命令在这些预定义的代理之间无缝切换。
使用方式非常直观。用户首先需要创建一个Markdown文件,在其中按照特定格式定义多个代理的配置。安装并启用此扩展后,在Pi的对话中,用户只需输入特定的切换命令(例如 @agent_name),即可立即让AI切换到对应的角色模式,继承该角色的所有预设行为和知识背景,无需每次重新交代上下文。
这个扩展非常适合那些工作流复杂、需要AI频繁切换专业身份的用户,例如全栈开发者(需要在写代码、写文档、调试等角色间切换)、内容创作者(需要在不同写作风格间切换)或产品经理(需要AI模拟用户、开发、市场等不同视角)。它尤其适合希望将AI深度集成到固定工作流程中的进阶用户。
使用建议是,在定义代理时,尽量将角色指令写得具体、清晰,并包含示例,这样切换后的AI行为会更符合预期。注意事项是,此扩展依赖于用户自行维护的Markdown配置文件,因此初次设置需要一定时间,且代理的能力和切换的流畅度受限于底层AI模型对长上下文和复杂指令的理解能力。
核心特点
与同类需要代码配置或复杂命令的Agent管理工具不同,它使用纯Markdown文件进行角色定义,极大降低了使用门槛;同时,它深度集成于Pi平台,实现了在单次对话会话内的、无需重置上下文的快速角色切换。
注意事项
不适合只需要AI扮演单一固定角色或偶尔进行简单对话的用户,初次配置有一定学习成本。
常见问题
如何定义一个新的AI代理?
在指定的Markdown配置文件中,按照 `## 代理名称` 的格式创建标题,并在其下方编写该代理的系统指令和初始消息即可。
切换代理会丢失之前的对话历史吗?
不会,此扩展旨在单次对话内切换角色,通常会保留上下文,但具体行为取决于代理的配置和模型限制。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/pi-agent-switcher/raw/index.md 读取 pi-agent-switcher 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/pi-agent-switcher/raw/index.md(查看排版版本)