playbook
Playbook
절차를 JSON으로 관리합니다. 의도로 검색하고, 제목을 훑어보고, do를 한 번에 하나씩 로드하세요.
Playbook은 에이전트(또는 사용자)가 전체 플레이북을 컨텍스트에 통째로 넣지 않고도 방법 문서를 작성하고, 찾고, 따를 수 있게 해주는 작은 CLI이자 MCP 서버입니다. CLI 동사는 분리된 채 유지됩니다. MCP는 관련 동사를 더 적은 도구로 압축합니다. 모든 것이 JSON입니다.
Python 3.10+, 런타임에는 표준 라이브러리만 사용합니다.
설치
pip install -e .
playbook searchPyPI는 아직 게시되지 않았습니다.
Related MCP server: sop-mcp
파일 위치
절차당 하나의 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
모든 명령은 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 mcpsearch는 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를 사용하거나 새 세션을 시작하세요.
도구 | 역할 |
| 의도 검색 |
| 제목 로드, |
| 새 절차 |
| Title / description / tags |
|
|
| 검증 |
테스트
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