LECCIÓN 10 / 6 de noviembre de 2026
Objetivo de esta lección: Sabrás... Número de versión, registro de cambios, matriz de compatibilidad y condiciones de reversión Incluido en el repositorio de Skill reference/lista-de-comprobaciones-de-lanzamiento.md, en lugar de decir en el chat «te lo enviaré esta noche». En la lección anterior ya escribiste sobre el contrato de coordenadas de uso del ordenador y los límites de Harness:https://school.myshirtai.com/?p=4478. Esta lección, más allá del contrato, abordaPublicación y gestión——Quién ha modificado qué, si se pueden combinar y cómo devolverlas si fallan. El formato es de aprendizaje a través de un curso (documentación + ejercicios); como no se ejecuta en el propio equipo, sino que se sube a CI / Skills API, no se indican resultados numéricos en primera persona.
Si falta la lista de publicaciones en el almacén, en línea se utilizará por defecto
últimas noticias: Cualquiera puede sustituir la habilidad que está utilizando tu agente de producción.
Premisas y objetivos verificables
Por favor, completa primero la lección 9, «Incorporar el acuerdo de coordenadas de uso del ordenador y los límites de Harness en la habilidad»:https://school.myshirtai.com/?p=4478. Debes tener a mano, como mínimo: una habilidad de objetivo que se pueda cargar,referencia/ Permisos de escritura o la posibilidad de enviar PR; hooks de evaluación de la lección 6 (los casos de fallo pueden incluirse en la regresión). Si necesitas repasar los conceptos básicos anteriores, consulta la lección 1. https://school.myshirtai.com/archives/3378; Lección 2 https://school.myshirtai.com/archives/3462; Lección 3 https://school.myshirtai.com/archives/3521; Lección 4 https://school.myshirtai.com/archives/3661; Lección 5 https://school.myshirtai.com/?p=3948; Lección 6 https://school.myshirtai.com/?p=4048; Lección 7 https://school.myshirtai.com/?p=4191; Lección 8 https://school.myshirtai.com/?p=4331.
Esta noche solo se concederán noventa minutosuno Añade la lista de publicaciones a Skill, pero no te pongas a reestructurar todos los scripts de paso.
- Objetivo A:Enviar
reference/lista-de-comprobaciones-de-lanzamiento.md(incluye cuatro apartados: versión, modificaciones, compatibilidad y reversión). - Objetivo B:Se incluyen dos ejemplos de casos fallidos —en los que se omite el campo de versión y la condición de reversión— que pueden ser señalados por el hook de evaluación de la lección 6.
- Objetivo C:En la lista, especifica si «las referencias de producción están fijadas a un ID de versión / no se permite actualizar automáticamente a la última versión». Si no se ha probado la subida de la API, basta con indicar «No se ha ejecutado en el entorno local mediante CI».
Concepto: ¿Qué hay que fijar con clavos en la lista de publicaciones?
En la lección 9 se garantiza que las coordenadas de los puntos son correctas. En la lección 10 se añade lo siguiente: en cuanto una Skill entra en el directorio compartido o en la API de Skills, la gestión de versiones y las reversiones pasan a depender de «quien la haya subido en último lugar». En la documentación pública, las Agent Skills incluyen SKILL.md carpeta; cuando se crea una versión en la API, las subidas posteriores deben mantener el mismo identificador inmutable nombre, las versiones se identifican mediante un identificador único, aunque también se pueden utilizar literales últimas noticias——Este es precisamente el punto en el que la producción requiere una decisión explícita.
Esta lista no es otra reflexión sobre el archivo README, sino una lista de comprobación previa a la publicación. Se recomienda incluir al menos cuatro puntos:
- Versión:Etiquetas de almacén /
SKILL.mdCampo «Versión interna» / «ID de versión de la API»: ¿cómo se alinean estos tres elementos? - Registro de cambios:¿En esta ocasión se ha modificado la descripción, el script o el contrato? ¿Qué frases desencadenantes se ven afectadas?
- Compatibilidad:Versión de Claude Code / API / Harness / contrato de coordenadas a la que se recurre; si entra en conflicto con la declaración de uso informático de la lección 9.
- Revertir:¿Cuáles son las señales de fallo?, ¿a qué ID de versión o etiqueta de Git se debe revertir?, y ¿quién tiene permiso para ejecutarlo?

Ejercicio: Redacta una lista de publicaciones que se pueda pegar.
Crear un nuevo elemento en la sección «Habilidades» reference/lista-de-comprobaciones-de-lanzamiento.md. La plantilla que aparece a continuación se puede pegar directamente y modificar los campos entre corchetes; el bloque de código solo sirve como ejercicio de documentación y no se ha ejecutado en CI local.
# Lista de comprobación de lanzamiento —
## Versión
- etiqueta de Git:
- campo de versión de SKILL.md:
- skill_id de la API / id de la versión (si se ha subido):
- pin de producción: id de la versión | última versión (por defecto: id del pin)
## Registro de cambios
- desencadenantes / descripción:
- scripts / referencia:
- ¿Cambios importantes? sí/no — migración:
## Compatibilidad
- Claude Code / superficie de la API:
- Harness / contrato de uso informático (lección 9):
- ID del conjunto de evaluaciones (lección 6):
## Reversión
- señales de fallo:
- reversión a:
- propietario / plazo:
- detener si:
Lista de materiales: permiso de escritura o PR; poder añadir dos casos de uso de «control de acceso a la publicación» al conjunto de pruebas de la lección 6; poder incluir en la descripción del PR el resultado de marcar los elementos de la lista. Si no hay incidentes reales en producción, utilizar ejemplos simulados: se modificó la descripción pero no se lanzó una nueva versión, y la producción sigue funcionando. últimas noticias.

- Copiar la plantilla en
reference/lista-de-comprobaciones-de-lanzamiento.md, rellena el campo «Skill» con el carácter «真». - Establecer como valor predeterminado para «crear pin» un identificador de versión concreto o una etiqueta de Git, y prohibir que se indique únicamente «latest».
- Añadir dos ejemplos de errores al índice de evaluación de la lección 6 (véase el siguiente apartado).
- En el texto de relaciones públicas, marcar la lista de publicaciones; en la revisión, comprobar únicamente si los cuatro campos están vacíos.
Ejemplos de respuestas incorrectas y el gancho de evaluación de la lección 6
Las evaluaciones no son opcionales. En la lección 6 ya se ha enseñado a realizar regresiones con conjuntos de datos de evaluación; en esta lección se requiere que la publicación del control de acceso también pueda ser activada por el mismo hook. Prepara al menos dos.Debería fracasarEjemplo:
| Ejemplo | ¿Qué falta? | Resultados esperados de la evaluación |
|---|---|---|
| Versión con errores | Sin etiqueta Git / Sin campo de versión / Sin pin | Luz roja en el control de acceso: prohibido incorporarse |
| Reversión de errores | Hay un registro de cambios, pero no hay señales de fallo ni reversión a | Luz roja en el control de acceso: prohibido incorporarse |
| Espacio de compatibilidad | Se ha modificado «computer-use», pero no se ha hecho referencia al contrato de la lección 9. | Advertencia o luz roja (a decidir por el equipo) |

Escribe el nombre del archivo de ejemplo en la línea «eval suite id» de la lista, por ejemplo: evals/release-missing-version.md. De este modo, el «hook» de la lección 6 y el control de acceso de la lección 10 comparten el mismo conjunto de convenciones de rutas, lo que evita que las dos estructuras de directorios se desincronicen.
Nota:En este artículo no se ha creado una versión mediante la llamada local a la API de Skills ni se ha ejecutado el CI del repositorio. Los criterios de aceptación del ejercicio son que se cumplan todos los requisitos: «archivo de lista de comprobación + dos ejemplos de fallos + marcadores de la solicitud de incorporación de cambios (PR)». No escribas en el ejercicio de documentación que «ya se ha subido a producción».
Avance de la próxima lección
Avance de la próxima lección (por confirmar): Lanzamiento gradual y lista blanca de MCP: cómo incluir un ID de versión fijo en el tráfico de lanzamiento gradual y cómo añadir a la lista blanca y establecer un periodo de observación para las llamadas a herramientas de alto riesgo. En esta lección, primero nos aseguraremos de que la lista de lanzamientos fuera de línea y las alertas rojas de evaluación funcionen correctamente; si no hay condiciones para revertir los cambios, el lanzamiento gradual solo aumentará el alcance de los incidentes.
Índice de esta serie
- Lección 1: Crea en 30 minutos tu primera «Claude Agent Skill» que se active automáticamente — https://school.myshirtai.com/archives/3378
- Lección 2: Añadir una referencia a Skill / El ciclo de verificación «primero redactar el documento de planificación y luego ejecutar» — https://school.myshirtai.com/archives/3462
- Lección 3: Skills con scripts y auditorías de seguridad — https://school.myshirtai.com/archives/3521
- Lección 4: Descripción de la iteración con casos reales de fallo — https://school.myshirtai.com/archives/3661
- Lección 5: Conectar Skill a un repositorio real de CI / a un directorio compartido del equipo — https://school.myshirtai.com/?p=3948
- Lección 6: Regresión de una habilidad utilizando un conjunto de evaluación — https://school.myshirtai.com/?p=4048
- Lección 7: Programación de múltiples habilidades: desglose y combinación de límites y resolución de conflictos de activación — https://school.myshirtai.com/?p=4191
- Lección 8: Incorporar el patrón Task/subagente en una Skill: límites de paralelismo y aislamiento del contexto — https://school.myshirtai.com/?p=4331
- Lección 9: Incorporar el acuerdo de coordenadas de uso del ordenador y los límites de Harness en Skill — https://school.myshirtai.com/?p=4478
- Lección 10: Publicar la lista de cambios de una Skill en el repositorio: versiones, registro de cambios, compatibilidad y reversión (este artículo)
Nuestra valoración:El valor de publicar una lista no radica en que sea «otro Markdown más», sino en que te obliga a responder a preguntas sobre la versión, la compatibilidad y la reversión antes de realizar la incorporación. Fijar el identificador de versión e incluir el ejemplo de fallo de la lección 6 es más fácil de validar que un simple «cuidado con la última versión» dicho de boca.
Enlaces de referencia
- Documentación de Claude Code: Amplía las capacidades de Claude con nuevas habilidades
- Descripción general de las habilidades de los agentes (estándares abiertos)
- GitHub: anthropics/skills
- Documentación de la API de Claude: Versiones de las habilidades
- Lección 9: Acuerdo de coordenadas para el uso del ordenador y Harness
- Lección 6: Regresión de una habilidad utilizando un conjunto de evaluación


评论列表 (0条):
加载更多评论 Cargando...