Zendesk Automation via Rube MCP

概要

このパブリック取込コピーは、https://github.com/sickn33/antigravity-awesome-skills から plugins/antigravity-awesome-skills-claude/skills/zendesk-automation をパッケージ化し、出所を隠さずにネイティブ Omni Skills 編集フォーマットに変換しています。

上流ワークフロー、サポートファイル、およびリポジトリコンテキストを維持する必要がある場合に使用します。パブリックバリデータとプライベート拡張機能は通常のダウンストリームフローを継続します。

この取込は、コピーされた上流ファイルをそのまま保持し、metadata.json 内の external_source ブロックおよび ORIGIN.md をレビュー用の出所の根拠として使用します。

Zendesk Automation via Rube MCP - Rube MCP を経由して Composio の Zendesk ツールキットで Zendesk オペレーションを自動化します

パブリック見出しにきれいにマップされなかったインポート済みソースセクションも、以下またはサポートファイル内に保持されています。注目すべきインポート済みセクション：前提条件、一般的なパターン、既知の落とし穴、制限事項。

このスキルを使用する場合

このセクションをトリガーフィルターとして使用します。オペレーターがファイルをロード、コマンドを実行、またはプルリクエストを開く前に、アクティベーション境界を明確にします。

• このスキルは、概要に記載されているワークフローまたはアクションを実行する場合に適用されます。
• リクエストがインポート済みソースの意図と明確に一致する場合に使用します。Rube MCP (Composio) を経由して Zendesk タスクを自動化する場合：チケット、ユーザー、組織、返信。常にツールを最初に検索して現在のスキーマを確認します。
• オペレーターが上流ワークフローの詳細を保存する必要があり、プロセスを最初から書き直さない場合に使用します。
• 出所がアンサー、PR、またはレビューパケット内で見える状態を保つ必要がある場合に使用します。
• コピーされた上流の参照、例、またはスクリプトがアンサーを実質的に改善する場合に使用します。
• ワークフローがプライベート拡張機能が引き継ぐ前にパブリック取込リポジトリでレビュー可能であるべき場合に使用します。

操作テーブル

状況	ここから開始	重要な理由
初めての使用	metadata.json	コピーされたワークフローに触れる前に、external_source ブロックを通じてリポジトリ、ブランチ、コミット、インポート済みパスを確認します
出所のレビュー	ORIGIN.md	インポート済みソースのプレーンテキスト監査証跡をレビュアーに提供します
ワークフロー実行	SKILL.md	実行を実質的に変更する最小限のコピーファイルで開始します
サポートコンテキスト	SKILL.md	パッケージ全体をロードせずに、次に関連する最もコピーされたソースファイルを追加します
ハンドオフの決定	## 関連スキル	タスクがドリフトした場合、オペレーターがより強いネイティブスキルに切り替えるのに役立ちます

ワークフロー

このワークフローは意図的に編集的であり、同時に運用的です。インポート済みソースをオペレーターにとって有用なものに保ちながら、ダウンストリーム拡張機能フローを提供するパブリック取込標準を満たします。

1. RUBESEARCHTOOLS が応答することを確認して Rube MCP が利用可能であることを確認します
2. RUBEMANAGECONNECTIONS を toolkit zendesk で呼び出します
3. 接続が ACTIVE でない場合、返されたオーサーリンクに従って Zendesk 認証を完了します
4. ワークフローを実行する前に接続ステータスが ACTIVE であることを確認します
5. ZENDESKLISTZENDESK_TICKETS - ページネーション付きすべてのチケットを一覧表示 [必須]
6. ZENDESKGETZENDESKTICKETBY_ID - 特定のチケット詳細を取得 [オプション]
7. page: ページ番号（1 ベース）

インポート済みワークフロー注記

インポート済み：セットアップ

Rube MCP を取得: クライアント設定で https://rube.app/mcp を MCP サーバーとして追加します。API キーは不要です。エンドポイントを追加するだけで機能します。

1. RUBE_SEARCH_TOOLS が応答することを確認して Rube MCP が利用可能であることを確認します
2. RUBE_MANAGE_CONNECTIONS を toolkit zendesk で呼び出します
3. 接続が ACTIVE でない場合、返されたオーサーリンクに従って Zendesk 認証を完了します
4. ワークフローを実行する前に接続ステータスが ACTIVE であることを確認します

インポート済み：コアワークフロー

1. チケットの一覧表示と検索

使用する場合：ユーザーがサポートチケットを表示、フィルタリング、または検索したい

ツールシーケンス：

1. ZENDESK_LIST_ZENDESK_TICKETS - ページネーション付きすべてのチケットを一覧表示 [必須]
2. ZENDESK_GET_ZENDESK_TICKET_BY_ID - 特定のチケット詳細を取得 [オプション]

主要パラメータ：

• page: ページ番号（1 ベース）
• per_page: ページあたりの結果数（最大 100）
• sort_by: ソートフィールド（'created_at'、'updated_at'、'priority'、'status'）
• sort_order: 'asc' または 'desc'
• ticket_id: 単一取得用のチケット ID

落とし穴：

• LIST はオフセットベースではなく page/per_page ページネーションを使用します。レスポンス内の next_page を確認します
• ページあたり最大 100 件の結果。next_page が null になるまでページ番号で反復します
• 削除されたチケットは LIST によって返されません。GET_BY_ID を使用すると 'deleted' ステータスが返されます
• チケットコメントと監査は GET_BY_ID に含まれていますが、LIST レスポンスには含まれていません

2. チケットの作成と更新

使用する場合：ユーザーが新しいチケットを作成したり既存のチケットを変更したい

ツールシーケンス：

1. ZENDESK_SEARCH_ZENDESK_USERS - リクエスター/割当人を検索 [前提条件]
2. ZENDESK_CREATE_ZENDESK_TICKET - 新しいチケットを作成 [必須]
3. ZENDESK_UPDATE_ZENDESK_TICKET - チケットフィールドを更新 [オプション]
4. ZENDESK_DELETE_ZENDESK_TICKET - チケットを削除 [オプション]

主要パラメータ：

• subject: チケットの件名行
• description: チケット本文（作成時。最初のコメントになります）
• priority: 'urgent'、'high'、'normal'、'low'
• status: 'new'、'open'、'pending'、'hold'、'solved'、'closed'
• type: 'problem'、'incident'、'question'、'task'
• assignee_id: 割り当てるエージェントユーザー ID
• requester_id: リクエスターユーザー ID
• tags: タグ文字列の配列
• ticket_id: チケット ID（更新/削除用）

落とし穴：

• UPDATE 時のタグは既存タグを完全に置き換えます。タグを保持するために現在のタグとマージします
• 同時実行の変更競合を防ぐために safe_update と updated_stamp を使用します
• DELETE は永続的で取り消し不可です。チケットは復旧できません
• description は作成時のみ使用されます。作成後にコメントを追加するには REPLY_ZENDESK_TICKET を使用します
• 閉じたチケットは更新できません。代わりにフォローアップチケットを作成します

3. チケットへの返信

使用する場合：ユーザーがチケットにコメントまたは返信を追加したい

ツールシーケンス：

1. ZENDESK_GET_ZENDESK_TICKET_BY_ID - 現在のチケット状態を取得 [前提条件]
2. ZENDESK_REPLY_ZENDESK_TICKET - 返信/コメントを追加 [必須]

主要パラメータ：

• ticket_id: 返信するチケット ID
• body: 返信テキスト内容
• public: ブール値。パブリック返信は true、内部ノートは false
• author_id: 著者ユーザー ID（デフォルトは認証ユーザー）

落とし穴：

• 内部ノート（エージェントのみに表示）には public: false を設定します
• デフォルトはパブリック返信で、リクエスターにメールを送信します
• HTML は本文テキストでサポートされています
• 返信することで同時にチケットステータスを更新することもできます

4. ユーザーの管理

使用する場合：ユーザーが Zendesk ユーザー（エージェント、エンドユーザー）を検索または作成したい

ツールシーケンス：

1. ZENDESK_SEARCH_ZENDESK_USERS - ユーザーを検索 [必須]
2. ZENDESK_CREATE_ZENDESK_USER - 新しいユーザーを作成 [オプション]
3. ZENDESK_GET_ABOUT_ME - 認証ユーザー情報を取得 [オプション]

主要パラメータ：

• query: 検索文字列（名前、メールアドレス、電話番号等にマッチします）
• name: ユーザーのフルネーム（作成時は必須）
• email: ユーザーのメールアドレス
• role: 'end-user'、'agent'、または 'admin'
• verified: メールアドレスが検証されているか

落とし穴：

• ユーザー検索はあいまいで、部分一致を返す可能性があります
• 既存のメールアドレスを持つユーザーを作成すると、既存のユーザーが返されます（アップサート動作）
• エージェントおよび管理者ロールは特定のプラン機能が必要な場合があります

5. 組織の管理

使用する場合：ユーザーが組織を一覧表示、作成、または管理したい

ツールシーケンス：

1. ZENDESK_GET_ALL_ZENDESK_ORGANIZATIONS - すべての組織を一覧表示 [必須]
2. ZENDESK_GET_ZENDESK_ORGANIZATION - 特定の組織を取得 [オプション]
3. ZENDESK_CREATE_ZENDESK_ORGANIZATION - 組織を作成 [オプション]
4. ZENDESK_UPDATE_ZENDESK_ORGANIZATION - 組織を更新 [オプション]
5. ZENDESK_COUNT_ZENDESK_ORGANIZATIONS - 合計数を取得 [オプション]

主要パラメータ：

• name: 組織名（一意、作成時は必須）
• organization_id: get/update 用の組織 ID
• details: 組織詳細テキスト
• notes: 内部ノート
• domain_names: 関連ドメインの配列
• tags: タグ文字列の配列

落とし穴：

• 組織名は一意である必要があります。重複した名前は作成エラーを引き起こします
• UPDATE 時のタグは既存タグを置き換えます（チケットと同じ動作）
• ドメイン名は自動ユーザー関連付けに使用できます

インポート済み：前提条件

• Rube MCP は接続されている必要があります（RUBE_SEARCH_TOOLS が利用可能）
• toolkit zendesk を使用した RUBE_MANAGE_CONNECTIONS を経由した有効な Zendesk 接続
• 常に RUBE_SEARCH_TOOLS を最初に呼び出して現在のツールスキーマを取得します

例

例 1：上流ワークフローを直接要求する

Use @zendesk-automation to handle <task>. Start from the copied upstream workflow, load only the files that change the outcome, and keep provenance visible in the answer.

説明：オペレーターがインポート済みワークフローを必要としているが、リポジトリ全体は不要な場合、これが最も安全な出発点です。

例 2：出所根拠のレビューを要求する

Review @zendesk-automation against metadata.json and ORIGIN.md, then explain which copied upstream files you would load first and why.

説明：レビューまたはトラブルシューティングの前に、出所と file 選択の正確で監査可能な説明が必要な場合にこれを使用します。

例 3：実行前にコピーされたサポートファイルを絞り込む

Use @zendesk-automation for <task>. Load only the copied references, examples, or scripts that change the outcome, and name the files explicitly before proceeding.

説明：これにより、スキルはデフォルトでコピーされたパッケージ全体をロードする代わりに、段階的な公開に合わせたままになります。

例 4：レビュアーパケットを作成する

Review @zendesk-automation using the copied upstream files plus provenance, then summarize any gaps before merge.

説明：PR が人間のレビューを待っており、反復可能な監査パケットが必要な場合に役立ちます。

ベストプラクティス

生成されたパブリックスキルを上流リポジトリ周辺のレビュー可能なパッケージングレイヤーとして扱います。目標は、出所を明示的に保ち、実行を実質的に改善するコピーされたソース資料のみをロードすることです。

• インポート済みスキルを上流リポジトリに根ざしたままにします。ソース資料がサポートできないステップを発明しないでください。
• ワークフローが監査可能で高速にレビューできるように、サポートファイルの最小限の有用なセットを優先します。
• 出所、ソースコミット、およびインポート済みファイルパスをノートおよび PR 説明で見える状態に保ちます。
• 一般的なレビュー定型文に依存する代わりに、ワークフローを正当化するコピーされた上流ファイルに直接指を差します。
• 生成された例をスキャフォルディングとして扱い。実行前に具体的なタスクに適応させます。
• アーキテクチャ、デバッグ、設計、またはセキュリティ上の懸念が優位になった場合、より強いネイティブスキルにルーティングします。

トラブルシューティング

問題：オペレーターはインポート済みコンテキストをスキップし、あまりにも一般的に回答しました

症状：結果は plugins/antigravity-awesome-skills-claude/skills/zendesk-automation 内の上流ワークフローを無視し、出所に言及しないか、コピーされたソースファイルをまったく使用しません。 解決策：metadata.json、ORIGIN.md、および最も関連するコピーされた上流ファイルを再度開きます。external_source ブロックを最初にチェックしてから、続行する前に出所を再述してください。

問題：インポート済みワークフローはレビュー中に不完全に感じられます

症状：レビュアーは生成された SKILL.md を見ることができますが、現在のタスクにとって重要な参照、例、またはスクリプトを素早く特定することができません。 解決策：採用したパスを正当化する正確なコピーされた参照、例、スクリプト、またはアセットを指してください。ギャップが実在する場合は、隠す代わりに PR に記録してください。

問題：タスクが異なる専門分野にドリフトしました

症状：インポート済みスキルは正しい場所で開始されますが、ネイティブスキルがより良く処理するデバッグ、アーキテクチャ、設計、セキュリティ、またはリリースオーケストレーションに仕事が変わります。 解決策：関連スキルセクションを使用して意図的にハンドオフします。インポート済みの出所を見える状態に保ち、次のスキルが盲目的に開始する代わりに正しいコンテキストを継承するようにします。

関連スキル

• @00-andruia-consultant - このインポート済みスキルがコンテキストを確立した後、仕事がそのネイティブ専門分野によってより適切に処理される場合に使用します。
• @00-andruia-consultant-v2 - このインポート済みスキルがコンテキストを確立した後、仕事がそのネイティブ専門分野によってより適切に処理される場合に使用します。
• @10-andruia-skill-smith - このインポート済みスキルがコンテキストを確立した後、仕事がそのネイティブ専門分野によってより適切に処理される場合に使用します。
• @10-andruia-skill-smith-v2 - このインポート済みスキルがコンテキストを確立した後、仕事がそのネイティブ専門分野によってより適切に処理される場合に使用します。

追加リソース

このインポート済みスキルのオペレーターパケットとして、以下のサポート行列とリンクされたファイルを使用します。これらは一般的なスキャフォルディングではなく、実際のコピーされたソース資料を反映する必要があります。

リソースファミリー	レビュアーに提供するもの	サンプルパス
references	上流からコピーされた参照ノート、ガイド、または背景資料	references/n/a
examples	上流からコピーされた実装例または再利用可能なプロンプト	examples/n/a
scripts	実行またはバリデーションを変更する上流ヘルパースクリプト	scripts/n/a
agents	インポート済みパッケージの一部である本当のルーティングまたは委譲ノート	agents/n/a
assets	ソースパッケージからコピーされたサポートアセットまたはスキーマ	assets/n/a

インポート済み参照ノート

インポート済み：クイックリファレンス

タスク	ツールスラッグ	主要パラメータ
チケット一覧	ZENDESK_LIST_ZENDESK_TICKETS	page、per_page、sort_by
チケット取得	ZENDESK_GET_ZENDESK_TICKET_BY_ID	ticket_id
チケット作成	ZENDESK_CREATE_ZENDESK_TICKET	subject、description、priority
チケット更新	ZENDESK_UPDATE_ZENDESK_TICKET	ticket_id、status、tags
チケットに返信	ZENDESK_REPLY_ZENDESK_TICKET	ticket_id、body、public
チケット削除	ZENDESK_DELETE_ZENDESK_TICKET	ticket_id
ユーザー検索	ZENDESK_SEARCH_ZENDESK_USERS	query
ユーザー作成	ZENDESK_CREATE_ZENDESK_USER	name、email
マイプロフィール	ZENDESK_GET_ABOUT_ME	（なし）
組織一覧	ZENDESK_GET_ALL_ZENDESK_ORGANIZATIONS	page、per_page
組織取得	ZENDESK_GET_ZENDESK_ORGANIZATION	organization_id
組織作成	ZENDESK_CREATE_ZENDESK_ORGANIZATION	name
組織更新	ZENDESK_UPDATE_ZENDESK_ORGANIZATION	organization_id、name
組織数をカウント	ZENDESK_COUNT_ZENDESK_ORGANIZATIONS	（なし）

インポート済み：一般的なパターン

ページネーション

リストエンドポイント：

• page（1 ベース）と per_page（最大 100）を使用します
• レスポンス内の next_page URL を確認します。null は最後のページを意味します
• count フィールドは結果の合計を示します

チケットライフサイクル

new -> open -> pending -> solved -> closed
                  |          ^
                  v          |
                hold --------+

• new: 未割当チケット
• open: 割り当て済み、処理中
• pending: 顧客レスポンス待機中
• hold: 内部アクション待機中
• solved: 解決済み、再度開くことができます
• closed: 永続的に閉じられ、変更できません

割当用のユーザー検索

1. クエリ（名前またはメールアドレス）で ZENDESK_SEARCH_ZENDESK_USERS を呼び出します
2. 結果からユーザー ID を抽出します
3. チケット作成/更新で assignee_id としてユーザー ID を使用します

インポート済み：既知の落とし穴

タグの動作：

• update 時のタグはすべての既存タグを置き換えます
• 常に現在のタグを最初に取得し、更新前にマージします
• タグは小文字で、スペースがありません（アンダースコアを使用）

安全な更新：

• 競合を防ぐために safe_update: true と updated_stamp（ISO 8601）を使用します
• チケットがスタンプ以降に変更された場合は 409 を返します

削除：

• チケット削除は永続的で取り消し不可です
• 削除する代わりにステータスを 'closed' に設定することを検討します
• 削除されたチケットは API を経由して復旧できません

レート制限：

• デフォルト：1 分あたり 400 リクエスト
• プラン層によって異なります
• 429 レスポンスには Retry-After ヘッダーが含まれます

インポート済み：制限事項

• 上記で説明したスコープと明確に一致する場合にのみこのスキルを使用します。
• 出力を環境固有のバリデーション、テスト、または専門家のレビューの代替として扱わないでください。
• 必要な入力、権限、セキュリティ境界、または成功基準が不明な場合は、停止して明確化を求めてください。