プレイブック

再利用できる進め方を検索、authoring、publish、共有、保存、改善します。

探して読む

epismo playbook search --query "release review" --category operations
epismo -w acme playbook search "release review" --output table
epismo playbook search --query "release review" --lang ja,fr
epismo playbook search --category operations
epismo playbook resource list --kind cli
epismo playbook list --resource-kind cli --resource-ref github:epismoai/cli
epismo playbook get <playbook-id-or-reference>
epismo playbook version list <playbook-id>
epismo playbook version get <playbook-id> <version-id>
epismo playbook version archive <playbook-id> <version-id>
epismo playbook starred

playbook get は UUID、pb:alias、pb:handle/alias などのプレイブック reference を受け取り、同じ読み取りでそのプレイブックの未解決の提案も返します（公開プレイブックなら無料、それ以外はプレイブック get 1回分）。search では text、category、page size、cursor、優先するコンテンツ言語を指定できます。--lang には2文字の言語コードを優先順にカンマ区切りで渡します。これは他言語を除外する filter ではなく、指定言語を上位に並べる指定です。英語が含まれていない場合は Epismo が fallback として追加します。--query を省略すると通常の一覧になり、--lang がなければ更新が新しい順、あれば言語の優先順位が先に適用されます。playbook resource list で resource reference を探し、playbook list の --resource-kind と --resource-ref で絞り込みます。これらの filter は text query と組み合わせません。同じ GitHub または npm resource を指す URL 形式と provider 固有の形式はまとめて表示されます。結果を使う前に、input schema、resource hint、expected output を含む Definition 全体を確認してください。

create と publish

Definition の file がまだない場合は、最小 template から始められます。

epismo playbook init --title "Release review" > playbook.json
epismo playbook create --definition @playbook.json

完全な Definition は file で渡します。

{
	"ownerId": "<account-id>",
	"access": { "visibility": "private", "editors": ["<user-or-team-id>"] },
	"definition": {
		"schemaVersion": 1,
		"title": "Release review",
		"description": "Review a release before publication.",
		"category": "operations",
		"inputSchema": {
			"type": "object",
			"required": ["repository"],
			"properties": { "repository": { "type": "string" } }
		},
		"steps": [
			{
				"title": "Inspect the change",
				"instructions": "Review scope, tests, risks, and rollback plan.",
				"resourceHints": [
					{ "kind": "document", "ref": "https://example.com/release-policy" }
				],
				"expectedOutputs": [{ "title": "Decision and evidence", "format": "markdown" }]
			}
		]
	}
}

epismo playbook create --input @playbook.json
epismo playbook version publish <playbook-id> \
  --base-version-id <latest-version-id> --input @next-version.json

新しい Step では ID を省略します。同じ論理 Step に限り既存の4文字 ID を維持してください。publish は immutable な Version を作ります。base-version conflict 後は base ID だけを変えず、latest を取得して変更意図を merge します。

過去の Version を非表示にし、新しい案件で利用させたくない場合は archive します。Version 番号は詰め直しも再利用もされず、latest Version は archive できません。archive 済み Version に固定された既存案件は動作を継続します。

下書き

epismo playbook draft get <playbook-id>
epismo playbook draft save <playbook-id> --base-revision 0 --input @draft.json
epismo playbook draft publish <playbook-id>
epismo playbook draft discard <playbook-id>

プレイブックが持てる下書きは最大1件で、既存のプレイブックにしか作れません（最初の Version は playbook create を使います）。--base-revision は最後に読んだ revision（新規なら 0）で、古い値は base-version conflict と同様に拒否されます。editor と owner manager は下書きを read/edit できますが、公開の reader と share link は読めません。draft publish は下書きから Version を作り同時に破棄し、draft discard は publish せずに破棄します。

access、参照、保存

epismo playbook access get <playbook-id>
epismo playbook access set <playbook-id> --visibility public --editors <user-or-team-ids>
epismo playbook alias set <playbook-id> <alias> [--owner-id <account-id>]
epismo playbook alias list <playbook-id> [--owner-id <account-id>]
epismo playbook alias delete <alias> [--owner-id <account-id>]
epismo playbook share "$PLAYBOOK_ID"
epismo playbook star <playbook-id>
epismo playbook unstar <playbook-id>
epismo playbook archive <playbook-id>

visibility public は公開済み content の read だけを許可します。editors は content の read と edit を行える active User Account または Team ID で、owner は暗黙でこの一覧には含めません。Workspace-owned プレイブックの Workspace Owner/Admin を含む owner manager だけが access 管理とプレイブック・過去 Version の archive を行えます。Alias は読みやすい名前、share token は token-based read access、star は個人保存を提供し、これらは独立しています。archive は Version を書き換えずに通常利用から外します。

提案

epismo playbook suggestion create <playbook-id> \
  --base-version-id <version-id> --title "Clarify evidence" --content "..."
epismo playbook suggestion list <playbook-id> --statuses open
epismo suggestion list
epismo suggestion list --view inbox
epismo suggestion update <suggestion-id> --title "..." --content "..."
epismo suggestion resolve <suggestion-id> --status applied \
  --result-version-id <new-version-id>

author は open な提案を編集し、プレイブック owner が resolve します。top-level の suggestion list は現在のユーザーが送った提案を既定で表示します。--view inbox を指定すると、自分が管理するプレイブックに対する提案を一覧表示します。applied には提案から publish した Version が必要です。採用しない場合は declined、取り下げる場合は archived にします。

公開プレイブックに対する playbook list と UUID 指定の playbook get はログイン前でも利用でき、0 credits です。検索、非公開データ、変更操作には認証が必要です。料金はクレジットを参照してください。