Ingeniería de requisitos basada en agentes

• Break Down Complex Requirements – analizar los requisitos seleccionados y dividirlos en requisitos más pequeños que puedan verificarse de forma independiente, conservando la intención original.

  Ejemplo de instrucción:

  Break down these requirements.

• Apply Requirement Writing Standards – revisar los requisitos y reescribirlos de acuerdo con las directrices de redacción de requisitos de su organización. Las comprobaciones habituales incluyen ambigüedades, lenguaje no verificable, ausencia de actores y criterios de aceptación poco claros.

  Ejemplo de instrucció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 identificadores y las referencias de trazabilidad.

  Ejemplo de instrucción:

  Translate these requirements to German.

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

  Ejemplo de instrucción:

  Classify these requirements according to our applicability model.

• Generate Verification Criteria – analizar los 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 instrucció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 instrucción:

  Summarize the selected requirements.

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

• Cuándo debe utilizarse 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 es relevante la habilidad.

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

Consulte las secciones siguientes para obtener más información sobre cada campo.

Nombre

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

Un buen nombre de habilidad debe ser:

• Lo suficientemente específico como para distinguir la habilidad de las demás

• Lo suficientemente breve como para identificarlo fácilmente en la lista de habilidades

• Centrado en la tarea principal que realiza la habilidad

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

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

Descripción breve

La Short Description ayuda a la IA a comprender en qué consiste la habilidad y cuándo debe activarse. Este campo es importante porque no es necesario seleccionar una habilidad manualmente. El asistente analiza su solicitud, la compara con las habilidades disponibles y decide si alguna 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é ámbito pertenece la habilidad. Una descripción breve sólida explica la tarea específica, el contexto previsto y la situación que debe activarla. Por ejemplo, en lugar de describir una habilidad como algo que «ayuda con los requisitos», la descripción debe explicar si la habilidad revisa la calidad de los requisitos, desglosa requisitos complejos, traduce el texto de los 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, más fiable será la decisión del asistente sobre cuándo aplicarla.

Instrucciones

Las Instructions definen lo que debe hacer la IA una vez seleccionada 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 utilizar la habilidad, las instrucciones definen cómo debe ejecutarse.

Las buenas instrucciones deben redactarse como indicaciones claras y paso a paso. No solo deben describir el resultado final, sino también el razonamiento y las restricciones que la IA debe seguir al producirlo.

Las instrucciones deben explicar:

• What the AI should analyze first – por lo general, el asistente debe comprender la intención de ingeniería, el contexto, la estructura o las relaciones antes de modificar o generar cualquier contenido.

• What steps the AI should perform – el comportamiento debe dividirse en pasos explícitos para que el resultado sea reproducible y predecible.

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

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

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

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

Las buenas instrucciones son especialmente importantes en el trabajo de ingeniería porque el asistente puede estar trabajando con datos que afectan a especificaciones, validaciones, decisiones de diseño o implementaciones posteriores. Por lo tanto, la habilidad debe orientar a la IA para que resulte útil sin mostrar un exceso de confianza.

Otras notas

• El objetivo no es redactar una solicitud extensa. El objetivo es definir un procedimiento operativo claro para la IA.

• Keep Skills Focused

  Una habilidad debe realizar bien una única tarea reproducible.

  Si una habilidad intenta hacer demasiadas cosas, al asistente le resulta más difícil saber cuándo utilizarla y a los usuarios les cuesta más confiar en el resultado. Por ejemplo, una habilidad no debe combinar el desglose de requisitos, la traducción, la revisión de calidad, el análisis de trazabilidad y la generación de verificaciones, salvo que esas acciones formen parte intencionadamente de un único flujo de trabajo definido con precisión.

  Si el propósito de la habilidad requiere varias acciones no relacionadas entre sí, divídala en habilidades independientes.

• Define Boundaries Clearly

  Las buenas habilidades definen sus límites de forma explícita.

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

  Algunos límites útiles son:

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

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

  • No eliminar identificadores ni referencias

  • No dar por supuestos los métodos de verificación que falten

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

  • No tratar la información poco clara como 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 presentar el resultado.

  Un formato de salida coherente facilita la revisión, la comparación y la reutilización de la habilidad.

  Según la habilidad, el resultado puede ser:

  • Una tabla

  • Una lista con viñetas

  • Un requisito reformulado

  • Un informe estructurado

  • Una lista de comprobación

  • Un resumen

  • Una lista de cambios propuestos

  • Un conjunto de preguntas o cuestiones pendientes

  El formato de salida debe ajustarse al propósito de la habilidad. Por ejemplo, las habilidades orientadas a la revisión suelen funcionar bien con tablas que incluyen columnas para el problema, la explicación y la recomendación. Las habilidades orientadas a la reformulación suelen funcionar bien cuando muestran el texto original, el resultado propuesto y la justificación.