Egent

📋 動機と概要

Cursor、Windsurf、Augment Code、Cline などの最新のプログラミングツールには、自然言語の指示に基づいて複雑なタスクを自動的に完了できる、強力な「エージェントモード」が搭載されています。

• パッケージの依存関係の更新と CVE 脆弱性への対処
• 複数のファイルにわたる定型的なコードのリファクタリング
• 新機能や既存機能へのユニットテストの追加
• コードのフォーマットの統一と lint の問題の修正

しかし、こうした機能には重大な制約があります。それは コンテキストの共有 です。

問題

• チームメンバーごとに異なるツール（Cursor、Cline など）を使用しています
• 自然言語の「プレイブック」は各自の環境にしか存在しません
• プレイブックを共有、バージョン管理、共同改善するための一元的な方法がありません
• チームメンバーがそれぞれ独自のエージェント向け指示を作成することで、プレイブックがサイロ化します

解決策：playbookmcp

playbookmcp は、GitHub リポジトリをベースとするプレイブックを、主要なプログラミングツールがすべてサポートする MCP サーバーに変換します。これにより、次のことが可能になります。

• 標準的な GitHub ワークフローを通じたプレイブックの 共同編集
• チームのプレイブックの バージョン管理
• 新しい機能をチーム全体で 即座に共有

たとえば、エンジニアの Alice が「モノレポ全体の依存関係のバージョンを更新する」ための新しいプレイブックを作成し、プレイブックリポジトリにコミットしてプッシュすると、エンジニアの Bob は自分の好みのコーディングツールですぐにその機能を利用できます。

🔍 設計

チームはプレイブックリポジトリ（通常は GitHub リポジトリ）を編集することで、ナレッジベースを継続的に充実させ、AI がさまざまなタスクを自動的に完了できるようにします。

プレイブックリポジトリの構成の詳細については、docs/playbook.md をご覧ください。

🚀 使い方

セットアップ

基本設定

リモートのプレイブックリポジトリで playbookmcp を使用するには：

{
  "mcpServers": {
    "playbookmcp": {
      "command": "npx",
      "args": [
        "-y",
        "playbookmcp@latest",
        "--playbook-repo",
        "<your playbook repo>"
      ]
    }
  }
}

ローカル開発

ローカルのコンテキストディレクトリを使用してテストするには：

{
  "mcpServers": {
    "playbookmcp-local": {
      "command": "npx",
      "args": [
        "-y",
        "playbookmcp@latest",
        "--playbook-path",
        "<your playbook files path>"
      ]
    }
  }
}

PlaybookMCP の開発

PlaybookMCP 自体を開発するには：

{
  "mcpServers": {
    "playbookmcp-dev": {
      "command": "node",
      "args": [
        "build/index.js",
        "--playbook-path",
        "<your playbook files path>"
      ]
    }
  }
}

inspector を使って MCP リソースを確認することもできます。

npx @modelcontextprotocol/inspector node build/index.js --playbook-repo <your playbook repo>

コードエージェントとのチャット

以下は Cursor の設定例です。

{
  "mcpServers": {
    "playbookmcp": {
      "command": "npx",
      "args": [
        "-y",
        "playbookmcp@latest",
        "--playbook-repo",
        "[email protected]:xuezhaojun/PlaybookMCP-demo.git"
      ]
    }
  }
}

操作を開始するには、最初のコマンドとして pb_start を実行する必要があります。

pb_start Say Hi to playbookmcp.

または、より具体的に指定できます。

use MCP tool pb_start Say hi to playbookmcp.

その後、コードエージェントがこの issue にコメントを追加します。