Libros de jugadas

Buscar y leer

epismo playbook search --query "release review" --category operations
epismo -w acme playbook search "release review" --output table
epismo playbook search --query "release review" --lang es,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 acepta un UUID o una referencia de Playbook como pb:alias y pb:handle/alias, y devuelve el Playbook junto con sus Sugerencias abiertas en la misma lectura—gratis para un Playbook público, una lectura de Playbook en los demás casos. La búsqueda admite texto, categoría, tamaño de página, cursor e idiomas de contenido preferidos. Pase a --lang códigos de idioma de dos letras, separados por comas y en orden de prioridad. Esto coloca primero los idiomas coincidentes en vez de excluir los demás resultados; Epismo añade el inglés como alternativa si aún no está en la lista. Omita --query para obtener una lista de catálogo simple. Sin --lang, se ordena por la actualización más reciente; con esta opción, tiene prioridad el orden de los idiomas. Use playbook resource list para descubrir referencias de recursos y filtre playbook list con --resource-kind y --resource-ref; no combine estos filtros con una consulta de texto. Las formas equivalentes de URL y de proveedor de GitHub y npm se agrupan juntas. Lea la Definición completa, especialmente el esquema de entrada, las sugerencias de recursos y los resultados esperados, antes de utilizar un resultado.

Crear y publicar

Cuando todavía no tenga un archivo de Definición, empiece con una plantilla mínima:

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

Utilice un archivo para obtener una definición completa:

{
	"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

Omita las identificaciones para los nuevos pasos. Conserve una ID de cuatro caracteres existente solo para el mismo paso lógico. La publicación crea una versión inmutable; después de un conflicto entre la versión base, obtenga la última versión y combine su intención en lugar de cambiar solo la ID base.

Archive una versión histórica cuando ya no deba estar visible ni disponible para nuevos casos. Los números de versión no se renumeran ni se reutilizan, y la última versión no se puede archivar. Los casos existentes fijados a una versión archivada siguen funcionando.

Borrador

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>

Un Playbook tiene como máximo un borrador, y solo un Playbook existente puede tener uno; use playbook create para la primera versión. --base-revision es la última revisión que leyó (0 para un nuevo borrador); se rechaza un valor obsoleto, al igual que un conflicto de versión base en la publicación. Los editores y administradores propietarios pueden leer y editar el Borrador; los lectores públicos y enlaces compartidos no. draft publish acuña una Versión del Borrador y la descarta en el mismo paso; draft discard lo tira a la basura.

Acceso, referencias y guardado

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 permite a cualquiera leer únicamente contenido publicado. editors son ID de Cuenta de usuario o Equipo activos que pueden leer y editar contenido; el propietario es implícito y nunca aparece en la lista. Solo los administradores propietarios, incluidos los Owners y Admins de un Workspace para un Playbook propiedad de este, gestionan el acceso y archivan Playbooks o Versiones históricas. Un alias proporciona un nombre legible, un token compartido proporciona acceso de lectura basado en token y una estrella es personal. Estos mecanismos son independientes. El archivado elimina un Playbook del uso normal sin reescribir sus versiones.

Sugerencias

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>

El autor puede editar una sugerencia abierta; el propietario del Playbook lo resuelve. suggestion list muestra por defecto las Sugerencias enviadas por el usuario actual. Pase --view inbox para listar las Sugerencias de los Playbooks que gestiona. applied requiere la Versión publicada de la propuesta. Resolver como declined cuando no deba adoptarse y archived cuando se retire.

playbook list y playbook get por UUID funcionan antes de iniciar sesión para Playbooks públicos y cuestan 0 créditos. La búsqueda y las operaciones privadas o de escritura requieren autenticación y usan los precios de Créditos.