KI-PRD: Anforderungen schreiben, an die ein Modellsystem tatsächlich gebunden werden kann
Eine PRD für ein KI-System ist ein anderes Dokument. Ihre Anforderungen sind keine Anweisungen an eine Entwicklerin; sie sind Einschränkungen für ein System, das improvisieren wird. Diese Fähigkeit strukturiert das Dokument um diese Tatsache herum.
Von dieser Fähigkeit gesteuerte Dateien
- ../../templates/definition/prd.md, die Basis-PRD-Vorlage
- Der KI-Overlay in
templates/ai/: eval-spec.md, guardrails.md, hallucination-controls.md, human-approval-gates.md, prompt-structure.md, context-management.md, red-team-review.md, und für agentische Systeme agent-architecture.md und multi-agent-workflow.md - Für regulierte Kontexte: ../../modules/regulated/templates/regulated-ai-prd-template.md, gesteuert von ../../modules/regulated/SKILL.md
Wann verwenden
- Wenn ein Feature spezifiziert wird, bei dem ein LLM, Agent oder Modell eine Entscheidung trifft oder entwirft
- Beim Überprüfen einer bestehenden PRD, die irgendwo „die KI sollte...“ sagt
- Wenn eine Demo in etwas verwandelt wird, für das ein Entwicklungsteam rechenschaftspflichtig sein kann
Die fünf Abschnitte, die diese Fähigkeit durchsetzt
1. Akzeptanzkriterien sind Auswertungssets, keine Sätze
„Der Agent sollte den Händlernamen extrahieren“ ist ein Wunsch. Eine Anforderung ist:
- Ein beschriftetes Beispielset (mindestens 30 bis 50 Fälle für eine erste Version)
- Eine als Zahl angegebene Bestehensschwelle (Genauigkeit, Recall@k oder Bewertungspunktzahl)
- Die Regel, was unterhalb der Schwelle passiert (Release blockieren, nicht „überprüfen“)
Für jedes „sollte“ im Entwurf fragen: Wo ist das Beispielset, was ist die Zahl, wer ist dafür verantwortlich, fehlgeschlagene Fälle wieder in das Set aufzunehmen. Erfassen Sie die Antworten in ../../templates/ai/eval-spec.md.
2. Randfälle sind die Spezifikation, nicht der Anhang
Der glückliche Pfad ist das, was das Modell kostenlos macht. Das Dokument verdient seine Daseinsberechtigung an den Grenzen. Fordern Sie explizite Tabellen für:
- MUSS VERWEIGERN: Eingaben, die das System ablehnt (außerhalb des Rahmens, unsicher, jenseits aller Reparatur mehrdeutig)
- MUSS ESKALIEREN: Bedingungen, die zu einem Menschen führen, mit benanntem Routing-Ziel; Auslöser und Timeout-Verhalten in ../../templates/ai/human-approval-gates.md erfassen
- MUSS NIEMALS ERFINDEN: Felder, bei denen Erfindung schlimmer ist als Abwesenheit (Zahlen, Namen, rechtliche oder regulatorische Aussagen, Geldbeträge); die Enthaltungspolitik lebt in ../../templates/ai/hallucination-controls.md
3. Nichtdeterminismus wird schriftlich festgehalten
Dieselbe Eingabe kann morgen eine andere Ausgabe erzeugen. Die PRD muss angeben:
- Welche Ausgabevariationen akzeptabel sind (Formulierung? Reihenfolge? Formatierung?)
- Welche Defekte sind (andere Entscheidung, andere Zahl, anderes Verweigerungsverhalten)
- Reproduzierbarkeitshaltung: Temperatur- und Seed-Policy, und ob Protokolle genug erfassen, um eine Entscheidung erneut abzuspielen
Wenn die PRD dies nicht sagt, wird QA es später in einem Bug-Tracker und wütend entscheiden.
4. Absicherungen sind Features mit Eigentümern
Jede Absicherung erhält eine Zeile in ../../templates/ai/guardrails.md: Name, Auslöser, Verhalten, Eigentümer, Test. Mindestsatz, der für jedes agentische Feature in Betracht gezogen werden sollte:
- Fail-Closed bei nicht verifizierbarer Ausgabe (Kann es nicht überprüfen = Nicht an den Benutzer ausliefern)
- Menschliche Genehmigung vor allem, was nicht rückgängig gemacht werden kann (Sendungen, Zahlungen, Löschungen, Veröffentlichungen)
- Ausgaben- und Ratenbegrenzungen mit einer angegebenen Obergrenze und einem angegebenen Verhalten an der Obergrenze
- Eingabeisolierung: Inhalt, den das System liest, sind Daten, niemals Anweisungen
- Prüfpfad: Wer oder was hat entschieden, basierend auf welchen Eingaben, mit welcher Modellversion
5. Die Betriebsseite
- Kosten pro Aufrufziel und die Warngrenze
- Latenzbudget pro Schritt
- Modellversionsfixierung und der Upgrade-Entscheidungsprozess
- Telemetrie: Was wird pro Entscheidung protokolliert, wo Evals ausgeführt werden (CI, Vorabversion, Produktionsstichprobe), und der Rollback-Auslöser
Der regulierte Weg
Die generische PRD-Werkzeug schreibt die fünf obigen Abschnitte und stoppt dann. Wenn das Produkt unter einer Finanz- oder Datenschutzbehörde steht, führen Sie das eigene Overlay dieser Fähigkeit nicht aus dem Speicher aus. Starten Sie stattdessen von der bytegenauen Vorlage unter ../../modules/regulated/templates/regulated-ai-prd-template.md, folgen Sie ../../modules/regulated/SKILL.md, und vervollständigen Sie deren Abschnitt 0 (Lizenzvoraussetzungen, Schema-Regeln, Datenresidenz und Anbieterbedingungen, Finanzkriminalitäts-Berührungspunkte, Verhalten, der revisionssichere Metrik-Nachweis), bevor irgendeine Anforderung geschrieben wird. Ein leeres Overlay-Feld ist eine Entscheidung, die aufgeschoben wird, bis es jemand leer findet. Behördliche Namen, Abschnittsnummern und zitierter Text stammen nur aus diesem Modul oder aus Primärtexten, die der Benutzer liefert; erfinden Sie sie niemals.
Arbeitsablauf
- Klassifizieren Sie den Kontext. Reguliert: Nehmen Sie den obigen regulierten Weg, kehren Sie dann für Abschnitte, die das Modul nicht abdeckt, hierher zurück. Unreguliert: Starten Sie von ../../templates/definition/prd.md.
- Lesen Sie den PRD-Entwurf oder führen Sie ein Interview mit dem PM, wenn Sie leer beginnen.
- Schreiben Sie jede „sollte“-Aussage in die Form von Abschnitt 1 um. Listen Sie diejenigen auf, die nicht in Evals umgewandelt werden können; das sind noch keine Anforderungen, kennzeichnen Sie sie.
- Erstellen Sie die drei Randfall-Tabellen. Drängen Sie auf mindestens 5 Zeilen pro Tabelle; leere Tabellen bedeuten, dass die Entdeckung nicht abgeschlossen ist.
- Schreiben Sie die Nichtdeterminismus-Klausel und die Absicherungstabelle.
- Erstellen Sie eine einseitige LÜCKEN-Liste: jede Stelle, an der das ursprüngliche Dokument einen deterministischen Implementierer annahm, nach Schadensradius geordnet.
Ausgabeformat
Geben Sie die umstrukturierte PRD mit den fünf Abschnitten zurück, dann die LÜCKEN-Tabelle:
| # | Lücke | Wo im Original | Schadensradius bei Auslieferung wie besehen | Kleinste Korrektur |
|---|
Ausgangstor
Die Ausgabe dieser Fähigkeit speist Tor 2 in ../../os/STAGE-GATES.md. Melden Sie die PRD nicht als fertig, solange irgendeiner Anforderung eine numerische Bestehensbedingung fehlt, irgendeiner Absicherung ein Eigentümer und ein Test fehlen, oder irgendeiner LÜCKEN-Zeile ein Eigentümer und ein Datum fehlen.