pi-conductor
基于状态机的多角色LLM编排与交接工具
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：pi-conductor。 它的用途是：基于状态机的多角色LLM编排与交接工具 完整的 Skill 内容见：https://321skill.com/skills/pi-conductor/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“/conduct start_project_workflow”，它会启动预设的多角色开发流程。首先，“系统架构师”角色会分析需求并输出设计草案；状态机自动将草案传递给“后端开发”角色生成代码；最后，“技术写作者”角色根据代码和设计生成文档，整个过程无需人工切换角色。
介绍
在复杂的AI协作任务中，单一LLM角色往往难以胜任，手动切换角色又容易导致上下文丢失和流程混乱。pi-conductor通过一个受保护、可观察的交接状态机，将多个LLM角色串联成一个有序的工作流，实现自动化、结构化的多角色协同。
它作为pi的扩展安装，通过暴露/conduct命令来使用。用户需要预先定义好任务流程、参与的角色（如“架构师”、“程序员”、“测试员”）以及角色间的交接规则与触发条件。启动后，状态机会根据规则自动调用相应角色处理当前状态的数据，并在满足条件时安全地将处理结果和上下文传递给下一个角色。
它非常适合需要严格流程控制、多专业视角评审或分阶段生成复杂产物的开发者、技术写作者和项目管理者。例如，一个从需求分析到代码生成再到文档编写的完整开发流程，就可以通过它来编排。
使用前建议先在小流程上测试，明确划分各角色的职责和输出格式，以确保状态机顺畅运转。注意，它依赖于pi平台，且需要用户对任务流程有清晰的逻辑设计。
核心特点
核心在于其“受保护、可观察的状态机”机制，不仅自动化了角色切换，还确保了交接过程的上下文完整性与状态可控性，避免了人工干预导致的信息断层。相比简单的角色切换指令或脚本，它提供了更结构化、可监控的编排能力。
注意事项
不适合需要高度自由、即兴发挥或流程极其简单、仅涉及单一角色的对话式任务。
常见问题
pi-conductor 是做什么的？
它是一个用于在pi平台中编排多个LLM角色按预定流程协同工作的状态机工具。
如何定义角色和交接规则？
需要通过配置文件或代码来定义状态、角色、处理逻辑及状态转移的守卫条件。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/pi-conductor/raw/index.md 读取 pi-conductor 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/pi-conductor/raw/index.md（查看排版版本）