Playbook

Prozeduren als JSON. Durchsuche sie nach Absicht, gehe Titel durch, lade jeweils ein do nach dem anderen.

Playbook ist ein kleiner CLI- und MCP-Server, damit ein Agent (oder du) Anleitungen schreiben, finden und befolgen kann, ohne das gesamte Playbook in den Kontext zu laden. CLI-Verben bleiben getrennt. MCP komprimiert verwandte Verben in weniger Werkzeuge. Alles ist JSON.

Python 3.10+, nur Standardbibliothek zur Laufzeit.

Installation

pip install -e .
playbook search

PyPI ist noch nicht veröffentlicht.

Related MCP server: servicenow-platform-mcp

Wo Dateien liegen

Eine JSON-Datei pro Prozedur, im Plattform-Datenverzeichnis:

Beachte XDG_DATA_HOME / APPDATA / LOCALAPPDATA. Befehle nehmen eine Prozedur-id, keinen Pfad.

Form

{
  "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 — kurzer Name auf Suchkarten

• description — wann diese Prozedur gewählt werden soll

• steps — seriell. Eindeutige Titel. Zufällige Schritt-IDs. do ist die Arbeit.

CLI

Jeder Befehl gibt JSON aus (einschließlich Fehlern).

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

search ist BM25 plus Zeichen-n-Gramme. Treffer sind nur id, title, description (Standard 8, Maximum 50). Schwache Übereinstimmungen werden verworfen.

load ist nur Titel. --full enthält jedes do. start ist ein do plus before / after-Titel.

MCP (Grok)

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

Verwende einen absoluten Pfad zu playbook, wenn der gestartete Prozess dein Shell-PATH nicht hat. Dann /mcps und r, oder eine neue Sitzung.

Tests

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

Lizenz

MIT