Todo trabajo en AITM comienza como un Task. Esta página cubre cada campo del diálogo New Task y cómo redactar prompts que den un buen resultado a la primera.

Crear un Task

El diálogo New Task

Se selecciona un proyecto y se pulsa + New Task (o + Task en la tarjeta de un proyecto). El diálogo tiene tres pestañas — Task (el propio formulario), AI Models y Translate — y un botón Save. Una vez guardado, el Task aparece como tarjeta en la cola con el estado pending y arranca automáticamente en cuanto hay una ranura libre. Ctrl+Enter también guarda el Task.

Diálogo New Task, pestaña Task
El diálogo New Task — pestaña Task con título, prompt, modo de ejecución, prioridad, intención y los interruptores.

Pestaña Task

  • Title — un nombre corto para el Task. Obligatorio. Es lo que se verá en listas y notificaciones, por lo que conviene que sea específico.
  • Prompt — lo que la IA debe hacer. Obligatorio. Se describe el objetivo, las restricciones y cómo se ve "terminado". Encima se encuentran el botón Optimize y un selector de idioma de escritura (Auto por defecto) con una insignia que muestra el idioma en uso.
  • Solution y Project — la pestaña (solution) y el proyecto al que pertenece el cambio. Ambos son obligatorios en un Task nuevo.
  • Execution Mode — Pipeline (el Pipeline completo paso a paso) o Agent (un Agent autónomo). En modo Agent aparece un Agent Test Gate con dos casillas: Run unit tests y Run E2E tests.
  • Skill — junto al conmutador de modo hay dos botones pequeños para el uso automático o manual de Skills; en modo automático las Skills se seleccionan a partir del texto del prompt. La lista Skill (optional) permite elegir una Skill que se incluye siempre.
  • Priority — Low, Medium (predeterminada) o High. Los Tasks de mayor prioridad se toman primero de la cola.
  • Intent — Bug, Feature, Enhancement u Other. Obligatorio; Save rechaza el formulario sin él.
  • Use Worktree, Use Pipeline, Auto-merge → dev — conviene dejarlos activados salvo que se sepa por qué no. El Worktree aísla el Task del resto del trabajo en curso; Auto-merge fusiona automáticamente la rama terminada en dev.
  • Lite mode — omite el paso de planificación Architect cuando el modelo de código es lo bastante potente para planificar por sí mismo; con modelos más débiles se usa de todos modos el Pipeline completo.
  • Pipeline Steps — interruptores por Task para Architect, Review + Fix, Unit Tests y E2E Tests. Docs está bloqueado como activado y no puede omitirse.
  • Dependencies — otros Tasks que deben estar terminados antes de que este comience.

Pestaña AI Models

Aquí se puede sustituir el proveedor y el modelo de cada paso de IA (architect, code, compliance-check, review, fix, test, e2e, docs) para este único Task, junto con sus límites de turnos y de tiempo de ejecución. Compliance-check omite los Tasks más simples. Lo que se deje vacío se hereda de los ajustes del proyecto o globales. Apply provider to all steps rellena toda la columna de una vez.

Diálogo New Task, pestaña AI Models
La pestaña AI Models — proveedor, modelo y límites por paso para este único Task.

Pestaña Translate

Muestra la traducción del prompt, que puede editarse.

Optimize — mejorar el prompt

Optimize pide a una IA que reescriba un prompt tosco en uno preciso. Después se puede alternar entre Original prompt y Optimized prompt, abrir Changes para ver qué se alteró, y el original permanece visible bajo el formulario como Original prompt (before optimization). La ventana de detalle del Task muestra más tarde ambas versiones, el original encima del optimizado.

Detalle del Task con el prompt original y el optimizado
Detalle del Task: el prompt original sobre el optimizado.

Editar un Task

El icono Edit (lápiz) de la tarjeta de un Task — disponible mientras el Task no se está ejecutando — abre el mismo diálogo, titulado Edit Task, relleno con los valores actuales del Task. Se cambia lo necesario y se pulsa Save.

Edición de un Task existente
El diálogo Edit Task relleno con los valores de un Task existente.

Cadenas de Tasks dependientes

Si el trabajo de un Task debe realizarse antes de que otro pueda comenzar (por ejemplo, "añadir la columna a la base de datos" antes de "usar la columna en la API"), el primer Task se indica en Dependencies. El Task dependiente espera a que su predecesor se haya fusionado en dev antes de empezar, de modo que siempre parte de una base de código que ya contiene el cambio anterior.

Atajos al escribir (IntelliSense)

El cuadro del prompt (y los cuadros de mensaje de Chat y Brainstorm) ofrece autocompletado al escribir alguno de estos caracteres:

EscribirPara insertar
@keyworduna palabra clave
@@keyworduna palabra clave con todo su contenido
#taskuna referencia a otro Task
##buguna referencia a un error
$skilluna Skill
_variableun código de variable — el nombre exacto de una parte de la aplicación
~hintuna entrada del Hint Dictionary

Al empezar a escribir el carácter de activación aparece un desplegable con sugerencias coincidentes — se elige una para insertarla en el prompt.

Desplegable de IntelliSense
El desplegable de IntelliSense sugiriendo coincidencias al escribir un carácter de activación.
Vista de página completa de IntelliSense
Vista de página completa de las sugerencias de IntelliSense abiertas en el editor del prompt.
Botón de insertar variable en el diálogo New Task
El botón Var del diálogo New Task para insertar una referencia a una variable sin escribirla.

Consejos

  • Conviene usar referencias _variable en lugar de describir ubicaciones de código en prosa — es más rápido y no deja ambigüedad para la IA.
  • Cuando un cambio se divide de forma natural en pasos ordenados, es preferible dividirlo en Tasks dependientes en lugar de escribir un único prompt gigantesco.
  • No hay que olvidar el Intent — el Task no se guarda sin él.
  • Un Task failed conserva toda su salida de consola y el motivo del fallo; conviene leerlo, ajustar el prompt y volver a intentarlo.