メインコンテンツまでスキップ

Coworkでプラグインをゼロから作る方法（2026ガイド）

· 約6分
Claude Dev
Claude Dev
Claude Dev

Cowork に本当に仕事を任せたいなら、プラグインが最も大きなレバーです。

2026-02-28 時点で、公式の流れは明確です。

  • Anthropic は 2026-01-14 に Cowork を発表
  • カスタムプラグインの作成・共有を 2026-01-20 に発表
  • 企業向けプラグインディレクトリ更新を 2026-02-24 に公開
  • プラグインのヘルプ記事を 2026-02-25 に更新

このガイドでは、公式フローとコミュニティ実践を組み合わせて、最初の実用プラグインをゼロから作る手順をまとめます。

UIを開く前に：プラグインに何をさせるか​

最初の良いプラグインは、狭くて繰り返し発生する1つの仕事を解決します。

最初のアイデアとして悪い例：

  • 「マーケティング戦略を全部やって」

最初のアイデアとして良い例：

  • 「会議メモを、担当者と期限つきの週次アクションに変換する」
  • 「障害ログを要約し、リスクトリアージ表を返す」
  • 「候補者プロフィールをレビューし、構造化スコアカードを返す」

作る前に、この1行契約を書いてください。

Input: 何を渡すか。
Output: 毎回何を返すべきか。

ここが曖昧だと、プロンプトはすぐにぶれます。

Step 1) Coworkでプラグインの土台を作る​

Cowork のプラグイン領域を開き、新規プラグインを作成します。

公式ドキュメント/ヘルプでは、通常次が可能です。

  • Cowork UI でゼロから作成
  • ローカルファイルからインポート
  • プラグインディレクトリから既存プラグインをインストール

初回は from scratch を選ぶのがおすすめです。

Step 2) 名前と説明：精度はここで決まる​

コミュニティで繰り返し言われているのは、プラグイン選択の精度は名前と説明の明確さに強く依存する、という点です。

推奨フォーマット：

  • 名前：具体的な役割（Incident Triage Reporter）
  • 説明：トリガー + 対象範囲（Use when user asks to triage ops incidents from raw logs into severity, owner, and next action.）

「general assistant plugin」のような曖昧な説明は避けましょう。

重要な理由：

  • Cowork は「いつこのプラグインを使うか」を判断する必要がある
  • 曖昧な説明は誤起動や未起動につながる

Step 3) 厳格なプロンプト契約を書く​

プラグイン指示は、運用 runbook のように書くのが基本です。

最小構成：

  1. 役割と目的
  2. 必須入力
  3. 出力フォーマット（固定セクション/表/JSON風構造）
  4. 判断ルールと優先順位
  5. 安全境界と不確実時の対応

例：

You are Incident Triage Reporter.

Goal:
- Convert raw incident notes into a priority triage report.

Required inputs:
- incident_log
- service_name
- report_time

Output format:
- Severity: P0/P1/P2/P3
- Impact summary (max 3 bullets)
- Suspected root cause
- Immediate next action
- Owner recommendation

Rules:
- If evidence is weak, state uncertainty explicitly.
- Never invent metrics not present in input.
- Ask one clarifying question if critical context is missing.

コミュニティの実感としては、長い「何でもやる」プロンプトより、短く制約したプロンプトの方が安定します。

Step 4) 「創造的」出力ではなく「予測可能」出力を設計する​

プラグインをワークフローに組み込むなら、文体より一貫性が重要です。

実務チェック：

  • チームが10秒で結果を把握できるか
  • 後段の自動化でパースできるか
  • 5つの異なる入力でも形式が安定するか

ダメなら、指示を締めてスコープを絞ってください。

Step 5) 共有前に実際のエッジケースで検証する​

ハッピーパスだけでは不十分です。

最低限この5テスト：

  1. クリーンで完全な入力
  2. 重要フィールド欠落
  3. 矛盾データ
  4. 長文/ノイズ入力
  5. スコープ外入力

#5 の期待動作は「明確な拒否 + 代替提案」です。

Step 6) ワークスペースに安全に共有する​

公式のチーム向け展開では、制御された共有とワークスペースガバナンスが強調されています。

社内公開前に次を用意：

  • 「When to use / When not to use」
  • 入出力サンプル
  • オーナーと保守方針
  • プロンプト版管理（v0.1、v0.2 など）+ ミニ変更履歴

これで数週間後の「謎プラグイン化」を防げます。

Step 7) 実運用シグナルで改善する​

公開後は週次で実行結果を見ます。

  • 起動品質（正しいタイミングで呼ばれたか）
  • 修正率（ユーザーがどれだけ書き直したか）
  • 失敗パターン（文脈不足、誤推論）

1回の改善で変えるのは1要素だけ：

  • 説明文
  • プロンプトルール
  • 出力スキーマ

全面書き換えより、小さな制御変更が有効です。

公式とコミュニティ、どちらを優先すべきか​

優先順は次の通りです。

  1. 公式 Cowork 製品/サポート文書（機能挙動、権限、展開）
  2. 公式プラグインチュートリアル/リファレンス（形式と実装）
  3. コミュニティ事例（エッジケースや実用ヒューリスティクスに有効）

コミュニティ情報は有用ですが、Cowork の更新により古くなる速度も速いです。

まとめ​

最初の Cowork プラグインは、地味で、狭く、信頼できるものにしてください。

次の3点を守れば：

  • 明確なトリガー説明
  • 厳格な出力契約
  • 規律あるテストケース

…短期間で実利が出て、2つ目のプラグインは大幅に作りやすくなります。

参考ソース（2026-02-28確認）​

公式​

コミュニティ​