add-task

Descripción general de add-task skill

Qué hace add-task

El skill add-task crea un archivo de tarea borrador en .specs/tasks/draft/ a partir de la solicitud original de un usuario. Es útil cuando quieres un artefacto de tarea consistente antes de planificar o implementar, no solo una nota libre. Eso convierte al add-task skill en una buena opción para flujos de trabajo de Project Management en los que las tareas deben registrarse con un título claro, tipo, dependencias e intención preservada.

Quién debería instalarlo

Instala add-task si tu equipo usa seguimiento de tareas basado en especificaciones, separa el borrador de la ejecución o quiere que los agentes conviertan solicitudes desordenadas en archivos de tarea estructurados. Aporta más valor cuando la entrada de tareas importa: operaciones de producto, líderes de ingeniería, flujos de trabajo de PM asistidos por IA y mantenedores de repositorios que necesitan un proceso repetible de borrador a tarea pendiente.

Por qué destaca

El valor principal de add-task es su estructura. Hace más que resumir una solicitud: ayuda a clasificar la tarea, identificar archivos de dependencia y colocar el resultado en el directorio correcto. Eso reduce las dudas frente a un prompt genérico que puede olvidar convenciones de nombres, tipo de tarea o estructura de carpetas.

Cómo usar add-task skill

Instalar y activar add-task

Usa el skill en el contexto del conjunto de plugins NeoLabHQ/context-engineering-kit y luego indícale al agente la solicitud de tarea que quieres convertir en borrador. El flujo de instalación que aparece en el repositorio es:

npx skills add NeoLabHQ/context-engineering-kit --skill add-task

Después de instalarlo, el agente debería recibir el título o la descripción de la tarea del usuario, además de cualquier archivo de tarea dependiente. El paso add-task install importa porque el skill espera rutas y estructura de carpetas conocidas por el repositorio, incluida .specs/tasks/draft/.

Escribe una entrada que el skill pueda interpretar

El mejor add-task usage es una solicitud breve pero específica. Incluye el resultado esperado, el alcance y cualquier dependencia conocida. Un buen input se parece a esto:

• Add validation to form inputs
• Create login rate limiting; depends on auth cleanup task
• Refactor task creation flow for mobile users

Un input débil es vago y obliga al modelo a adivinar:

• Improve app
• Fix stuff
• Make tasks better

Si la solicitud tiene un tipo implícito, indícalo. Si no, deja que el skill lo infiera a partir de los verbos y el alcance.

Lee primero los archivos correctos

Empieza con SKILL.md, porque define el rol, el objetivo, la entrada y las instrucciones. Después revisa cualquier archivo del repositorio que controle nombres de tareas, flujo de trabajo o convenciones. En esta vista previa del repositorio, SKILL.md es la fuente principal; no hay carpetas de apoyo como rules/ o references/, así que el principal riesgo es perder convenciones locales de tu propio entorno, no documentación faltante aquí.

Flujo de trabajo que produce mejores borradores

Usa add-task cuando el objetivo sea convertir una solicitud imprecisa en un borrador que luego pueda pasar a la lista de tareas o a la implementación. Primero, proporciona la intención exacta de la tarea y sus dependencias. Después, deja que el skill cree el archivo borrador en la carpeta esperada. Por último, revisa el resultado para comprobar la claridad del título, la precisión de las dependencias y si la descripción conservó el significado del usuario sin sobreeditarlo.

Preguntas frecuentes sobre add-task skill

¿add-task es para Project Management o para programación?

Para ambos, pero su uso principal es Project Management para trabajo de ingeniería. Crea un artefacto de tarea que puede alimentar la planificación y la implementación. Si solo necesitas un recordatorio rápido, un prompt normal es más simple.

¿Necesito conocer antes la estructura del repositorio?

No, pero sí conviene saber si tu proyecto usa .specs/tasks/ o una convención parecida. Si tu repositorio tiene otras carpetas para tareas, adapta la ruta de salida antes de depender del comportamiento predeterminado de add-task.

¿Cuándo no debería usar add-task?

No lo uses cuando ya tengas un ticket de implementación completamente especificado, cuando la tarea deba ir directamente a código o cuando tu repositorio no use archivos de tarea borrador en absoluto. En esos casos, un prompt directo u otro flujo puede ser más rápido.

¿Es un skill apto para principiantes?

Sí, si puedes describir una tarea en una sola frase y entiendes lo básico sobre nombrar dependencias. La principal curva de aprendizaje no está en el paso de IA, sino en saber qué espera tu equipo dentro del archivo borrador.

Cómo mejorar add-task skill

Dale al skill menos huecos que rellenar

La mayor mejora de calidad viene de una mejor entrada de origen. Incluye la acción, el área objetivo y cualquier bloqueo. Por ejemplo, Add password reset email retry handling; depends on email queue stability task es mucho mejor que Improve reset flow. Esto ayuda a add-task a preservar la intención y asignar correctamente las dependencias.

Revisa título, tipo y dependencias

La mayoría de las salidas débiles se debe a tres problemas: títulos demasiado amplios, etiquetas de tipo demasiado genéricas y enlaces de dependencia ausentes. Revisa eso primero. Si el título no es verbo + objeto específico, reescríbelo. Si el tipo es dudoso, añade una frase aclaratoria antes de volver a ejecutar el add-task skill.

Itera refinando el prompt, no el archivo

Si el primer borrador no encaja, mejora la entrada en lugar de parchearlo todo manualmente. Indícale al agente qué debe conservar, qué debe reclasificar y de qué archivos debe depender. Este es el patrón más rápido de add-task guide para conseguir un borrador listo para la planificación posterior.