polyphony

Descripción general de la skill polyphony

polyphony es una skill de orquestación multiagente para ejecutar trabajos en paralelo en espacios de trabajo aislados por contenedores. Cada sesión obtiene su propio contenedor Docker y su propia rama de git, lo que la hace útil cuando necesitas ejecución concurrente sin colisiones de ramas, errores por estado compartido ni limpieza desordenada.

Para qué sirve polyphony

Usa la skill polyphony cuando el trabajo sea más grande que un único prompt, pero siga beneficiándose de una delegación estructurada: desarrollo paralelo de funcionalidades, validación aislada, triage de incidencias o ejecución de varias rutas de agentes sobre la misma base de código. Está pensada para usuarios que valoran una ejecución limpia, un enrutamiento de tareas reproducible y una coordinación multiagente más segura.

Qué la hace destacar

El principal diferenciador de polyphony es un diseño de flujo de trabajo centrado primero en el aislamiento. En lugar de pedirle a un agente que “haga de todo”, separa el descubrimiento de tareas, el enrutamiento, la provisión, la ejecución y la verificación para que cada trabajador opere en un espacio controlado. Eso hace que el enfoque de polyphony para Multi-Agent Systems sea más práctico cuando necesitas pruebas independientes y un comportamiento de integración más limpio.

Mejor encaje y compensaciones

polyphony encaja mejor si tu entorno ya admite Docker u OrbStack y quieres una orquestación activada por defecto, en lugar de un patrón de prompt de una sola vez. Es menos útil si solo necesitas una respuesta de chat, no puedes ejecutar contenedores o buscas una configuración mínima sin un flujo de trabajo consciente del repositorio.

Cómo usar la skill polyphony

Instala y carga polyphony

Instala la skill polyphony en tu directorio de skills y después úsala desde el flujo de trabajo anfitrión que admita la carga de skills. El repositorio indica que está pensada para cargarse automáticamente cuando existe aislamiento por contenedores, y que es la opción predeterminada para /spawn-team. Si tu configuración es distinta, verifica que haya acceso a Docker, creación de ramas y montajes del workspace antes de depender de la skill.

Empieza por los archivos correctos

Para usar polyphony, comienza con skills/polyphony/SKILL.md y luego lee el contexto enlazado o mencionado en el mismo orden en que la skill lo usa internamente: ciclo de vida de tareas, arquitectura, requisitos previos, configuración y cualquier referencia específica del repositorio incrustada en el archivo. Como este repo no tiene scripts auxiliares ni carpetas extra de referencia, el comportamiento central vive en el propio archivo de la skill, así que leerlo con atención importa.

Convierte un objetivo difuso en un prompt utilizable

Un buen prompt para polyphony debería incluir: el repo objetivo, el número de agentes en paralelo que quieres, el tipo de trabajo que debe asumir cada agente, la expectativa sobre rama o PR y cualquier restricción sobre pruebas, credenciales o limpieza. Por ejemplo, en vez de “arregla este proyecto”, pide “divide la incidencia en tres tareas aisladas de agente: reproducir, parchear y verificar, usando espacios de trabajo Docker separados e informando el estado de integración por rama”.

Qué especificar para obtener mejores resultados

Dale a la skill señales de enrutamiento concretas: prioridad de la tarea, dependencias, si el trabajo debe empezar en modo solo lectura, qué entornos es seguro aprovisionar y qué cuenta como verificación. Eso ayuda al orquestador a elegir mejores RunSpecs y reduce arranques de contenedores innecesarios. Para una guía de polyphony, la entrada más útil no es más texto; son límites de tarea más claros.

Preguntas frecuentes sobre la skill polyphony

¿polyphony es solo para configuraciones con Docker?

Sí, en la práctica. La skill polyphony asume que el aislamiento por contenedores está disponible, así que el soporte de Docker u OrbStack es la principal puerta de entrada. Si no puedes aprovisionar contenedores, el flujo de trabajo pierde la mayor parte de su valor.

¿polyphony es diferente de un prompt normal?

Sí. Un prompt normal le pide a un agente que actúe; polyphony define cómo se reclaman, enrutan, aprovisionan, verifican e integran varias ejecuciones de agentes. Esa estructura es precisamente el punto de la skill polyphony, sobre todo cuando las ramas independientes y una ejecución limpia importan más que la velocidad por sí sola.

¿Pueden usar polyphony los principiantes?

Sí, si ya pueden ejecutar contenedores y leer un archivo de skill. La principal curva de aprendizaje no está en escribir prompts, sino en entender que polyphony espera descomposición de tareas y que el entorno esté listo. Los principiantes suelen obtener mejores resultados cuando empiezan con una sola tarea pequeña y un objetivo de verificación claro.

¿Cuándo no debería usar polyphony?

No uses polyphony para preguntas rápidas de una sola vez, ediciones ligeras o entornos sin Docker. Tampoco es una buena opción cuando la tarea es ambigua y todavía no has definido qué debe asumir cada agente, porque la sobrecarga de orquestación puede superar el beneficio.

Cómo mejorar la skill polyphony

Dale al enrutador límites de tarea más claros

La mayor mejora de calidad en polyphony viene de una descomposición de tareas más precisa. Indica qué trabajo es exploratorio, qué trabajo modifica código y qué trabajo solo verifica. Si quieres paralelismo, define la división explícitamente en lugar de pedirle al sistema que la infiera a partir de un objetivo vago.

Incluye restricciones que afectan el comportamiento del workspace

Menciona reglas de nombres de ramas, límites de red, expectativas de duración de las pruebas y si se requieren secretos o identidades montadas. Como polyphony usa contenedores aislados y ramas independientes, estas restricciones afectan directamente al aprovisionamiento y a si la ejecución puede completarse sin intervención manual.

Pide verificación, no solo implementación

Un fallo frecuente es quedarse en “el código cambió”. Un mejor uso de polyphony pide pasos de reproducción, comandos de prueba y criterios de integración para cada ruta de agente. Esto es especialmente importante cuando varios trabajadores pueden converger en soluciones distintas y necesitas una decisión de merge fiable.

Itera después de la primera ejecución

Si la primera salida es demasiado amplia, acota la tarea y vuelve a ejecutarla con un único criterio de éxito. Si el resultado está demasiado fragmentado, reduce el número de agentes en paralelo y añade dependencias más fuertes entre etapas. En polyphony, la mejora suele venir de entradas de orquestación más precisas, no de prompts más largos.