Lección 7: Programación de múltiples habilidades: desglose y combinación de límites y resolución de conflictos de activación
Objetivo de esta lección: cuando tengas más de una habilidad en tu repositorio, deberíasDecidir cuándo separar y cuándo unir, y definir «description» como excluyente; cuando haya dos candidatos, se elegirá uno de ellosTabla de arbitraje, y no basándose en el principio de «el primero en incluirlo en el directorio gana». En la lección anterior ya realizaste una regresión para una única habilidad utilizando el conjunto de pruebas:https://school.myshirtai.com/?p=4048; Esta lección va más allá y aborda la activación simultánea de varias habilidades y la superposición de límites. No se trata de escribir otra reflexión sobre «la importancia de la colaboración», sino de presentar esta misma noche las normas de descomposición y combinación, las sentencias mutuamente excluyentes, la tabla de arbitraje y ejemplos de conflictos.
Introducción
Por favor, completa primero la lección 6, «Regresión de una habilidad utilizando un conjunto de evaluación»:https://school.myshirtai.com/?p=4048. Debes tener a mano, como mínimo: dos o más que puedan equiparse con habilidades y que puedan correr run_skill_eval.py(o equivalente), ejemplos de activaciones erróneas o omisiones de activación que quedan pendientes de las lecciones 4 a 6. Si te faltan conocimientos previos, repasa 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.
Lista de materiales: con permisos de escritura se puede enviar una PR; en el índice de evaluaciones se pueden añadir ejemplos de «pares en conflicto»; el equipo debe acordar una tabla de prioridades de arbitraje (que se puede incluir en skills/README.md). Si no hay un registro real de doble activación, utiliza primero la frase de la lección 6, en la sección «fallos», que dice «se nombró a A, pero se ejecutó B»; no te inventes historias para que todo encaje.
Si el gancho de evaluación de la lección 6 solo puede devolver «si se ha activado + nombre de la habilidad», es suficiente para esta lección; si el gancho solo puede devolver un valor booleano, añade primero el análisis del nombre de la habilidad, ya que, de lo contrario, no se podrán expresar las expectativas de conflicto. Describir la «limitación de la capacidad del gancho» como un obstáculo antes de comenzar la lección 7 es más honesto que limitarse a escribir ejemplos a la fuerza.
Recomendación de Time Box: esta noche, dedica noventa minutos a gestionar solo un par de habilidades que se solapan; no intentes resolver todo el almacén de una sola vez. Solo si un par se ejecuta con éxito, la norma tendrá sentido; si todo el sistema gira en vacío, lo único que quedará será una rebaja que nadie ha aprovechado.

Concepto: en la coreografía, primero hay que resolver los límites y luego ya se ve quién es más listo
La lección 6 garantiza que la activación de una habilidad concreta sea reproducible. La lección 7 añade lo siguiente:Aunque ambos sean «legítimos», es posible que quieran jugar al mismo tiempo. Organiza la respuesta en cuatro preguntas: ¿Debería dividirse en dos Skills? ¿Hay frases contradictorias en la descripción? ¿Cuál tiene prioridad en caso de conflicto? ¿Se pide al usuario que aclare la situación en caso de empate?
- El montaje y desmontaje es una decisión de producto:Las autorizaciones, el coste del fracaso y el grado de solapamiento del corpus tienen prioridad sobre que «el índice tenga buen aspecto».
- Escribir en «description» de forma mutua:Indica claramente qué hay que hacer, y escribe en frases cortas: «No gestionar X / Si se da el caso de Y, utilice Z».
- Entrada de la tabla de arbitraje en el almacén:Control de versiones de las prioridades y las estrategias de empate; las modificaciones en las tablas deben someterse a una evaluación de conflictos.
- Ejemplos de conflictos para la evaluación de la lección 6:Las dos frases candidatas deben cumplir con el requisito de «expectativa»; no se permite utilizar «cualquiera de las dos» como referencia de referencia.
Los materiales oficiales sobre «Agent Skills» hacen hincapié en que la descripción es la encargada de activar la acción; cuando hay varias habilidades, también hay que dejar claro el espacio negativo entre los activadores. El concepto queda aquí; a continuación, pasaremos directamente al desglose, la combinación y la resolución de conflictos.
La organización no consiste en crear otra «superhabilidad» en la que se incluyan todas las capacidades. Las superhabilidades difuminan los límites entre los permisos, las evaluaciones y las responsabilidades. Si algo se puede aclarar mediante una tabla de arbitraje, no hay que arriesgarse a utilizar una descripción más amplia.
La relación con la lección 6 se puede resumir en una frase: las habilidades individuales garantizan que «se active o no la mía»; las combinaciones de habilidades garantizan «cuál de las nuestras debe activarse». Ambos conjuntos de ejemplos deben incluirse en la integración continua (CI); ninguno de los dos puede faltar.
Actividades que se pueden realizar esta noche:Mostrar todas las habilidades del repositorio nombre En la primera frase de la descripción, señala los pares que sospechas que se solapan; si hay más de dos pares, trata primero el par que presente mayor solapamiento.
Guía práctica paso a paso: descomposición y composición, descripción de la mutualidad, tabla de arbitraje, ejemplos de conflictos

- ¿Cuándo se va a desmantelar?:Los límites de los permisos son diferentes (FAQ de solo lectura frente a tickets en los que se puede escribir); el coste de un error es diferente (consultar la documentación frente a enviar un correo electrónico); y el corpus de activación apenas tiene puntos en común. Una vez desglosados, cada uno es independiente.
evals/. - ¿Cuándo se une?:Del mismo ámbito, con gran cantidad de elementos en común
referencia/; tras separarlos, se produjeron activaciones erróneas entre ellos en más del 20 % de las muestras; en la mente del usuario, se trata de «una única capacidad del asistente». Antes de combinarlos, hay que fusionar primero los conjuntos de pruebas y luego eliminar los directorios. - Descripción de la mutex:Cada Skill debe incluir entre 1 y 2 frases de límites negativos. Por ejemplo, la Skill «FAQ» debe indicar: «No se crean ni se modifican tickets; para ello, utilice la Skill “ticket-ops”»; y la Skill «ticket-ops» debe indicar: «No se responden preguntas sobre el texto original de las políticas de producto; para ello, utilice la Skill “shop-faq”». Tanto las frases de capacidades positivas como las de límites negativos deben poder detectarse en las pruebas de evaluación.
- Rellenar el formulario de arbitraje:Partiendo de la tabla HTML del texto anterior, modificadla con los nombres de las habilidades de vuestro negocio y luego insertadla en
skills/ARBITRATION.md(El nombre del archivo se puede personalizar); al modificar la descripción de una PR, es imprescindible indicar si afecta a la prioridad. - Añadir ejemplos de conflictos:Por cada par de habilidades superpuestas, al menos 5 expresiones de «doble candidato», se espera que sean únicas.
expect_skill. Ejecuta el script de la lección 6; solo se permite la combinación cuando ambas luces estén en verde.
| Tipos de conflicto | Arbitraje por defecto | Expectativas de la reseña |
|---|---|---|
| Operaciones de seguridad/escritura en disco frente a consultas de solo lectura | Se da prioridad a la lectura; para escribir en el disco es necesario especificar explícitamente la ubicación o realizar una segunda confirmación. | No se puede activar la habilidad «Escribir en disco» si no se ha seleccionado a nadie. |
| Superposición semántica entre las dos lecturas de «Skill» | Según la prioridad de las operaciones de la tabla de arbitraje; de lo contrario, se solicita al usuario que seleccione | Se espera que la habilidad sea única; no se permiten dos «verdaderos». |
| El usuario ha mencionado a skill | Se da prioridad a la lista de asistencia, salvo que el sistema de control de acceso lo deniegue. | Frase de presentación: expect_skill=persona que presenta |
| Empate y sin tarjetas. | Aclarar las preguntas y no aplicar medidas sin autorización que puedan tener efectos secundarios | expect_trigger=false o expect_skill está vacío y se registra en el diario |
# Ejemplo de evals/conflict_pairs.jsonl
{"id":"C-01","utterance":"¿Dónde figura el plazo de devolución? Y, de paso, ábreme un ticket de seguimiento","expect_trigger":true,"expect_skill":"shop-faq","notes":"Responde primero sobre la política; Para crear el ticket hay que especificar "ticket-ops""}
{"id":"C-02","utterance":"Crea un ticket de seguimiento para el pedido 123 con ticket-ops","expect_trigger":true,"expect_skill":"ticket-ops","notes":"El usuario ha mencionado a alguien"}
{"id":"C-03","utterance":"Ayúdame a tramitar una devolución","expect_trigger":false,"expect_skill":"","notes":"Empate: hay que aclarar si se trata de una consulta sobre la política o de la creación de un ticket"}
Añade una pregunta más a la plantilla de PR: ¿Se han actualizado la tabla de arbitraje y el ID del ejemplo de conflicto? No se permite solicitar la fusión si se deja en blanco. Los comandos locales deben coincidir con los de CI.
¿Cómo se debe escribir una frase de exclusión mutua para que sea válida? Debe poder ser detectada por el sistema de evaluación. No basta con escribir simplemente «Selecciona con cuidado». Debe describirse como un comportamiento observable, por ejemplo: «Si el usuario solicita crear o modificar un ticket, esta Skill no lo procesará». A continuación, se debe utilizar una frase de conflicto para verificar que «ticket-ops» sea el resultado esperado.
A la hora de decidir sobre la fusión o separación de módulos, convoco a las partes implicadas a una reunión de quince minutos: el responsable de seguridad tiene derecho de veto sobre la fusión de módulos; el responsable de operaciones tiene derecho de veto sobre cualquier separación que carezca de sentido. Las actas de la reunión se publican en tres líneas en PR, para evitar que después se diga: «Pensaba que habíais aceptado la separación».
Los ejemplos de conflictos deben proceder de frases reales de usuarios; se permite una ligera adaptación para proteger la privacidad, pero no se admiten creaciones literarias. Las frases literarias evalúan tu imaginación, no los desencadenantes.
Actividades que se pueden realizar esta noche:Selecciona el par de habilidades con mayor solapamiento, escribe tres ejemplos de conflicto y haz que al menos uno de ellos dé «rojo»; a continuación, corrígelo con sentencias mutuamente excluyentes o una tabla de arbitraje hasta que dé «verde», para confirmar que el sistema de control de acceso realmente tiene en cuenta los conjuntos de conflicto.
La tabla de ejemplos de arbitraje es un punto de partida; adaptadla a vuestro negocio: sustituid «shop-faq» y «ticket-ops» por los nombres reales de las habilidades. Si la indicación de la tabla «es necesario especificar el disco» entra en conflicto con la función del producto «realizar el pedido en una sola frase», el gestor de producto debe firmar para modificar las expectativas, en lugar de dejar que el modelo lo adivine.
Errores y contratiempos (al menos tres)
- descripción: Indicar únicamente las capacidades positivas:Dos habilidades compiten por la misma frase utilizando sinónimos. Solución: imponer una frase límite negativa; la evaluación de conflictos da prioridad a los sinónimos.
- El acuerdo de arbitraje se estableció únicamente de forma verbal en el chat:Los nuevos empleados no tienen ninguna referencia a la hora de incorporar la tercera habilidad. Solución: registrarla en el almacén; comprobar que el documento de CI existe.
- Ejemplo de conflicto: «A o B»:Las pruebas siempre dan un resultado «falso verde». Solución: la expectativa debe ser única; en caso de empate, utilizar `expect_trigger=false`.
- He fusionado las habilidades, pero se me ha olvidado fusionar las evaluaciones:El ID antiguo ha caducado. Procedimiento: la solicitud de incorporación de cambios (PR) debe incluir una lista de evaluación de la migración.
- La habilidad «Escribir en el disco» se activa incluso en caso de empate:La prioridad de seguridad no se ha incluido en el hook. Solución: bloqueo estricto en la capa del hook; en la evaluación, se añade un fallo automático por «no se permite escribir en el disco sin autorización».
Actividades que se pueden realizar esta noche:Voy a incluir a propósito una frase genérica del tipo «Ayúdame a gestionar la devolución» para ver si la red actual o el «correr en seco» activan la habilidad de «escribir en el disco»; si es así, primero añadiré un bloqueo y luego modificaré el texto.
Existe otro tipo de error silencioso: cuando dos habilidades de solo lectura coinciden al mismo tiempo, el asistente genera una respuesta mixta y el usuario cree que procede de una política oficial, cuando en realidad la mitad proviene de una referencia caducada. La configuración predeterminada de la tabla de arbitraje para este caso debería ser «una única fuente», en lugar de «un poco de cada una». En las evaluaciones, se debe esperar un nombre de habilidad único para este tipo de frases.
Si vuestro entorno de ejecución no puede leer temporalmente el archivo de la tabla de arbitraje, al menos incluid la prioridad en las sentencias de exclusión mutua de la descripción de cada Skill y codificad de forma rígida una lista negra para la clase de escritura en disco en los hooks. El arbitraje basado en archivos es el objetivo; el bloqueo rígido es el mínimo indispensable. Si no se cumple este mínimo, no se debe implementar la tercera Skill.
Ejercicios
- Elabora una lista de las habilidades del almacén, señala al menos un par de habilidades que se solapen y decide si hay que separarlas o fusionarlas (escribe 5 líneas explicando los motivos).
- Añade sentencias de exclusión mutua a ambas partes y envía el diff de la descripción.
- Insertar en la tabla de arbitraje + al menos 5 entradas
pares_en_conflictoEjemplo: se ejecuta hastaSKILL_EVAL_OK. - Añado una entrada sobre «menciones de usuarios» y otra sobre «empates que deben aclararse» a partir de los registros reales.
Criterios de finalización: solo lo ven los compañeros de trabajo skills/README Con la tabla de arbitraje, se puede saber quién gana en caso de conflicto, sin necesidad de enviarte un mensaje privado.
Una vez finalizados los ejercicios, comprueba si el CI de la lección 6 (conjunto de conflictos) se ha incluido en el mismo trabajo. Si aún tienes que ejecutar manualmente un segundo script, significa que la narrativa del control de acceso sigue fragmentada; primero fusiona los comandos y, a continuación, da por finalizada la lección 7.
Avance de la próxima lección
第 8 课预告:把多 Skill 仲裁与生产 trace/反馈打通——如何从「双候选」日志一键生成冲突样例、如何给写盘类 Skill 加观察期。本课先把离线拆合与仲裁表跑稳;没有冲突红灯,线上编排只会互相抢话。
在第 8 课到来之前,你可以先手工做最小闭环:每周五从日志里抄 3 条疑似双候选,写成 conflict 样例,周一跑回归。闭环丑陋但有效;等自动化来了再替换手工抄写,不要空等。
也请同步提醒安全同事:多 Skill 编排会改变攻击面——诱骗模型点名写盘 Skill 的句子,应进入冲突与安全样例,而不是只出现在红队聊天里。编排表与安全表可以交叉引用同一 id。
Í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
- 第 7 课:多 Skill 编排:拆合边界与触发冲突仲裁(本文)


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