CommunityRedacción y edicióngithub.com

dudashuai616/project-task-router

Enrutamiento por complejidad de tareas, planificación de fases y transferencias compactas para Codex y agentes de IA.

¿Qué es project-task-router?

Esta skill define un protocolo para que agentes de IA como Claude Code, Cursor o Codex enruten tareas de desarrollo de software según su complejidad, evitando la sobreingeniería y la pérdida de contexto. Primero clasifica la tarea en simple, multi-paso enfocada, multi-etapa o de larga duración usando criterios observables en lugar de estimaciones imprecisas. Luego decide los límites de conversación: mantiene trabajo acoplado en la misma sesión y sugiere nuevas conversaciones solo cuando reduce carga de contexto, retrabajo o ambigüedad. Para trabajo complejo, presenta una tarjeta de enrutamiento compacta con objetivo, fases, entradas, salidas y criterios de finalización. Antes de cambiar de conversación o pausar, crea una transferencia compacta (handoff) que reemplaza transcripciones largas con archivos formales y un breve resumen de estado, decisiones y siguiente acción. La skill también preserva una cadena de fuente de verdad mediante archivos de proyecto, evita duplicaciones y propone la estructura mínima necesaria para cada tarea.

Compatible con~Claude Code✓Codex CLI~Cursor
npx skills add dudashuai616/project-task-router

Installed? Explore more Redacción y edición skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Enrutador de Tareas de Proyecto

Enruta el trabajo hacia la estructura fiable más pequeña antes de producir resultados grandes. Preserva la continuidad mediante archivos de proyecto y transferencias compactas en lugar de transcripciones de chat antiguas.

Ejecuta la puerta de complejidad

Clasifica la tarea con la menor ceremonia necesaria:

  • Simple: Un resultado claro, poco riesgo de dependencia y ninguna necesidad de transferencia duradera. Ejecuta directamente sin mostrar un plan.
  • Multi-paso enfocado: Un entregable principal con algunos pasos relacionados. Da un plan breve de 2 a 5 pasos y continúa en la misma conversación.
  • Multi-etapa: Varios entregables distintos, diferentes conjuntos de referencia o dependencias claras aguas arriba/aguas abajo. Propón fases y límites de conversación antes de producir el cuerpo completo del trabajo.
  • De larga duración: Es probable que el trabajo abarque sesiones, acumule muchas decisiones o supere el contexto conversacional fiable. Establece fuentes de verdad, estado de las fases y un método de transferencia antes de la ejecución.

Utiliza evidencia observable en lugar de pretender conocer un porcentaje exacto de contexto restante. Las señales de advertencia incluyen revisiones repetidas, muchos archivos o artefactos, dificultad para verificar restricciones tempranas, turnos anteriores resumidos y una transición de fase que cambia el conjunto de referencia requerido.

Decide los límites de conversación

Mantén el trabajo en la misma conversación cuando esté fuertemente acoplado, itere sobre el mismo artefacto o pueda finalizar de manera confiable con el mismo conjunto de contexto pequeño.

Recomienda una nueva conversación cuando al menos una de estas condiciones sea cierta:

  • la fase actual produce un artefacto estable consumido por una fase diferente;
  • la siguiente fase necesita archivos o experiencia sustancialmente diferentes;
  • la revisión independiente de un entregable es valiosa;
  • continuar arrastraría grandes cantidades de exploración descartada, registros o borradores rechazados;
  • una transferencia compacta basada en archivos puede reemplazar la transcripción de manera segura.

No dividas mecánicamente. Una nueva conversación está justificada solo cuando reduce la carga de contexto, el retrabajo o la ambigüedad. Recomienda conversaciones separadas y proporciona indicaciones de inicio, pero no crees ni bifurques tareas propiedad del usuario a menos que el usuario lo solicite explícitamente.

Presenta la tarjeta de enrutamiento

Para trabajo multi-etapa o de larga duración, pausa la ejecución masiva y presenta una tarjeta de enrutamiento concisa que contenga:

  1. Objetivo general — una oración.
  2. Fases recomendadas — ordenadas por dependencia.
  3. Límite de conversación — misma o nueva conversación para cada fase, con una línea de razonamiento.
  4. Entradas — archivos aguas arriba exactos o decisiones confirmadas para leer; evita escaneos amplios del proyecto.
  5. Salidas — entregables nombrados y su ubicación adecuada en el proyecto.
  6. Terminado cuando — criterios observables de finalización.
  7. Actualización de transferencia — qué archivo de estado, decisión o fuente de verdad debe actualizarse.

Si la descomposición cambia materialmente el alcance o la secuencia, obtén el acuerdo del usuario antes de ejecutar fases posteriores. Cuando la primera fase ya esté claramente autorizada, comienza solo esa fase después de presentar la estructura.

Preserva una cadena de fuente de verdad

Trata el chat como espacio de trabajo, no como archivo autoritativo.

  • Sigue los AGENTS.md aplicables y la organización existente del proyecto.
  • Lee solo los archivos exactos necesarios para la fase actual.
  • Almacena los resultados aceptados en archivos claramente nombrados dentro del proyecto real del contenido.
  • Coloca cada hecho duradero en una ubicación autoritativa; refiérelo en otros lugares en lugar de duplicarlo.
  • Registra solo las decisiones que afectan el trabajo posterior. No preserves razonamientos ocultos, borradores descartados o resúmenes verbosos de transcripciones.
  • Cuando una decisión aguas arriba cambie, identifica los entregables aguas abajo que requieran revisión y márcalos claramente en el estado del proyecto.

Prefiere un archivo de estado o decisiones existente del proyecto. Si no existe y se requiere un trabajo significativo entre sesiones, propón el conjunto de archivos más pequeño útil en lugar de crear un índice para cada proyecto.

Crea una transferencia compacta

Antes de cambiar de conversación, pausar trabajo no finalizado o continuar después de que la fiabilidad del contexto decline, actualiza primero los artefactos formales y luego prepara una transferencia compacta con:

  • tarea y fase actual;
  • trabajo completado y aceptado;
  • decisiones bloqueadas;
  • rutas y versiones de archivos autoritativos;
  • trabajo no finalizado y bloqueadores;
  • siguiente acción inmediata;
  • archivos exactos que la siguiente conversación debe leer;
  • una indicación de inicio lista para usar para la siguiente conversación.

Mantén la transferencia lo suficientemente corta para escanearla rápidamente. La siguiente conversación debe reanudarse desde los archivos formales y la transferencia, no reconstruir la transcripción anterior.

Patrón de indicación de inicio

Usa esta estructura al recomendar una nueva conversación:

Continúa [proyecto], fase: [nombre de la fase].

Lee y sigue:
1. [AGENTS.md aplicable]
2. [fuente de verdad del proyecto]
3. [estado actual o transferencia]
4. [artefacto aguas arriba exacto o sección relevante]

No leas: [chats, carpetas o borradores irrelevantes].

Objetivo: [objetivo de la fase única].
Salida: [entregable nombrado y ubicación].
Terminado cuando: [criterios observables].
Después de completar: [actualizaciones de estado/decisión/transferencia].

Mantén la sobrecarga proporcional

  • No anuncies un flujo de trabajo complejo para una solicitud simple.
  • No crees archivos de planificación que no tengan un consumidor futuro.
  • No releas proyectos enteros cuando se conocen las fuentes exactas.
  • No continúes produciendo activos de etapas posteriores antes de que las decisiones aguas arriba requeridas sean estables.
  • No uses subagentes o agentes paralelos a menos que el usuario solicite explícitamente la delegación o las instrucciones aplicables lo requieran.

Cuando esta skill cambie materialmente la ejecución, informa brevemente al usuario que la tarea se está dividiendo o transfiriendo y por qué.

Skills relacionados