pipefy-process-design

Pipefy プロセス設計

使用しているインターフェースに応じて、MCP リファレンスまたはCLI リファレンスをお読みください。関連するリファレンスのみを読み込んでください。

このスキルは、ユーザーがプロセスの設計についてコンサルティング支援を求めているときに有効になります。プロセスの構築を求めているときは有効になりません。ユーザーがすでに希望する内容（フェーズ、フィールド、仕様、または明確なユースケース）を把握している場合は、このスキルを使用しないでください。そのまま実行してください。

---

使用する場合と実行する場合

シグナル	対応
「X のプロセス設計を手伝って」	このスキルを使用します — コンサルティングモードです。
「Y に最適な構成は？」	このスキルを使用します — アーキテクチャのガイダンスです。
「X のパイプを作成して」	このスキルを使用しません — pipefy-buildingを経由してから、ドメインスキルに進みます。
ユーザーがフェーズ、フィールド、または仕様を提示している	このスキルを使用しません — 仕様そのものが計画です。pipefy-buildingを経由してから、構築に進みます。

---

前提条件

• 構成を提案する前に、ユーザーの業界とユースケースを把握してください。
• 新しいパイプを推奨する前に、必ず組織内の既存パイプを検索してください（search_pipes）。

---

調査フェーズ

1. 既存の組織構造を調査する：

   操作：search_pipes pipe_name=""（空の検索では、閲覧可能なすべてのパイプが返されます） 操作：get_organization organization_id=<id>

2. プロセスの目的を把握する：

   • 新しいケースが開始されるきっかけは何ですか？（フォーム送信、メール、手動）
   • 関係者は誰ですか？（申請者、承認者、運用チーム）
   • 重要な判断ポイントは何ですか？（承認／却下、エスカレーション、自動クローズ）
   • どのデータを追跡する必要がありますか？（フェーズごとのフィールド）
   • 関連するプロセスを連携する必要がありますか？（リレーションを使用）

3. 適切なPipefyコンポーネントを特定する：

   ニーズ	コンポーネント
   ワークフローのステージ	パイプ＋フェーズ
   各ステージの構造化データ	フェーズフィールド
   参照／検索データ	データベーステーブル
   プロセス間の連携	パイプリレーション
   自動アクション	オートメーションルール
   AI による処理	AI オートメーションまたはAI エージェント

---

設計原則

• 成果から始めます。 このプロセスで「完了」とはどのような状態ですか？
• フェーズにはアクションではなく状態の名前を付けます。 「レビューする」ではなく「レビュー中」とします。
• 開始フォームは最小限にします。 1日目に依頼者が提供できるデータだけを尋ねます。
• 必須フィールドは必要最小限にします。 必須フィールドはすべて進行の妨げになります。
• 例外を想定して設計します。 エッジケースに対応するため、「ブロック中」または「保留中」フェーズを追加します。
• 明確な処理は自動化します。 同じ条件で常に遷移するなら、手動ステップではなくオートメーションにします。

---

よくあるパターン

直線型の承認フロー

Submission → Under Review → Approved / Rejected → Done

• 開始フォーム：依頼者が詳細を入力します。
• 「Under Review」フェーズ：承認者フィールド＋期限日。
• オートメーション：カード作成時に承認者へ通知します。

複数ステージのパイプライン

Intake → Triage → In Progress → Testing → Deployed

• 各フェーズには役割に応じたフィールドを設定します。
• 条件に応じてカードを進めるオートメーションを設定します。
• SLA フィールドでフェーズごとの所要時間を追跡します。

ハブ＆スポーク（関連プロセス）

• 中央の「intake」パイプを、パイプリレーションでドメイン固有のパイプに接続します。
• 親カードが「Escalated」に移動したとき、オートメーションで子カードを自動作成します。

---

出力形式

設計相談の後、簡潔な要約を作成します。

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?]

Impact は1行に収めてください。件数、時間単価、リードタイムを推測しないでください。不足している数値をすべて明示し、それらすべてを1つの質問で尋ねてください。より詳しい根拠については、pipefy-process-impactをお読みください。

---

成功基準

• 実行を開始する前に、ユーザーがフェーズ、フィールド、オートメーションのトリガーを明確に理解している。
• search_pipesで確認し、重複するパイプが作成されていない。
• 利用可能な操作で構築できる設計になっている（存在しない機能を約束していない）。

関連項目

• pipefy-building — 実行／構築に関する依頼では、ルーターを確認してからドメインスキルを参照してください（このコンサルティングスキルを構築手順書に拡張しないでください）。
• pipefy-pipes-and-cards — 設計の確定後に実行します。
• pipefy-automations — 新しいパイプに自動化ルールを追加します。
• pipefy-process-intelligence — 既存のプロセスを分析して改善します（新規設計とは異なります）。
• pipefy-process-impact — 変更の影響を全体的に正当化します。このスキルが出力するのは Impact の行のみです。