Uso y gestión de habilidades de IA

• 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 solicitud:

  Break down these requirements.

• Apply Requirement Writing Standards – revisar los requisitos y reformularlos según las directrices de redacción de requisitos de su organización. Las comprobaciones habituales incluyen la ambigüedad, el lenguaje no verificable, la ausencia de actores y los criterios de aceptación poco claros.

  Ejemplo de solicitud:

  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 solicitud:

  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 solicitud:

  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 solicitud:

  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 solicitud:

  Summarize the selected requirements.

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

• Cuándo debe utilizarse la habilidad

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

Esto se expresa mediante tres campos, cada uno con una finalidad distinta:

• Name – le ayuda a reconocer la habilidad.

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

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

Consulte las secciones siguientes para obtener detalles sobre cada campo.

Nombre

El Name debe ser breve, claro y estar orientado a la acción. Debe ayudarle a entender 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 para distinguir la habilidad de las demás

• Lo suficientemente breve 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 entiendan de forma natural

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

Descripción breve

La Short Description ayuda a la IA a entender 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 buena descripción breve explica la tarea específica, el contexto previsto y la situación que activa su uso. 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, descompone requisitos complejos, traduce el texto de los requisitos, detecta conflictos, genera criterios de verificación o realiza alguna 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á decidir el asistente cuándo aplicarla.

Instrucciones

Las Instructions definen qué 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 una guía clara 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:

• Qué debe analizar primero la IA: 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.

• Qué pasos debe realizar la IA: el comportamiento debe desglosarse en pasos explícitos para que el resultado sea reproducible y predecible.

• Qué debe conservar la IA: 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.

• Qué no debe hacer la IA: las buenas habilidades impiden explícitamente que la IA invente detalles de ingeniería que falten, cambie la intención, introduzca nuevas suposiciones o aplique cambios sin la revisión del usuario.

• Cómo debe gestionar la IA la incertidumbre: si falta información, es ambigua o resulta insuficiente, la habilidad debe indicar a la IA que exponga el problema con claridad en lugar de hacer conjeturas.

• Qué formato de salida se espera: 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 las especificaciones, la validación, las decisiones de diseño o la implementación posterior. 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 escribir una instrucción extensa. El objetivo es definir un procedimiento operativo claro para la IA.

• Mantenga las habilidades centradas en una tarea

  Una habilidad debe realizar bien una única tarea repetible.

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

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

• Defina los límites con claridad

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

  Esto es especialmente importante al trabajar con requisitos, especificaciones y datos de ingeniería. El asistente debe saber qué puede modificar, qué debe limitarse a 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 métodos de verificación que no se hayan especificado

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

  • No tratar como hechos la información poco clara

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

• Defina el formato de salida

  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 incluyan 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.