Skip to main content
Glama

Playbook

절차를 JSON으로 관리합니다. 의도로 검색하고, 제목을 훑어보고, do를 한 번에 하나씩 로드하세요.

Playbook은 에이전트(또는 사용자)가 전체 플레이북을 컨텍스트에 통째로 넣지 않고도 방법 문서를 작성하고, 찾고, 따를 수 있게 해주는 작은 CLI이자 MCP 서버입니다. CLI 동사는 분리된 채 유지됩니다. MCP는 관련 동사를 더 적은 도구로 압축합니다. 모든 것이 JSON입니다.

Python 3.10+, 런타임에는 표준 라이브러리만 사용합니다.

설치

pip install -e .
playbook search

PyPI는 아직 게시되지 않았습니다.

Related MCP server: sop-mcp

파일 위치

절차당 하나의 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

모든 명령은 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

실행된 프로세스에 셸 PATH가 없을 경우 playbook의 절대 경로를 사용하세요. 그런 다음 /mcps와 r를 사용하거나 새 세션을 시작하세요.

도구

역할

playbook_search

의도 검색

playbook_open

제목 로드, --full, 또는 at으로 단계 시작

playbook_create

새 절차

playbook_edit

Title / description / tags

playbook_step

op: add | edit | remove

playbook_validate

검증

테스트

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

라이선스

MIT

Related MCP Connectors

Related MCP Servers