playbook
Playbook
手順は JSON として記述します。意図から検索し、タイトルをたどり、do を1つずつ読み込みます。
Playbook は、小さな CLI であり、かつ小さな MCP サーバーです。エージェント(またはあなた)が、プレイブック全体をコンテキストに含めずに、ハウツーを作成・検索・実行できます。CLI の操作は分割されたままです。MCP は関連する操作をより少ないツールにまとめます。すべてが JSON です。
Python 3.10+、実行時は 標準ライブラリのみ を使用します。
インストール
pip install -e .
playbook searchPyPI にはまだ公開されていません。
Related MCP server: sop-mcp
ファイルの保存場所
手順ごとに1つの JSON ファイルが、プラットフォームのデータディレクトリに置かれます。
OS | ディレクトリ |
Linux |
|
macOS |
|
Windows |
|
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 を実行するか、新しいセッションを開いてください。
ツール | 役割 |
| 意図に基づく検索 |
| タイトルの読み込み、 |
| 新しい手順の作成 |
| タイトル / 説明 / タグ |
|
|
| 検証 |
テスト
pip install -e .
python -m pytest tests/ -qライセンス
MIT
This server cannot be deployed
Maintenance
Related MCP Connectors
- mcp-serverOAuthcom.make
Give your AI agents the tools to build, manage, and run automation workflows.
Build and run agents and automations across hundreds of apps using natural language.
The governed runtime for agent skills. Search the catalog and inspect a skill before running it.
- SkilderOAuthai.skilder
One place to build, share, and govern the skills and tools your AI agents use at work.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to create, share, discover, and execute reusable multi-step workflow templates.MIT
- AlicenseAqualityAmaintenanceEnables AI agents to execute multi-step Standard Operating Procedures step by step, with enforcement of completion at each step, making LLM behavior predictable and auditable.53Apache 2.0
- AlicenseNot gradedqualityBmaintenanceGuides AI agents through structured, multi-step workflows with discovery, navigation, and fidelity enforcement.2Apache 2.0
- AlicenseAqualityBmaintenanceEnables AI agents to manage, search, plan, and execute reusable skills while automatically enforcing always-on coding and reasoning guidelines. It provides workflow orchestration, permission-controlled execution, dynamic skill registration, and feedback-based ranking.96 npm1MIT