Ingegneria dei requisiti agentica

• Break Down Complex Requirements – analizza i requisiti selezionati e li suddivide in requisiti più piccoli e verificabili in modo indipendente, preservando l'intento originale.

  Prompt di esempio:

  Break down these requirements.

• Apply Requirement Writing Standards – esamina i requisiti e riscrivili in base alle linee guida della tua organizzazione per la scrittura dei requisiti. I controlli tipici includono ambiguità, linguaggio non verificabile, attori mancanti e criteri di accettazione poco chiari.

  Prompt di esempio:

  Rewrite these requirements according to our requirement quality standard.

• Translate Requirements – traduce i requisiti da una lingua all'altra preservando il significato tecnico, la terminologia, gli ID e i riferimenti di tracciabilità.

  Prompt di esempio:

  Translate these requirements to German.

• Classify Requirements – applica ai requisiti uno schema di classificazione organizzativo, come Elettronica, Meccanica, Software, Safety, Security o altre tassonomie specifiche dell'azienda.

  Prompt di esempio:

  Classify these requirements according to our applicability model.

• Generate Verification Criteria – analizza i requisiti e propone metodi di verifica, criteri di accettazione o condizioni di test che possano essere utilizzati per dimostrare la conformità sempre nello stesso modo.

  Prompt di esempio:

  Generate verification criteria for these requirements.

• Summarize a Specification/Section/Group of Requirements – genera un riepilogo conciso e strutturato di una specifica, di una sezione di requisiti o di un insieme di requisiti.

  Prompt di esempio:

  Summarize the selected requirements.

Una buona skill aiuta l'AI a comprendere due cose:

• Quando la skill deve essere utilizzata

• Cosa deve fare l'AI quando la skill viene eseguita

Quando definisci una skill, 

Questo si esprime attraverso tre campi, ciascuno con uno scopo diverso:

• Name – ti aiuta a riconoscere la skill.

• Short Description – aiuta l'AI a decidere quando la skill è pertinente.

• Instructions – definiscono il comportamento che l'AI deve seguire una volta selezionata la skill.

Per dettagli su ciascun campo, fai riferimento alle sezioni seguenti.

Nome

Il Name deve essere breve, chiaro e orientato all'azione. Deve aiutarti a capire rapidamente cosa è destinata a fare la skill. Un buon nome di solito descrive l'azione e il tipo di dati ingegneristici su cui la skill opera.

Un nome di skill efficace dovrebbe essere:

• Abbastanza specifico da distinguere la skill dalle altre

• Abbastanza breve da poter essere individuato facilmente nell'elenco delle skill

• Focalizzato sull'attività principale che la skill esegue

• Scritto in un linguaggio che gli utenti comprendono naturalmente

Evita nomi troppo ampi o generici. Se il nome potrebbe applicarsi a molte attività diverse, probabilmente non è abbastanza specifico.

Descrizione breve

La Short Description aiuta l'AI a capire di cosa tratta la skill e quando deve essere attivata. Questo campo è importante perché non è necessario selezionare manualmente una skill. L'assistente analizza il tuo prompt, lo confronta con le skill disponibili e decide se una skill è pertinente.

Una buona descrizione breve dovrebbe spiegare:

• Quale attività esegue la skill

• A quale tipo di dati ingegneristici si applica

• Quando la skill deve essere utilizzata

• Quale risultato ci si aspetta che produca la skill

La descrizione breve deve essere concisa, ma non vaga. Deve includere un contesto sufficiente affinché l'AI possa distinguere questa skill da skill simili.

Una descrizione breve debole si limita a indicare a quale dominio appartiene la skill. Una descrizione breve forte spiega l'attività specifica, il contesto previsto e la situazione che ne attiva l'uso. Ad esempio, invece di descrivere una skill come qualcosa che "aiuta con i requisiti", la descrizione dovrebbe spiegare se la skill esamina la qualità dei requisiti, scompone requisiti complessi, traduce il testo dei requisiti, rileva conflitti, genera criteri di verifica oppure esegue un'altra azione specifica.

Quanto meglio la descrizione breve spiega lo scopo della skill e il contesto del suo utilizzo, tanto più affidabilmente l'assistente può decidere quando applicarla.

Istruzioni

Le Instructions definiscono ciò che l'AI deve fare una volta che la skill è stata selezionata. Questo è il campo più importante per controllare il comportamento della skill. Mentre la descrizione breve aiuta l'AI a decidere quando usare la skill, le istruzioni definiscono come la skill deve essere eseguita.

Buone istruzioni dovrebbero essere scritte come una guida chiara, passo dopo passo. Non dovrebbero limitarsi a descrivere l'output finale, ma anche il ragionamento e i vincoli che l'AI deve seguire durante la produzione di tale output.

Le istruzioni dovrebbero spiegare:

• What the AI should analyze first – l'assistente dovrebbe di norma comprendere l'intento ingegneristico, il contesto, la struttura o le relazioni prima di modificare o generare qualsiasi cosa.

• What steps the AI should perform – il comportamento dovrebbe essere suddiviso in passaggi espliciti, in modo che l'output sia ripetibile e prevedibile.

• What the AI should preserve – ciò può includere intento originale, ID requisito, termini tecnici, unità, valori, vincoli, riferimenti, applicabilità, gerarchia o contesto di tracciabilità.

• What the AI must not do – le buone skill impediscono esplicitamente all'AI di inventare dettagli ingegneristici mancanti, cambiare l'intento, introdurre nuove ipotesi o applicare modifiche senza revisione da parte dell'utente.

• How the AI should handle uncertainty – se le informazioni sono mancanti, ambigue o insufficienti, la skill dovrebbe istruire l'AI a indicare chiaramente il problema invece di fare supposizioni.

• What output format is expected – la skill dovrebbe definire se il risultato deve essere una tabella, un elenco puntato, un testo riscritto, un riepilogo, una checklist o un report strutturato.

Buone istruzioni sono particolarmente importanti per il lavoro ingegneristico perché l'assistente può operare con dati che influiscono su specifiche, validazione, decisioni di progettazione o implementazione a valle. La skill dovrebbe quindi guidare l'AI in modo che sia utile senza essere eccessivamente sicura di sé.

Altre note

• L'obiettivo non è scrivere un prompt lungo. L'obiettivo è definire una procedura operativa chiara per l'AI.

• Keep Skills Focused

  Una skill dovrebbe svolgere bene un'unica attività ripetibile.

  Se una skill cerca di fare troppe cose, diventa più difficile per l'assistente capire quando usarla e più difficile per gli utenti fidarsi dell'output. Ad esempio, una singola skill non dovrebbe combinare scomposizione dei requisiti, traduzione, revisione della qualità, analisi della tracciabilità e generazione della verifica, a meno che tali azioni non facciano intenzionalmente parte di un unico flusso di lavoro strettamente definito.

  Se lo scopo della skill richiede più azioni non correlate, suddividila in skill separate.

• Define Boundaries Clearly

  Le buone skill sono esplicite riguardo ai limiti.

  Questo è particolarmente importante quando si lavora con requisiti, specifiche e dati ingegneristici. L'assistente deve sapere cosa gli è consentito modificare, cosa deve solo suggerire e cosa non deve mai presumere.

  Limiti utili includono:

  • Non modificare l'intento ingegneristico originale

  • Non inventare valori, vincoli o decisioni di progettazione

  • Non rimuovere ID o riferimenti

  • Non presumere metodi di verifica mancanti

  • Non applicare automaticamente modifiche senza revisione da parte dell'utente

  • Non trattare informazioni poco chiare come fatti

  Limiti chiari riducono il rischio di output ingegneristici plausibili ma errati.

• Define the Output Format

  Una skill dovrebbe indicare all'AI come restituire il risultato.

  Un formato di output coerente rende la skill più facile da rivedere, confrontare e riutilizzare.

  A seconda della skill, l'output può essere:

  • Una tabella

  • Un elenco puntato

  • Un requisito riscritto

  • Un report strutturato

  • Una checklist

  • Un riepilogo

  • Un elenco di modifiche proposte

  • Un insieme di domande o questioni aperte

  Il formato di output deve corrispondere allo scopo della skill. Ad esempio, le skill orientate alla revisione spesso funzionano bene come tabelle con colonne per problema, spiegazione e raccomandazione. Le skill orientate alla riscrittura spesso funzionano bene quando mostrano il testo originale, l'output proposto e la motivazione.