Crear un Playbook

Un buen libro de estrategias describe el propósito, los aportes, los pasos a considerar y los resultados esperados, no un gráfico de ejecución.

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

No coloque credenciales ni URL firmadas en las referencias de recursos. Omita los ID de pasos al crear un libro de estrategias. Durante la publicación, conserve una identificación de cuatro caracteres existente solo para el mismo paso lógico.

Las categorías son productividad, programación, diseño, ventas, marketing, operaciones y aprendizaje. El esquema de entrada es JSON Schema Draft 2020-12 con una raíz de objeto.

Una vez que exista un Playbook, guarde el trabajo modificado como un Borrador en lugar de publicar cada intento. Un borrador es mutable y no tiene versión: guárdelo tantas veces como necesite la definición antes de que su publicación lo convierta en una versión.