Playbook

Процедуры в формате JSON. Ищите их по намерению, просматривайте заголовки, загружайте один do за раз.

Playbook — это небольшой CLI и MCP-сервер, позволяющий агенту (или вам) создавать, находить и выполнять инструкции, не выгружая весь playbook в контекст. Глаголы CLI остаются раздельными. MCP сжимает связанные глаголы в меньшее количество инструментов. Всё — JSON.

Python 3.10+, только стандартная библиотека во время выполнения.

Установка

pip install -e .
playbook search

PyPI ещё не опубликован.

Related MCP server: servicenow-platform-mcp

Где хранятся файлы

Один JSON-файл на процедуру в каталоге данных платформы:

Учитывайте 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 — последовательность. Уникальные заголовки. Случайные идентификаторы шагов. do — это работа.

CLI

Каждая команда выводит JSON (включая ошибки).

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 — это BM25 плюс символьные n-граммы. Результаты содержат только id, title, description (по умолчанию 8, максимум 50). Слабые совпадения отбрасываются.

load — только заголовки. --full включает каждый do. start — это один do плюс заголовки before / after.

MCP (Grok)

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

Используйте абсолютный путь к playbook, если порождённый процесс не будет иметь ваш PATH из оболочки. Затем /mcps и r, или новая сессия.

Тесты

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

Лицензия

MIT