Ingeniería de requisitos agéntica

• Break Down Complex Requirements – analizar los requisitos seleccionados y dividirlos en requisitos más pequeños e independientemente verificables, manteniendo la intención original.

  Ejemplo de indicación:

  Break down these requirements.

• Apply Requirement Writing Standards – revisar requisitos y reescribirlos de acuerdo con las directrices de su organización para la redacción de requisitos. Las comprobaciones típicas incluyen ambigüedad, lenguaje no verificable, actores faltantes y criterios de aceptación poco claros.

  Ejemplo de indicación:

  Rewrite these requirements according to our requirement quality standard.

• Translate Requirements – traducir requisitos de un idioma a otro conservando el significado técnico, la terminología, los ID y las referencias de trazabilidad.

  Ejemplo de indicación:

  Translate these requirements to German.

• Classify Requirements – aplicar a los requisitos un esquema de clasificación organizativo, como Electrónica, Mecánica, Software, Seguridad funcional, Ciberseguridad u otras taxonomías específicas de la empresa.

  Ejemplo de indicación:

  Classify these requirements according to our applicability model.

• Generate Verification Criteria – analizar requisitos y proponer métodos de verificación, criterios de aceptación o condiciones de prueba que puedan utilizarse para demostrar el cumplimiento siempre de la misma manera.

  Ejemplo de indicación:

  Generate verification criteria for these requirements.

• Summarize a Specification/Section/Group of Requirements – generar un resumen conciso y estructurado de una especificación, una sección de requisitos o un conjunto de requisitos.

  Ejemplo de indicación:

  Summarize the selected requirements.

Una buena habilidad ayuda a la IA a comprender dos cosas:

• Cuándo debe usarse la habilidad

• Qué debe hacer la IA cuando se ejecuta la habilidad

Al definir una habilidad, 

Esto se expresa mediante tres campos, cada uno con un propósito diferente:

• Name – le ayuda a reconocer la habilidad.

• Short Description – ayuda a la IA a decidir cuándo la habilidad es pertinente.

• Instructions – define el comportamiento que debe seguir la IA una vez que se selecciona la habilidad.

Consulte las secciones siguientes para ver detalles sobre cada campo.

Nombre

El Name debe ser breve, claro y orientado a la acción. Debe ayudarle a comprender rápidamente qué pretende hacer la habilidad. Un buen nombre suele describir la acción y el tipo de datos de ingeniería sobre los que trabaja la habilidad.

Un nombre de habilidad sólido debe ser:

• Lo bastante específico como para distinguir la habilidad de otras

• Lo bastante breve como para poder revisarlo fácilmente en la lista de habilidades

• Centrado en la tarea principal que realiza la habilidad

• Redactado en un lenguaje que los usuarios entiendan de forma natural

Evite nombres demasiado amplios o genéricos. Si el nombre podría aplicarse a muchas tareas diferentes, probablemente no sea lo bastante específico.

Descripción breve

La Short Description ayuda a la IA a entender de qué trata la habilidad y cuándo debe activarse. Este campo es importante porque no necesita seleccionar manualmente una habilidad. El asistente analiza su indicación, la compara con las habilidades disponibles y decide si una habilidad es pertinente.

Una buena descripción breve debe explicar:

• Qué tarea realiza la habilidad

• A qué tipo de datos de ingeniería se aplica

• Cuándo debe utilizarse la habilidad

• Qué resultado se espera que produzca la habilidad

La descripción breve debe ser concisa, pero no vaga. Debe incluir suficiente contexto para que la IA pueda distinguir esta habilidad de otras similares.

Una descripción breve deficiente solo indica a qué dominio pertenece la habilidad. Una descripción breve sólida explica la tarea específica, el contexto esperado y la situación que debe activarla. Por ejemplo, en lugar de describir una habilidad como algo que “ayuda con requisitos”, la descripción debe explicar si la habilidad revisa la calidad de los requisitos, descompone requisitos complejos, traduce texto de requisitos, detecta conflictos, genera criterios de verificación o realiza otra acción específica.

Cuanto mejor explique la descripción breve el propósito de la habilidad y su contexto de uso, con mayor fiabilidad podrá el asistente decidir cuándo aplicarla.

Instrucciones

Las Instructions definen lo que debe hacer la IA una vez que se haya seleccionado la habilidad. Este es el campo más importante para controlar el comportamiento de la habilidad. Mientras que la descripción breve ayuda a la IA a decidir cuándo usar la habilidad, las instrucciones definen cómo debe ejecutarse.

Las buenas instrucciones deben redactarse como una guía clara, paso a paso. No solo deben describir el resultado final, sino también el razonamiento y las restricciones que la IA debe seguir mientras lo produce.

Las instrucciones deben explicar:

• What the AI should analyze first – el asistente normalmente debe comprender la intención de ingeniería, el contexto, la estructura o las relaciones antes de cambiar o generar cualquier cosa.

• What steps the AI should perform – el comportamiento debe dividirse en pasos explícitos, para que la salida sea repetible y predecible.

• What the AI should preserve – esto puede incluir la intención original, los ID de requisitos, términos técnicos, unidades, valores, restricciones, referencias, aplicabilidad, jerarquía o contexto de trazabilidad.

• What the AI must not do – las buenas habilidades impiden explícitamente que la IA invente detalles de ingeniería faltantes, cambie la intención, introduzca nuevas suposiciones o aplique cambios sin revisión del usuario.

• How the AI should handle uncertainty – si falta información, es ambigua o insuficiente, la habilidad debe indicar a la IA que exponga el problema con claridad en lugar de adivinar.

• What output format is expected – la habilidad debe definir si el resultado debe ser una tabla, una lista con viñetas, texto reescrito, un resumen, una lista de comprobación o un informe estructurado.

Las buenas instrucciones son especialmente importantes para el trabajo de ingeniería porque el asistente puede estar trabajando con datos que afectan a especificaciones, validación, decisiones de diseño o implementación posterior. Por tanto, la habilidad debe guiar a la IA para que sea útil sin mostrarse excesivamente segura.

Otras notas

• El objetivo no es redactar una indicación larga. El objetivo es definir un procedimiento operativo claro para la IA.

• Keep Skills Focused

  Una habilidad debe realizar bien una tarea repetible.

  Si una habilidad intenta hacer demasiadas cosas, al asistente le resultará más difícil saber cuándo usarla y a los usuarios les resultará más difícil confiar en la salida. Por ejemplo, una misma habilidad no debería combinar descomposición de requisitos, traducción, revisión de calidad, análisis de trazabilidad y generación de verificación, a menos que esas acciones formen parte intencionadamente de un único flujo de trabajo estrechamente definido.

  Si el propósito de la habilidad requiere múltiples acciones no relacionadas, divídala en habilidades separadas.

• Define Boundaries Clearly

  Las buenas habilidades son explícitas en cuanto a sus límites.

  Esto es especialmente importante cuando se trabaja con requisitos, especificaciones y datos de ingeniería. El asistente debe saber qué se le permite cambiar, qué solo debe sugerir y qué no debe asumir nunca.

  Los límites útiles incluyen:

  • No cambie la intención de ingeniería original

  • No invente valores, restricciones ni decisiones de diseño

  • No elimine ID ni referencias

  • No asuma métodos de verificación faltantes

  • No aplique cambios automáticamente sin revisión del usuario

  • No trate la información poco clara como si fuera un hecho

  Los límites claros reducen el riesgo de generar resultados de ingeniería plausibles pero incorrectos.

• Define the Output Format

  Una habilidad debe indicar a la IA cómo devolver el resultado.

  Un formato de salida coherente hace que la habilidad sea más fácil de revisar, comparar y reutilizar.

  Según la habilidad, la salida puede ser:

  • Una tabla

  • Una lista con viñetas

  • Un requisito reescrito

  • Un informe estructurado

  • Una lista de comprobación

  • Un resumen

  • Una lista de cambios propuestos

  • Un conjunto de preguntas o cuestiones abiertas

  El formato de salida debe corresponder al propósito de la habilidad. Por ejemplo, las habilidades orientadas a revisión suelen funcionar bien como tablas con columnas de problema, explicación y recomendación. Las habilidades orientadas a reescritura suelen funcionar bien cuando muestran el texto original, la salida propuesta y la justificación.