Playbook と Version
immutable な identity と柔軟な実行を両立する、再利用可能な進め方です。
Playbook は、owner、ACL、alias、latest Version、archive 状態を持つ論理 container です。実際の内容は immutable な Version に置かれるため、title や Step の変更は、過去の仕事で使った定義を書き換えず、新しい履歴として公開されます。
Definition
Version は、schemaVersion、title、description、単一 category、input schema、順序付き Step を含みます。category は productivity、programming、design、sales、marketing、operations、learning です。
input schema は object root の JSON Schema Draft 2020-12です。Case input を検証しますが、Epismo に Playbook を実行させるものではありません。
各 Step は次の field を持ちます。
| field | 意味 |
|---|---|
id |
論理 Playbook 内で安定した4文字の identity |
title |
判断可能な大きさの手順を表す短い説明 |
instructions |
人またはエージェントへの指針 |
resourceHints[] |
skill、MCP、CLI、API、plugin、graph、document、agent、custom resource の候補 |
expectedOutputs[] |
人とエージェント向けの hint。machine-enforced な完了条件ではない |
Step は status、assignee、transition、retry policy、dependency、完了日時を持ちません。エージェントは Step を省略、統合、並べ替え、追加できます。
publish と identity
Playbook の作成では container と Version 1をひとつの transaction で作ります。次の Version の publish には baseVersionId が必要です。latest が変わっていれば、同時変更を上書きせず conflict になります。
server は Definition を正規化し、canonical JSON と sha256: digest を保存します。JSON や YAML の空白・key 順が違っても同じ内容なら同じ identity です。Version に固定された Case は Version ID と digest を保持し、開始時の指針を後から検証できます。
新しい Step は ID を省略し、server が割り当てます。同じ論理 Step を編集するときだけ既存 ID を維持してください。削除済み ID は再利用されません。
発見と参照
読める Playbook を text・category で検索し、よく使うものを star し、alias を付けられます。表示形式は、local 解決の pb:alias と owner namespace を含む pb:handle/alias です。alias はアクセス権を付与せず、Version ではなく論理 Playbook を指します。
share token は恒久 ACL を変えずに token-based な read access を提供します。public Playbook は instructions と resource hint も公開するため、public を追加する前に secret、signed URL、社内限定参照、個人情報を除いてください。