Cowork プラグインのカスタマイズ

特定の組織に合わせてプラグインをカスタマイズします。汎用プラグインテンプレートを初めてセットアップするか、既に設定されているプラグインを調整・改善します。

プラグインを見つける: プラグインのソースファイルを見つけるには、find mnt/.local-plugins mnt/.plugins -type d -name "*<plugin-name>*" を実行してプラグインディレクトリを探し、変更前にそのファイルを読んで構造を理解してください。プラグインディレクトリが見つからない場合は、ユーザーがリモートコンテナでこの会話を実行している可能性があります。中止して「プラグインのカスタマイズは現在デスクトップアプリの Cowork モードでのみ利用できます」と通知してください。

カスタマイズモードの判定

プラグインを見つけた後、~~ プレフィックス付きプレースホルダーをチェックします: grep -rn '~~\w' /path/to/plugin --include='*.md' --include='*.json'

デフォルトルール: ~~ プレースホルダーが存在する場合、ユーザーがプラグインの特定部分をカスタマイズするよう明示的に求めない限り、汎用プラグインセットアップをデフォルトにします。

1. 汎用プラグインセットアップ — プラグインに ~~ プレフィックス付きプレースホルダーが含まれています。これらはテンプレート内のカスタマイズポイントで、実際の値で置き換える必要があります (例: ~~Jira → Asana、~~your-team-channel → #engineering)。

2. スコープ付きカスタマイズ — ~~ プレースホルダーが存在せず、ユーザーがプラグインの特定部分をカスタマイズするよう求めた場合 (例: 「コネクタをカスタマイズして」、「スタンドアップスキルを更新して」、「チケットツールを変更して」)。プラグインファイルを読んで関連セクションを見つけ、それらにのみ集中します。プラグイン全体をスキャンしたり、無関係なカスタマイズ項目を提示しないでください。

レガシー commands/ ディレクトリ: 一部のプラグインに commands/ ディレクトリが含まれています。Cowork UI はこれらをスキルと一緒に単一の「スキル」概念として表示するため、commands/*.md ファイルを skills/*/SKILL.md ファイルの場合と同じ方法で扱ってください。

3. 一般的なカスタマイズ — ~~ プレースホルダーが存在せず、ユーザーがプラグインを広く変更したいと考えている場合。プラグインのファイルを読んで現在の設定を理解し、ユーザーに何を変更したいかを尋ねます。

重要: カスタマイズされるプラグインまたはスキルの名前は決して変更しないでください。ディレクトリ、ファイル、プラグイン/スキル名フィールドの名前を変更しないでください。

非技術的な出力: すべてのユーザー向け出力 (TODO リストアイテム、質問、要約) は平易な非技術的言語で記述する必要があります。ユーザーに ~~ プレフィックス、プレースホルダー、またはカスタマイズポイントについて言及しないでください。プラグインの機能と組織のツールの観点からすべてをフレーミングしてください。

カスタマイズワークフロー

フェーズ 0: ユーザーの意図を把握 (スコープ付きおよび一般的なカスタマイズのみ)

スコープ付きカスタマイズと一般的なカスタマイズ (汎用プラグインセットアップではない) の場合、ユーザーがリクエストと一緒に自由形式のコンテキストを提供したかどうかをチェックします (例: 「スタンドアップスキルをカスタマイズして — 毎朝 #eng-updates で非同期スタンドアップを実施しています」)。

• ユーザーがコンテキストを提供した場合: それを記録し、フェーズ 3 で回答を事前入力するために使用します — ユーザーが既に回答した質問を尋ねません。

• ユーザーがコンテキストを提供しなかった場合: 進める前に AskUserQuestion を使用して、1 つのオープンエンドの質問を提出します。ユーザーがカスタマイズするよう求めたことに質問を合わせてください — 例: 「brief スキルにどのような変更を加えるつもりですか?」または「このプラグインの動作方法について何を変更したいですか?」短く、リクエストに固有にしてください。

  残りのフェーズ全体を通して、彼らの応答 (ある場合) を追加のコンテキストとして使用します。

フェーズ 1: 知識 MCP からコンテキストを収集

カスタマイズスコープに関連する情報を収集するために、社内知識 MCP を使用します。カテゴリ別の詳細なクエリパターンについては references/search-strategies.md を参照してください。

収集する内容 (関連するものにスコープを絞る):

• 組織が使用するツール名とサービス
• 組織のプロセスとワークフロー
• チーム慣例 (命名、ステータス、見積もりスケール)
• 設定値 (ワークスペース ID、プロジェクト名、チーム識別子)

検索対象:

1. Chat/Slack MCP — ツール言及、統合、ワークフロー議論
2. ドキュメント MCP — オンボーディングドキュメント、ツールガイド、セットアップ手順
3. メール MCP — ライセンス通知、管理者メール、セットアップ招待

フェーズ 3 で使用するすべての結果を記録します。

フェーズ 2: TODO リストを作成

実施するべき変更の TODO リストを作成し、適切にスコープを絞ります:

• スコープ付きカスタマイズ: ユーザーが求めた特定のセクションに関連するアイテムのみを含めます。
• 汎用プラグインセットアップ: grep -rn '~~\w' /path/to/plugin --include='*.md' --include='*.json' を実行してすべてのプレースホルダーカスタマイズポイントを見つけます。テーマ別にグループ化します。
• 一般的なカスタマイズ: プラグインファイルを読み、現在の設定を理解し、ユーザーのリクエストに基づいて何を変更する必要があるかを特定します。

プラグインの目的に焦点を当てた、ユーザーフレンドリーな説明を使用します:

• 良い例: 「Company でスタンドアップ準備がどのように機能するかを学ぶ」
• 悪い例: 「skills/standup-prep/SKILL.md 内のプレースホルダーを置き換える」

フェーズ 3: TODO アイテムを完了

フェーズ 0 とフェーズ 1 のコンテキストを使用して各アイテムに取り組みます。

ユーザーの自由形式入力 (フェーズ 0) または知識 MCP (フェーズ 1) が明確な答えを提供した場合: 確認なしで直接適用します。

それ以外の場合: AskUserQuestion を使用します。「業界標準」のデフォルトが正しいと想定しないでください — ユーザー入力も知識 MCP も特定の答えを提供していない場合は、尋ねます。注: AskUserQuestion には常にスキップボタンと自由テキスト入力ボックスが含まれるため、None または Other をオプションとして含めないでください。

変更のタイプ:

1. プレースホルダー置換 (汎用セットアップ): ~~Jira → Asana、~~your-org-channel → #engineering
2. コンテンツ更新: 手順、スキル、ワークフロー、参照を組織に合わせて変更
3. URL パターン更新: tickets.example.com/your-team/123 → app.asana.com/0/PROJECT_ID/TASK_ID
4. 設定値: ワークスペース ID、プロジェクト名、チーム識別子

ユーザーが知らない場合またはスキップした場合は、値を変更しないままにします (または汎用セットアップの場合は ~~ プレフィックス付きプレースホルダーのままにします)。

フェーズ 4: 有用な MCP を検索

カスタマイズアイテムが解決された後、識別または変更されたツール用の MCP を接続します。完全なワークフロー、カテゴリ-キーワードマッピング、設定ファイル形式については references/mcp-servers.md を参照してください。

カスタマイズ中に識別された各ツール:

1. レジストリを検索: search_mcp_registry(keywords=[...]) を使用して references/mcp-servers.md からカテゴリキーワードを使用するか、既に既知の場合は特定ツール名で検索
2. 未接続の場合: suggest_connectors(directoryUuids=["chosen-uuid"]) — ユーザーが認証を完了
3. プラグインの MCP 設定ファイルを更新 (plugin.json でカスタムロケーションを確認、それ以外は root の .mcp.json)

すべての MCP 結果を収集し、それらを要約出力に一度に提示します (以下を参照) — このフェーズ中に MCP を 1 つずつ提示しないでください。

プラグインをパッケージ化

すべてのカスタマイズが適用された後、プラグインを .plugin ファイルとしてパッケージ化します:

1. プラグインディレクトリをzip化 (setup/ は不要なため除外):

   cd /path/to/plugin && zip -r /tmp/plugin-name.plugin . -x "setup/*" && cp /tmp/plugin-name.plugin /path/to/outputs/plugin-name.plugin
   

2. ファイルをユーザーに提示 して .plugin 拡張子を使用するので、直接インストールできます。(.plugin ファイルを提示すると、ユーザーにはプラグインファイルを参照できるリッチプレビューとして表示され、ボタンを押してカスタマイズを受け入れることができます。)

重要: 常に /tmp/ で最初に zip を作成し、次に outputs フォルダにコピーします。outputs フォルダに直接書き込むと、権限の問題で失敗し、一時ファイルが残る可能性があります。

命名: .plugin ファイルに元のプラグインディレクトリ名を使用します (例: プラグインディレクトリが coder の場合、出力ファイルは coder.plugin である必要があります)。カスタマイズ中にプラグインまたはそのファイルの名前を変更しないでください — プレースホルダー値を置換し、コンテンツを更新するだけです。

要約出力

カスタマイズ後、ソース別にグループ化された学習内容の要約をユーザーに提示します。セットアップ中に接続された MCP とユーザーがまだ接続すべき MCP を示す MCP セクションを常に含めます:

## Slack の検索から

- プロジェクト管理に Asana を使用している
- スプリントサイクルは 2 週間

## ドキュメントの検索から

- ストーリーポイントは T シャツサイズを使用している

## あなたの回答から

- チケットステータスは: Backlog、In Progress、In Review、Done

次に、セットアップ中に接続された MCP とユーザーがまだ接続すべき MCP を提示し、それらを接続する方法についての手順を示します。

フェーズ 1 で利用可能な知識 MCP がなく、ユーザーが少なくとも 1 つの質問に手動で回答しなければならなかった場合、最後に注記を含めます:

ちなみに、Slack や Microsoft Teams のようなソースを接続すると、次回プラグインをカスタマイズするときに答えを自動的に見つけることができます。

追加リソース

• references/mcp-servers.md — MCP 検出ワークフロー、カテゴリ-キーワードマッピング、設定ファイルロケーション
• references/search-strategies.md — ツール名と org 値を見つけるための知識 MCP クエリパターン
• examples/customized-mcp.json — 完全に設定された .mcp.json の例