Lección 8: Incorporación del patrón Task/subagente en una Skill: límites de paralelismo y aislamiento del contexto
Objetivo de esta lección: Sabrás... Tarea / Subagente (subagent) Establece el procedimiento en las normas de la Skill —qué pasos se pueden realizar en paralelo, cómo se aísla el contexto y cómo se combinan los resultados— en lugar de decir verbalmente en el chat «abrir varias subtareas». En la lección anterior ya has realizado varias operaciones de división y fusión de Skills, así como la resolución de conflictos:https://school.myshirtai.com/?p=4191. Esta lección, que va más allá del arbitraje, abordaDentro de una habilidad individualParalelismo y aislamiento de contexto, integrados en los puntos clave de la orquestación de Claude Code Task/subagent. No se trata de escribir otra reflexión sobre «la importancia de tener en cuenta la concurrencia», sino de la tabla de límites, la lista de aislamiento y los ejemplos de fallos que podré enviar esta noche.
Introducción
Por favor, completa primero la lección 7, «Programación de múltiples habilidades: desglose y combinación de límites y arbitraje de conflictos de activación»:https://school.myshirtai.com/?p=4191. Debes tener a mano, como mínimo: la habilidad objetivo que se va a cargar, los puntos de referencia para la evaluación de las lecciones 6 y 7, y la tabla de arbitraje. 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; Lección 6 https://school.myshirtai.com/?p=4048.
Lista de requisitos: tener permisos de escritura o poder enviar PR; poder utilizar Skill en referencia/ O bien, añadir una sección titulada «Límites del paralelismo» en el archivo README; en las pruebas se pueden incluir ejemplos de «interferencia entre subtareas». A falta de registros reales de fallos de paralelismo, utilice un ejemplo simulado en el que «dos subtareas escriban en el mismo archivo»; no invente historias para que todo quede bien.

Caja del tiempo: esta noche solo se concederán noventa minutosuno De acuerdo con las normas de Skill y Task/subagentes, no se debe llevar a cabo la paralelización de todo el almacén de la noche a la mañana.
Concepto: Antes de que una tarea o un subagente se incorpore a una habilidad, se definen primero los límites de paralelismo.

La lección 7 garantiza que se pueda arbitrar en caso de que se activen varias habilidades al mismo tiempo. La lección 8 añade lo siguiente:Aunque se haya seleccionado una misma «Skill», es posible que internamente se abran a ciegas un montón de subagentes que compitan por el contexto, los archivos y el cupo de herramientas.. Respondamos primero a cuatro preguntas: ¿Qué pasos se pueden ejecutar en paralelo? ¿Qué rutas son de solo lectura por defecto para los subagentes? ¿Quién se encarga de fusionar los resultados? ¿Se cancela una tarea hermana en caso de fallo?
- La paralelización es una decisión relacionada con los costes:Hora del reloj de pared de la provincia frente a agotar el cupo/apoderarse del bloqueo; por defecto, se empieza con un nivel de paralelismo bajo.
- Aislamiento de contexto al escribir en Skill:Cada tarea debe incluir únicamente el resumen necesario; queda prohibido copiar íntegramente el mismo fragmento de conversación N veces.
- Lista de efectos secundarios:La escritura en disco, el envío a la red y la modificación del estado de uso compartido se realizan de forma serie o con bloqueo por defecto; solo la recuperación en modo de solo lectura se realiza en paralelo.
- Prueba de aceptación:Al menos tres ejemplos del tipo «los resultados tras la ejecución en paralelo deben ser coherentes/deben estar aislados».
Los productos del tipo Claude Code utilizan las tareas (Task) y los subagentes (subagent) como primitivas de orquestación; por su parte, Skill se encarga de plasmar «cuándo utilizarlas y cómo limitarlas» en convenciones que se pueden activar y someter a pruebas de regresión. Hasta aquí los conceptos; ahora pasemos directamente a la práctica.
Actividades que se pueden realizar esta noche:Abre el archivo SKILL.md de la habilidad en cuestión, señala los pasos que quieres que se ejecuten en paralelo y los pasos secundarios que deben ejecutarse en serie, y redacta un borrador en dos columnas.
Guía práctica paso a paso: declaración, contexto de aislamiento, límite de paralelismo, ganchos de aceptación

- Declarar una tabla de límites paralelos:existe
reference/parallel.md(El nombre del archivo se puede personalizar) Indica los pasos, si se pueden realizar en paralelo, el número máximo de procesos simultáneos y los recursos compartidos. Esta tabla debe revisarse obligatoriamente en la solicitud de pull. - Lista de aislamiento de contexto:Campos de entrada permitidos en cada subtarea (ruta de destino, resumen de solo lectura, campos prohibidos). Está prohibido incluir claves o el historial completo de una conversación en las subtareas.
- Acuerdo de fusión:Se especifica que el recopilador es la tarea principal; a quién se da prioridad en caso de conflicto en los campos; y si el fallo es de tipo «fail-fast».
- Gancho y reseña:Durante la ejecución, se imprime «Número de subtareas que se iniciarán»; la prueba verifica que no se supere el límite máximo y que los pasos de escritura en disco no se realicen en paralelo.
| Tipo de paso | Por defecto | Expectativas de la reseña |
|---|---|---|
| Búsqueda de solo lectura / Resumen | Se permite el procesamiento en paralelo, con un límite máximo de 3 | Número de subtareas ≤ límite máximo |
| Escribir en el mismo archivo / Modificar la configuración | En serie | No se permite la escritura simultánea en la misma ruta |
| Efectos secundarios de Internet | Colas en serie o explícitas | No se permite el envío simultáneo sin que se haya indicado el nombre. |
| Contexto implícito | Resumen mínimo | La entrada de la subtarea no incluye el campo de clave |
# Ejemplo de evals/subagent_isolation.jsonl
{"id":"S-01","utterance":"Resumir en paralelo los README de los tres módulos de la carpeta src/","expect_parallel":true,"max_workers":3,"expect_write":false}
{"id":"S-02","utterance":"Modificar simultáneamente dos claves del mismo archivo config.yaml","expect_parallel":false,"notes":"En caso de conflicto de escritura, se debe procesar en serie o rechazar la operación"}
{"id":"S-03","utterance":"Iniciar una subtarea, pero sin incluir el archivo .env","expect_leak":false,"forbidden_keys":["API_KEY","TOKEN"]}

Actividades que se pueden realizar esta noche:Ejecuta al menos una vez el ejemplo de tipo S-02 hasta que aparezca una luz roja y, a continuación, utilice la tabla de límites para que cambie a verde, con el fin de confirmar que el sistema de control de acceso respeta las reglas de paralelismo.
Errores y contratiempos (al menos tres)

- En la descripción de la habilidad solo se indica «permite crear subagentes», sin especificar ningún límite máximo:Se han superado los límites y se han agotado los bloqueos. Solución: aplicar «max_workers» y realizar una evaluación.
- Copiar el contexto completo de la subtarea:Interferencias y fugas de información. Solución: lista de aislamiento + ejemplo de «forbidden_keys».
- Los pasos de grabación en el disco se realizan en paralelo:Archivo dañado o carrera de acceso oculta. Solución: los efectos secundarios se ejecutan en serie por defecto; los ganchos se bloquean de forma estricta.
- Discrepancia con la tabla de arbitraje de la lección 7:Tras la selección de una habilidad principal, se activa internamente otra habilidad. Tratamiento: las tareas secundarias no pueden eludir la arbitraje; véase el ejemplo de conflicto en la referencia cruzada.
- Error silencioso al fusionar:Una subtarea sigue marcándose como «exitosa» aunque esté en rojo. Solución: «fail-fast» o estado «partial» explícito.
Actividades que se pueden realizar esta noche:Incluiré a propósito una frase que diga «modificar simultáneamente el mismo archivo de configuración» para ver si el programa escribe en paralelo; si es así, añadiré primero un bloqueo estricto.
Ejercicios
- Elige una habilidad y envía
reference/parallel.mdTabla de límites. - Añade al menos 3 subagentes de aislamiento/paralelismo y ejecuta los ejemplos hasta que aparezca el color verde.
- Añadir una frase a la descripción de SKILL.md: cuándo utilizar tareas/subagentes y cuándo no hacerlo.
- Un enlace cruzado con la tabla de arbitraje de la lección 7 (mismo ID de fallo o mismo anclaje de documento).
Criterios de superación: los compañeros solo consultan el archivo «parallel.md» y las pruebas, y son capaces de indicar cuál es la concurrencia máxima y si la escritura en disco puede realizarse en paralelo, sin necesidad de enviarte un mensaje privado.
Avance de la próxima lección
Avance de la próxima lección: Integrar los límites de paralelismo de las tareas y los subagentes con los trazas de producción: cómo generar ejemplos de aislamiento con un solo clic a partir de los registros de «interferencia entre subtareas» y cómo añadir un periodo de observación y un presupuesto de cuota a las habilidades de alta concurrencia. En esta lección, primero nos aseguraremos de que la tabla de límites offline y las pruebas de evaluación funcionen correctamente; si no hay señales de alerta de paralelismo, en producción solo se producirán interferencias silenciosas entre tareas.
Í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: Incorporación del patrón Task/subagente en una Skill: límites de paralelismo y aislamiento del contexto (este artículo)


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