Skip to main content
Glama

Playbook

手順は JSON として記述します。意図から検索し、タイトルをたどり、do を1つずつ読み込みます。

Playbook は、小さな CLI であり、かつ小さな MCP サーバーです。エージェント(またはあなた)が、プレイブック全体をコンテキストに含めずに、ハウツーを作成・検索・実行できます。CLI の操作は分割されたままです。MCP は関連する操作をより少ないツールにまとめます。すべてが JSON です。

Python 3.10+、実行時は 標準ライブラリのみ を使用します。

インストール

pip install -e .
playbook search

PyPI にはまだ公開されていません。

Related MCP server: sop-mcp

ファイルの保存場所

手順ごとに1つの JSON ファイルが、プラットフォームのデータディレクトリに置かれます。

OS

ディレクトリ

Linux

~/.local/share/playbook/procedures/

macOS

~/Library/Application Support/playbook/procedures/

Windows

%LOCALAPPDATA%\playbook\Data\procedures\

XDG_DATA_HOME / APPDATA / LOCALAPPDATA を尊重します。コマンドはパスではなく、手順の id を受け取ります。

構成

{
  "id": "follow-playbook",
  "title": "Follow a playbook procedure",
  "description": "When to pick this file. Can be verbose.",
  "tags": ["playbook", "follow"],
  "steps": [
    {
      "id": "a1b2c3…",
      "title": "Search by intent",
      "do": "Call playbook_search with a sentence for the job."
    }
  ]
}
  • title — 検索カードに表示される短い名前

  • description — この手順を選ぶべきタイミング

  • steps — 順序付き。タイトルは一意。ステップ id はランダム。do が作業本体です。

CLI

playbook create demo --title "Demo" --description "when to pick this" --tags demo
playbook add-step demo --title "First" --do "Do the first thing."
playbook add-step demo --title "Middle" --do "Do the middle." --after "First"
playbook edit demo --title "Better title"
playbook search "I want to follow a procedure"
playbook load demo
playbook load demo --full
playbook start demo --title "First"
playbook validate demo
playbook mcp

すべてのコマンドは JSON を出力します(エラーを含む)。

search はヒント意図に基づく BM25 と文字 n-gram を組み合わせた検索です。ヒットするのは id・title・description のみです(デフォルト 8 件、上限 50 件)。弱い一致は除外されます。

load はタイトルのみ返します。--full はすべての do を含みます。start は1つの do と before / after のタイトルを返します。

MCP (Grok)

grok mcp add --scope user playbook -- playbook mcp

起動されたプロセスにシェルの PATH が引き継がれない場合は、playbook への絶対パスを使用してください。その後 /mcps と r を実行するか、新しいセッションを開いてください。

ツール

役割

playbook_search

意図に基づく検索

playbook_open

タイトルの読み込み、--full、または at でステップを開始

playbook_create

新しい手順の作成

playbook_edit

タイトル / 説明 / タグ

playbook_step

op: 追加 | 編集 | 削除

playbook_validate

検証

テスト

pip install -e .
python -m pytest tests/ -q

ライセンス

MIT

Related MCP Connectors

Related MCP Servers