pipefy-process-design

Pipefy 流程设计

请根据你使用的界面，阅读 MCP 参考 或 CLI 参考。只加载相关参考内容。

当用户需要咨询帮助来设计流程时，此技能才会启用，而不是在用户希望你构建流程时。如果用户已经清楚自己想要什么（提供了阶段、字段、规范或明确的用例），请勿使用此技能。直接执行。

---

何时使用，何时直接执行

信号	响应
“帮我为 X 设计一个流程”	使用此技能——咨询模式。
“Y 的最佳结构是什么？”	使用此技能——架构指导。
“为 X 创建一个 pipe”	跳过此技能——通过 pipefy-building 转交，然后使用相应领域技能。
用户提供阶段、字段或规范	跳过此技能——规范本身就是计划。通过 pipefy-building 转交，然后构建。

---

前提条件

• 提供结构建议前，先了解用户的行业和用例。
• 推荐新建 pipe 前，务必搜索组织内现有的 pipe（search_pipes）。

---

发现阶段

1. 调查现有的组织结构：

   操作：search_pipes pipe_name=""（空搜索会返回所有可见的 pipe） 操作：get_organization organization_id=<id>

2. 了解流程意图：

   • 什么会触发新案例？（提交表单、电子邮件、手动触发）
   • 参与者有哪些？（提交人、审批人、运营团队）
   • 关键决策点有哪些？（批准／拒绝、升级处理、自动关闭）
   • 需要跟踪哪些数据？（各阶段的字段）
   • 是否有应当关联的相关流程？（使用关系）

3. 确定合适的 Pipefy 组件：

   需求	组件
   工作流阶段	Pipe + 阶段
   各阶段的结构化数据	阶段字段
   参考／查找数据	数据库表
   跨流程关联	Pipe 关系
   自动操作	自动化规则
   AI 驱动的处理	AI 自动化或 AI Agent

---

设计原则

• 从结果着手。 对此流程来说，“完成”意味着什么？
• 阶段名称应描述状态，而非操作。 使用“审核中”，而不是“审核”。
• 让开始表单尽量简短。 只询问请求者在第 1 天就能提供的数据。
• 谨慎设置必填字段。 每个必填字段都可能成为阻碍。
• 为例外情况设计。 为边缘情况添加“受阻”或“暂缓”阶段。
• 将显而易见的操作自动化。 如果某个转换总是在相同条件下发生，就应将其设为自动化，而不是手动步骤。

---

常见模式

线性审批流程

提交 → 审核中 → 已批准／已拒绝 → 完成

• 开始表单：请求者填写详细信息。
• “审核中”阶段：审批人字段 + 到期日期。
• 自动化：卡片创建时通知审批人。

多阶段流程线

接收 → 分流 → 处理中 → 测试中 → 已部署

• 每个阶段都有针对不同角色的字段。
• 自动化会根据条件推进卡片。
• SLA 字段用于跟踪各阶段所用时间。

辐射式（相关流程）

• 中央“接收” pipe 通过 pipe 关系连接到特定领域的 pipe。
• 父卡片移至“已升级”时，通过自动化自动创建子卡片。

---

输出格式

设计咨询结束后，生成简明摘要：

Process: <Name>
Phases: [list]
Start form fields: [list with types]
Key automations: [list]
Related processes: [list or "none"]
Impact: [one line: time this design returns to the team against a fully manual run of the same flow; if a phase exists only for human triage, what an automation or an AI agent would change there. Do not start a pipe diagnosis.]
Next step: [execute with pipes-and-cards skill? or more questions?]

将影响控制在一行内。不要编造处理量、每小时成本或交付周期；列出每个缺失的数字，并在一个问题中询问所有数字。如需更完整的说明，请阅读 pipefy-process-impact。

---

成功标准

• 用户在开始执行前，已明确阶段、字段和自动化触发条件。
• 不会创建重复的 pipe（已通过 search_pipes 检查）。
• 设计可通过现有操作实现（不承诺不存在的功能）。

另请参阅

• pipefy-building — 对于执行／构建需求，请先阅读路由器，再阅读领域技能（不要将此咨询技能扩展为构建指南）。
• pipefy-pipes-and-cards — 设计定稿后执行设计。
• pipefy-automations — 为新管道添加自动化规则。
• pipefy-process-intelligence — 分析现有流程以进行改进（与设计新流程不同）。
• pipefy-process-impact 用于完整论证重大变更；此技能仅生成 Impact 行。