Ingegneria dei requisiti agentica

• Break Down Complex Requirements – analizzare i requisiti selezionati e suddividerli in requisiti più piccoli e verificabili in modo indipendente, preservando l’intento originale.

  Prompt di esempio:

  Break down these requirements.

• Apply Requirement Writing Standards – esaminare i requisiti e riscriverli secondo le 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 – tradurre i requisiti da una lingua a un’altra preservando il significato tecnico, la terminologia, gli ID e i riferimenti di tracciabilità.

  Prompt di esempio:

  Translate these requirements to German.

• Classify Requirements – applicare 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 – analizzare i requisiti e proporre metodi di verifica, criteri di accettazione o condizioni di test che potrebbero essere usati per dimostrare la conformità sempre nello stesso modo.

  Prompt di esempio:

  Generate verification criteria for these requirements.

• Summarize a Specification/Section/Group of Requirements – generare 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 usata

• Cosa l’AI deve fare 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 i dettagli su ciascun campo, fai riferimento alle sezioni seguenti.

Nome

Il Name dovrebbe essere breve, chiaro e orientato all’azione. Dovrebbe aiutarti a capire rapidamente a cosa serve la skill. Un buon nome di solito descrive l’azione e il tipo di dati di ingegneria su cui la skill opera.

Un nome di skill efficace dovrebbe essere:

• Abbastanza specifico da distinguere la skill dalle altre

• Abbastanza breve da essere facilmente individuabile nell’elenco delle skill

• Focalizzato sull’attività principale svolta dalla skill

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

Breve descrizione

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 breve descrizione dovrebbe spiegare:

• Quale attività svolge la skill

• A quale tipo di dati di ingegneria si applica

• Quando la skill deve essere usata

• Quale risultato ci si aspetta che produca la skill

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

Una breve descrizione debole si limita a indicare a quale dominio appartiene la skill. Una breve descrizione efficace spiega invece l’attività specifica, il contesto previsto e la situazione che ne determina l’attivazione. Per 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 o svolge un’altra azione specifica.

Quanto meglio la breve descrizione spiega lo scopo della skill e il contesto d’uso, tanto più affidabilmente l’assistente potrà decidere quando applicarla.

Istruzioni

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

Buone istruzioni dovrebbero essere scritte come indicazioni chiare e 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 in genere 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 – questo 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 di ingegneria mancanti, cambiare l’intento, introdurre nuove supposizioni 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 dichiarare chiaramente il problema invece di indovinare.

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

Buone istruzioni sono particolarmente importanti per il lavoro di ingegneria perché l’assistente potrebbe lavorare con dati che influenzano specifiche, validazione, decisioni di progettazione o implementazione a valle. La skill dovrebbe quindi guidare l’AI affinché sia utile senza risultare 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 eseguire 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. Per esempio, una 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 di ingegneria. 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 se fossero fatti

  Limiti chiari riducono il rischio di output ingegneristico plausibile ma errato.

• 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 dovrebbe corrispondere allo scopo della skill. Per 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.