pi-skill-playbook
用于创建和管理被动式、人工介入的Agent技能剧本的Pi扩展。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：pi-skill-playbook。 它的用途是：用于创建和管理被动式、人工介入的Agent技能剧本的Pi扩展。 完整的 Skill 内容见：https://321skill.com/skills/pi-skill-playbook/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“运行客户投诉处理剧本。”，它会自动完成信息收集和分类，当遇到需要升级处理的复杂投诉时，它会暂停并提示你：“检测到投诉涉及财务争议，请主管审核并决定处理方案。” 在你做出选择后，它将继续执行后续的跟进或补偿步骤。
介绍
pi-skill-playbook 是一个为 Pi 平台设计的扩展，它解决了在复杂或需要人工判断的任务中，如何让AI Agent与人类高效协作的问题。传统自动化流程在遇到非结构化或需要创造性决策的场景时容易中断，该Skill通过定义“剧本”（playbook），让Agent在特定节点暂停并等待人类输入或审核，从而将AI的自动化能力与人类的判断力结合起来。
使用该Skill时，开发者或流程设计者需要预先编写一个“技能剧本”，其中定义了任务的步骤、决策点以及需要人类介入的环节。当Agent执行到这个剧本时，它会按照预设流程运行，并在指定的“人工介入点”暂停，通过界面提示或通知等待用户提供信息、做出选择或审核结果，之后继续执行后续自动化步骤。
它非常适合那些流程相对固定，但其中某些环节自动化风险高或需要人类专业知识的团队，例如内容审核流程的最终批准、客户服务中复杂投诉的升级处理，或是开发流程中关键代码合并前的人工审查。使用该Skill可以将重复性的流程部分自动化，同时将宝贵的人力资源精准地投入到最需要判断力的环节。
建议在使用前清晰规划整个业务流程，明确划分自动化与人工的边界。注意事项包括：剧本的设计需要仔细考虑异常处理路径，避免流程卡死；同时，要确保人工介入的提示清晰明确，以减少用户的认知负担和操作错误。
核心特点
其核心在于支持“被动式”和“人工介入”的混合工作流，允许在自动化剧本中预设暂停点等待人类输入，而非追求全流程自动化。这与许多追求完全自动化的Agent技能有本质区别，它承认并设计了人机协作的接口。
注意事项
不适合对实时性要求极高或需要完全无人值守的全自动化场景。
常见问题
pi-skill-playbook 是做什么用的？
用于在Pi Agent的自动化流程中插入人工审核或输入节点，实现人机协同任务。
如何定义一个需要人工介入的步骤？
在编写的技能剧本中，使用特定的语法或标记来声明一个“人工介入点”，当执行到此处时流程会暂停并等待。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/pi-skill-playbook/raw/index.md 读取 pi-skill-playbook 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/pi-skill-playbook/raw/index.md（查看排版版本）