Leitfaden · Anforderungen
Gute Systemanforderungen schreiben: Beispiele und Checkliste
Diesen Leitfaden anhören (Audio auf Englisch) 26 min
Eine gute Anforderung sagt eine Sache, die das System tun oder sein muss, in Worten, die zwei Ingenieure gleich lesen, mit einem Wert, den ein Test oder eine Analyse prüfen kann. Dieser Leitfaden behandelt Bedarfe und Anforderungen, die Teile einer Anforderungsaussage, die Qualitätsmerkmale aus ISO/IEC/IEEE 29148 und dem INCOSE Guide to Writing Requirements, eine Checkliste mit Vorher-nachher-Beispielen, Verifikations- und Abnahmekriterien, TBD- und TBR-Werte sowie Anforderungstypen, alles an einer CubeSat-Spezifikation durchgearbeitet.
Auf dieser Seite
- Warum der Wortlaut einer Anforderung wichtig ist
- Stakeholder-Bedarfe und Anforderungen
- Der Aufbau einer Anforderung
- Qualitätsmerkmale einer guten Anforderung
- Die Checkliste: Regeln mit Vorher-nachher-Beispielen
- Verifikationsmethode und Abnahmekriterien mit der Anforderung schreiben
- Umgang mit TBD- und TBR-Werten
- Anforderungstypen
- Durchgearbeitetes Beispiel: Review der EO-1-Spezifikation
- Häufige Fehler
- In Holarch ausprobieren
- Die Checkliste herunterladen
- Fragen zum Schreiben von Anforderungen
- Wie es weitergeht
Warum der Wortlaut einer Anforderung wichtig ist
Eine Anforderung ist ein Vertrag zwischen denen, die ein System verlangen, und denen, die es bauen. Alles Nachgelagerte liest sie: Der Konstrukteur dimensioniert eine Komponente danach, der Testingenieur schreibt daraus ein Bestehenskriterium, das Änderungsgremium wägt eine Änderung dagegen ab, und der Kunde nimmt das System danach ab. Jeder von ihnen liest denselben Satz, meist ohne den Autor im Raum. Lässt sich der Satz auf zwei Arten lesen, wird er es, und der Unterschied zeigt sich spät: bei einem Test, der gegen ein Kriterium „besteht“, das niemand vereinbart hat, oder bei der Abnahme, wenn der Kunde etwas anderes gemeint hat.
Schlechter Wortlaut beschädigt auch den Rest des Modells. Eine Anforderung ohne Wert lässt sich keiner Komponente zuteilen, weil niemand sagen kann, ob die Komponente sie erfüllt. Sie lässt sich nicht verifizieren und erscheint daher als Abdeckungslücke in der Nachverfolgbarkeit und der Verifikationsmatrix. Und wenn sie sich ändert, kann niemand sagen, ob der verknüpfte Entwurf noch gilt. Anforderungen gut zu schreiben ist die billigste Qualitätsarbeit in einem Projekt: Eine Stunde an einem Satz zu Beginn erspart eine Testkampagne am Ende.
Der Leitfaden verwendet ein durchgehendes Beispiel, EO-1, einen fiktiven 6U-CubeSat, der Ackerland in vier Spektralbändern aufnimmt. Seine Spezifikation, SRS-001 EO-1 System Requirements Specification, hat 32 Anforderungen, die meisten solide und drei absichtlich schwach. Es ist dasselbe Modell wie im durchgängigen MBSE-Beispielprojekt. Die hier zitierten Stakeholder-Bedarfe N1 bis N3 sind diejenigen, die der Leitfaden zur Nachverfolgbarkeit dem Modell hinzufügt.
Stakeholder-Bedarfe und Anforderungen
Das Schreiben von Anforderungen beginnt einen Schritt früher, bei den Bedarfen. Ein Stakeholder-Bedarf ist das, was ein Nutzer, Betreiber, Kunde oder Regulierer erwartet, in seinen eigenen Worten. Eine Anforderung ist die technische Aussage, gegen die das System entworfen und verifiziert wird. ISO/IEC/IEEE 15288 hält beides in getrennten technischen Prozessen auseinander: Definition der Stakeholder-Bedarfe und -Anforderungen (6.4.2) und Definition der Systemanforderungen (6.4.3). Das INCOSE Needs and Requirements Manual trifft dieselbe Unterscheidung und behandelt Bedarfe als eigenständige Elemente, nicht als Rohentwürfe von Anforderungen.
| EO-1-Beispiel | Geprüft durch | |
|---|---|---|
| Bedarf (N2 Twice-Weekly Revisit) | Farm customers need fresh imagery of their fields at least twice a week in the growing season. | Validierung: Bekommen die Kunden vom gelieferten System, was sie brauchen? |
| Anforderung (1.6 Revisit Time) | The mission shall revisit each target region within 72 hours. | Verifikation: Erfüllt das System die Aussage, per Test, Analyse, Inspektion oder Demonstration? |
Der Unterschied zeigt sich darin, wie jedes geprüft wird. Eine Anforderung wird verifiziert: Das System wird an der Aussage gemessen. Ein Bedarf wird validiert: Jemand bestätigt, dass das System im vorgesehenen Einsatz tut, was der Stakeholder wollte. Ein System kann jede Verifikation bestehen und trotzdem bei der Validierung scheitern, wenn die Anforderungen das Ziel verfehlt haben; der Leitfaden zu Verifikation und Validierung behandelt diese Lücke. Für das Schreiben ist die praktische Folge einfach: zuerst den Bedarf schreiben, dann Anforderungen, die ihn erfüllen würden, wenn sie erfüllt sind, und jede Anforderung mit dem Bedarf verknüpfen, den sie beantwortet.
Die Übersetzung ist selten eins zu eins. N2 wird zu 1.6 Revisit Time, die dann in 1.6.1 Ground Track Repeat (3 Tage) und 1.6.2 Off-Nadir Imaging (25 Grad) zerlegt wird. Manche Anforderungen beantworten keinen Bedarf direkt: 3.1 Orbit Average Power ist aus 1.5 Daily Collection Volume abgeleitet, weil die Aufnahmelast die Leistung festlegt, die die Paneele liefern müssen. Kein Kunde hat nach 30 W gefragt, aber die Aufnahmen, nach denen sie gefragt haben, sind ohne sie nicht möglich.
Der Aufbau einer Anforderung
Eine Anforderung ist mehr als ihr Satz. Der Satz trägt die Verpflichtung; eine Reihe von Attributen um ihn herum trägt die Gründe, den Plan für den Nachweis und die Buchführung. Beide Hälften gehören zum Schreiben.
Die Aussage
Die meisten guten Anforderungsaussagen folgen einem Muster. ISO/IEC/IEEE 29148 (5.2.4) beschreibt es als Subjekt, Handlung, Objekt und Einschränkungen der Handlung, mit einer optionalen Bedingung davor; der INCOSE Guide to Writing Requirements empfiehlt dieselbe Reihenfolge und vereinbarte Vorlagen für jede Art von Anforderung.
| Teil | Was er sagt | EO-1 4.3 Fault Detection |
|---|---|---|
| Bedingung (optional) | Wann, in welchem Modus oder Zustand die Anforderung gilt | „…of undervoltage detection“ (das auslösende Ereignis) |
| Subjekt | Das System oder Element, das sie erfüllen muss, genau benannt | „The C&DH“ |
| Modalverb | Die Stärke der Verpflichtung | „shall“ |
| Action | Was das Subjekt tut oder ist, als aktives Verb | „enter“ |
| Objekt | Worauf sich die Handlung bezieht | „safe mode“ |
| Leistung oder Randbedingung | Der messbare Wert, mit Einheit und Grenzrichtung | „within 10 seconds“ |
Zusammen: „The C&DH shall enter safe mode within 10 seconds of undervoltage detection.“ Die Reihenfolge kann sich verschieben („When undervoltage is detected, the C&DH shall…“ stellt die Bedingung voran, wie in den EARS-Vorlagen, die viele Teams verwenden), aber jeder Teil sollte vorhanden oder bewusst weggelassen sein.
Drei Wörter tragen das meiste Gewicht. Shall kennzeichnet eine verbindliche Anforderung; will nennt eine Tatsache oder eine Absicht zu etwas außerhalb des Systems; should nennt ein Ziel, das nicht verifiziert wird. Welche Konvention ein Projekt auch verwendet, sie wird einmal in der Spezifikation definiert und eingehalten. EO-1 1.1 Reference Orbit („The mission assumes a 500 km sun-synchronous orbit…“) ist korrekt als Annahme geschrieben, nicht als Anforderung: Sie ist Kontext für die Anforderungen, die von ihr abhängen, und das Modell speichert sie als Statement, das weder bewertet noch verifiziert wird.
Die Attribute
So verzeichnet das EO-1-Modell 3.1 Orbit Average Power nach der Änderung von 28 W auf 30 W nach dem PDR:
| Attribut | 3.1 Orbit Average Power | Warum es da ist |
|---|---|---|
| Kennung und Name | 3.1 Orbit Average Power | Ein stabiler Bezug für Links, Reviews und Änderungsanträge |
| Aussage | The solar arrays shall generate at least 30 W orbit-average power at end of life. | Die Verpflichtung selbst |
| Begründung | Orbit-average load grew to 26 W after PDR; 30 W keeps 15% margin. | Lässt einen späteren Leser eine Änderung ohne den Autor beurteilen |
| Quelle und Elternelement | Derived (systems analysis); abgeleitet von 1.5 Daily Collection Volume | Rückwärtsnachverfolgbarkeit: warum die Anforderung existiert |
| Verifikationsmethode und -ebene | Test, auf Subsystemebene | Der Plan für den Nachweis, beim Schreiben entschieden |
| Erfolgskriterien | End-of-life orbit-average power predicted from measured peak power. | Welches Ergebnis als erfüllt gilt |
| Verantwortlicher, Priorität, Kritikalität | Power Engineer; High; High | Wer dafür einsteht und wie wichtig sie ist |
| Status | In Review (sie war Approved; ihr Text hat sich nach der Genehmigung geändert) | Wo sie im Vereinbarungsprozess steht |
| TBD/TBR | Keine | Ob ein Wert noch offen ist |
ISO/IEC/IEEE 29148 (5.2.8) listet Attribute dieser Art auf, und der INCOSE-Leitfaden ergänzt weitere; ein Projekt wählt die aus, die es tatsächlich pflegen wird. Die Begründung wird am häufigsten weggelassen und später am häufigsten vermisst. Ohne „26 W Last, 15 % Marge“ kann die nächste Person, die 3.1 sieht, nicht erkennen, ob 30 W eine harte physikalische Grenze, eine Kundenzahl oder eine Margenentscheidung sind, und daher nicht erkennen, was eine Änderung der Last für sie bedeutet.
Qualitätsmerkmale einer guten Anforderung
Stilregeln sind leichter anzuwenden, wenn man weiß, was sie schützen. ISO/IEC/IEEE 29148 (5.2.5) nennt neun Merkmale einer einzelnen Anforderung, und der INCOSE Guide to Writing Requirements verwendet dieselben neun als C1 bis C9, jedes mit einer kurzen Definition und den Regeln, die es stützen. Die Tabelle formuliert jedes als Frage, die ein Prüfer stellen kann.
| Merkmal | Zu stellende Frage | EO-1-Beispiel |
|---|---|---|
| Notwendig | Ginge etwas verloren, das die Stakeholder brauchen, wenn sie gelöscht würde? Ist sie kein Duplikat? | 3.1 ist notwendig: Ohne sie dimensioniert nichts die Paneele für die Aufnahmelast. |
| Angemessen | Ist sie auf der richtigen Ebene geschrieben, ohne eine Entwurfsentscheidung festzulegen, die die Ebene darunter treffen sollte? | 3.1 legt ein Leistungsniveau für die Paneele fest, keinen Zelltyp und keine Paneelanzahl. |
| Eindeutig | Lässt sie sich nur auf eine Weise lesen? | 6.4 „user friendly“ scheitert: Zwei Prüfer werden uneins sein, ob sie erfüllt ist. |
| Vollständig | Sagt sie alles Nötige, ohne fehlende Bedingung oder fehlenden Wert? | 3.5 „warm enough (TBD)“ scheitert: Der Wert fehlt. |
| Singulär | Nennt sie eine einzige Verpflichtung? | 2.5 scheitert: Sie verlangt, sich zu erholen und die Aufnahmen wieder aufzunehmen, verbunden durch „and“. |
| Machbar | Lässt sie sich innerhalb der bekannten Grenzen von Technik, Kosten und Terminen erfüllen? | 3.1 mit 30 W ist fraglich: Die Paneele im aktuellen Entwurf liefern etwa 28 W im Orbitmittel. |
| Verifizierbar | Kann ein Test, eine Analyse, eine Inspektion oder eine Demonstration zeigen, dass sie erfüllt ist? | 2.5 „quickly“ scheitert; „within 6 hours“ besteht. |
| Korrekt | Nennt sie den tatsächlichen Bedarf ihrer Quelle, mit dem richtigen Wert? | 1.2 4,5 m Bodenauflösung drückt N3, Karten auf Feldebene, korrekt aus, mit Reserve. |
| Konform | Folgt sie den vereinbarten Vorlagen und dem Vokabular des Projekts? | Jede EO-1-Anforderung verwendet „shall“, ein benanntes Subjekt und SI-Einheiten. |
Eine Anforderungsmenge hat eigene Merkmale, die keine einzelne Aussage zeigen kann. ISO/IEC/IEEE 29148 (5.2.6) nennt für die Menge vollständig, konsistent, als Ganzes machbar, verständlich und validierbar; der INCOSE-Leitfaden ergänzt korrekt als C15 und nummeriert die Mengenmerkmale C10 bis C15.
- Vollständig: Die Menge deckt die Bedarfe ab. EO-1 sagt, was bei Unterspannung geschieht (4.3), aber die einzige Anforderung zur Rückkehr aus dem Safe Mode ist 2.5, die so, wie sie geschrieben ist, nicht verifizierbar ist; die Rückkehr ist damit faktisch nicht spezifiziert.
- Konsistent: Keine zwei Anforderungen widersprechen sich, und Begriffe und Einheiten werden gleich verwendet. 1.5 verlangt 3,2 GB Bilddaten pro Tag und 5.4 3 GB, die am Boden empfangen werden; sie stimmen nur überein, weil die Begründung von 5.4 „after compression“ sagt. Ohne die Begründung sehen sie wie ein Widerspruch aus.
- Machbar: Die Anforderungen lassen sich gemeinsam erfüllen. Jede Leistungsanforderung mag für sich machbar sein, während 30 W im Orbitmittel, die Paneelfläche und das Massenbudget zusammen es vielleicht nicht sind.
- Verständlich: Ein Leser kann erkennen, was vom System erwartet wird und wie die Anforderungen zusammenhängen; das hängt ebenso von Struktur, Nummerierung und Nachverfolgbarkeit ab wie vom Wortlaut.
- Validierbar: Es lässt sich zeigen, dass die Menge zu einem System führt, das die Bedarfe erfüllt; deshalb ist jede Anforderung der obersten Ebene mit einem Bedarf verknüpft.
Die Checkliste: Regeln mit Vorher-nachher-Beispielen
Die Merkmale werden durch konkrete Schreibregeln nutzbar. Der INCOSE Guide to Writing Requirements nummeriert sie (R1, R2 und so weiter); das NASA Systems Engineering Handbook (Anhang C) hat eine kürzere Checkliste nach demselben Muster. Die Tabelle sammelt die Regeln, die in der Praxis die meisten Probleme finden, mit je einem Beispiel aus der EO-1-Spezifikation. „Vorher“ ist der Text, wie er in der Demo steht; „Nachher“ ist eine Neuformulierung. Als beispielhaft gekennzeichnete Werte zeigen die Form, nicht Ergebnisse von EO-1-Analysen.
| Regel | Zu stellende Frage | Vorher (EO-1) | Nachher |
|---|---|---|---|
| Eine Verpflichtung je Aussage | Genau ein „shall“, kein „and“, „or“, „and/or“, das zwei Forderungen verbindet? | 2.5: „The spacecraft should recover from safe mode quickly and resume imaging as appropriate“ | „The spacecraft shall resume imaging within 6 hours of a safe mode entry.“ Weitere Wiederherstellungsschritte, die zählen, erhalten eigene Anforderungen. |
| Verbindlicher Wortlaut | „Shall“ für eine verbindliche Anforderung, nicht „should“, „will“ oder „may“? | 2.5: „should recover“ | „shall resume“ |
| Messbarer Wert mit Einheit | Hat jedes Leistungswort eine Zahl und eine Einheit? | 2.5: „quickly“ | „within 6 hours of a safe mode entry“ |
| Grenzrichtung angegeben | Ist klar, ob der Wert ein Minimum oder ein Maximum ist? | 1.6.2: „image targets up to 25 degrees off nadir“ | „image targets at off-nadir angles from 0 to 25 degrees“ (ein Fähigkeitsbereich, keine Obergrenze für die Ausrichtung) |
| Keine Ausweichklauseln | Bleibt etwas dem Urteil des Lieferanten überlassen („as appropriate“, „if possible“, „where practical“)? | 2.5: „as appropriate“ | Entfernt; die Bedingung, auf die es ankommt, ist angegeben |
| Keine vagen oder subjektiven Begriffe | Könnten zwei Prüfer uneins sein, ob sie erfüllt ist („user friendly“, „easy“, „adequate“, „enough“)? | 6.4: „The operator interface shall be user friendly and/or easy to use.“ | „The operator interface shall let a trained operator book a ground station contact in no more than 5 minutes.“ (beispielhaft; eine Anforderung je Aufgabe, die zählt) |
| Ausdrückliche Substantive, keine Pronomen | Hat jedes „it“, „its“ oder „this“ genau einen möglichen Bezug? | 1.6.1: „The reference orbit shall repeat its ground track every 3 days.“ | „The reference orbit shall repeat the ground track every 3 days.“ Das Pronomen ist hier harmlos, aber in einem längeren Satz verrutscht es als Erstes. |
| Bedingungen angegeben | Sagt sie, wann der Wert gilt: Lebensphase, Modus, Umgebung? | „The solar arrays shall generate 30 W.“ | „…at least 30 W orbit-average power at end of life.“ |
| Feste Werte oder verfolgte TBDs | Wird jeder offene Wert mit einem Verantwortlichen und einem Fälligkeitsdatum verfolgt, statt nur in den Text geschrieben? | 3.5: „The thermal design shall keep the battery warm enough (TBD).“ | „The thermal design shall keep the battery cell temperature at or above 0 °C while charging.“ (beispielhaft; bis die thermische Analyse ihn festlegt, nennt das TBD-Attribut den Thermal Engineer und ein Fälligkeitsdatum) |
| Keine Gründe oder Notizen in der Aussage | Sind Zweckformulierungen („so that“, „in order to“) und eingeklammerte Notizen in die Begründung verschoben? | 3.5: „(TBD)“ | Aussage ohne Klammern; Grund in der Begründung |
| Was, nicht wie | Nennt sie den Bedarf, statt eine Lösung vorzuschreiben, die die Ebene darunter wählen sollte? | „The thermal design shall keep the battery warm by means of a 2 W film heater.“ (beispielhaft) | Die Neuformulierung von 3.5 oben: eine Temperaturgrenze, die Heizung bleibt dem thermischen Entwurf überlassen |
| Positiv und erreichbar | Vermeidet sie „not“, „never“, „always“, „100%“, wo eine messbare Grenze gemeint ist? | „The C&DH shall never lose a stored command.“ (beispielhaft) | „The C&DH shall execute each stored command within 1 second of the scheduled time.“ (4.2 wie geschrieben) |
| Begründung festgehalten | Sagt sie, warum der Wert gewählt wurde? | 3.1 ohne Begründung | Begründung: „Orbit-average load grew to 26 W after PDR; 30 W keeps 15% margin.“ |
| Verifikationsmethode und Kriterien | Ist die Methode gewählt und das Bestehenskriterium aus der Aussage abgeleitet? | 3.1: Methode Test; TC-06 erwartet Spitzenleistung ≥ 72 W | Bestehenskriterium über das Leistungsbudget abgeleitet: etwa 80,6 W Spitze für 30 W im Orbitmittel (siehe nächster Abschnitt) |
| Nach oben nachverfolgbar | Mit einem Bedarf, einem Elternelement oder einer Quellanforderung verknüpft? | 3.1 ohne vorgelagerten Link | 3.1 abgeleitet von 1.5 Daily Collection Volume |
| Einmalig | Sagt eine andere Anforderung dasselbe mit anderen Worten? | Ein zweites „The battery shall store 77 Wh“ im Thermalabschnitt (beispielhaft) | Eine Anforderung, 3.2 Battery Capacity, dort referenziert, wo sie gebraucht wird |
Eine Checkliste ist ein Werkzeug des Prüfers, keine Schreibvorlage. Lesen Sie jede Anforderung einmal gegen die ganze Liste, statt jeweils nach einer Regel zu suchen, und halten Sie den Befund mit der Regel fest, gegen die er verstößt, damit der Autor weiß, was zu ändern ist. Regeln haben auch Fehlalarme. Eine Wortlistenprüfung markiert „every“ in 1.6.1 als Allquantor, aber „every 3 days“ ist ein Zeitraum, keine Aussage über alle Fälle; ein Prüfer entscheidet.
Verifikationsmethode und Abnahmekriterien mit der Anforderung schreiben
Das Merkmal „verifizierbar“ lässt sich am leichtesten in dem Moment prüfen, in dem die Anforderung geschrieben wird: Kann der Autor nicht sagen, wie ihre Erfüllung gezeigt würde, ist sie nicht fertig. Halten Sie mit jeder Anforderung zwei Dinge fest.
- Verifikationsmethode: Test, Analyse, Inspektion oder Demonstration und die Integrationsebene, auf der sie durchgeführt wird (Komponente, Subsystem, System). EO-1 hat alle vier: 3.1 wird per Test verifiziert, 1.5 Daily Collection Volume per Analyse, 3.4 Bus Regulation per Inspektion und 6.1 Contact Scheduling per Demonstration. Der RVTM-Leitfaden erklärt, wie man zwischen ihnen wählt.
- Erfolgskriterien (Abnahmekriterien): das beobachtbare Ergebnis, das als erfüllt gilt, so formuliert, dass sich der Test oder die Analyse daraus schreiben lässt. Für 3.2 Battery Capacity: „Measured capacity of at least 77 Wh at C/2 and 20 °C.“ Für 6.2 Image Delivery: „Products on the portal within 6 h for 95% of passes in rehearsal.“
Die Kriterien neben die Aussage zu schreiben, fängt eine Fehlerklasse ab, die sonst erst am Ende gefunden wird. 3.1 von EO-1 wird durch TC-06 Solar Array Power Test verifiziert, der die Spitzenleistung an einem Solarsimulator misst und ab 72 W besteht. Die Anforderung betrifft jedoch die orbitgemittelte Leistung, und das Modell rechnet die eine mit dem Sonnenanteil (0,62) und dem Wirkungsgrad des Leistungspfads (0,6) in die andere um. 72 W Spitze ergeben 72 × 0,62 × 0,6 = 26,8 W im Orbitmittel, weniger als die ursprünglichen 28 W, von den aktuellen 30 W ganz zu schweigen. Die Testschwelle wurde nicht aus der Anforderung abgeleitet. TC-06 maß 75,1 W und „bestand“, doch 75,1 W entsprechen 27,9 W, unter beiden Werten. Wäre das Kriterium aus der Aussage geschrieben worden, hätte es etwa 30 / (0,62 × 0,6) = 80,6 W Spitze gelautet, und der Fehlbetrag wäre beim ersten Test sichtbar gewesen. Der Leitfaden zur Änderungsauswirkungsanalyse verfolgt denselben Befund durch die Änderung von 28 W auf 30 W.
Die Lehre lässt sich verallgemeinern: Ein Bestehenskriterium sollte sich durch nachprüfbare Rechnung auf den Wert der Anforderung zurückführen lassen, und die Rechnung gehört in die Begründung oder den Verifikationsplan, nicht ins Gedächtnis eines Ingenieurs.
Umgang mit TBD- und TBR-Werten
Früh in einem Projekt sind manche Werte noch nicht bekannt. Die Anforderung wegzulassen verbirgt die Lücke; eine Zahl zu erfinden verbirgt die Unsicherheit. Üblich ist, die Anforderung mit einem Platzhalter zu schreiben und den Platzhalter als offenen Punkt zu verfolgen.
- TBD (to be determined, noch festzulegen): noch kein Wert. „The thermal design shall keep the battery cell temperature at or above TBD °C while charging.“
- TBR (to be reviewed, manchmal „to be resolved“, noch zu bestätigen): ein bester aktueller Wert, der nicht bestätigt ist. „…within 60 seconds“, wobei 60 als TBR gekennzeichnet ist.
Ziehen Sie TBR mit einer Schätzung einem bloßen TBD vor, wo immer es eine Grundlage für eine Zahl gibt: Konstrukteure können mit einer Schätzung arbeiten, und ein Wert, der sich später verschiebt, ist eine Änderung, der die Nachverfolgbarkeit folgt. Jeder offene Punkt braucht drei Dinge, sonst wird er nicht gesteuert:
- Einen Verantwortlichen, die Person, die ihn schließen wird.
- Ein Fälligkeitsdatum oder einen Meilenstein, normalerweise vor den Entwurfsentscheidungen, die davon abhängen.
- Einen Abschlussplan: die Analyse, den Test oder die Entscheidung, die den Wert festlegt.
Die EO-1-Spezifikation hat drei offene Punkte. 3.5 Battery Thermal Control ist ein TBD des Thermal Engineer und bereits überfällig. 2.4 Target Slew („through 30 degrees within 60 seconds“) ist ein TBR des ADCS Lead, und 5.3 Downlink Link Margin („at least 3 dB link margin at 10 degrees elevation“) ist ein TBR des Comms Lead; beide tragen Arbeitswerte, die die Entwürfe verwenden, während die Analysen abgeschlossen werden.
Zählen Sie die offenen Punkte an jedem Meilenstein und erwarten Sie, dass die Zahl sinkt. Eine Anforderungs-Baseline mit vielen offenen TBDs ist nur dem Namen nach eine Baseline. Die Review-Kriterien im NASA Systems Engineering Handbook verlangen ab dem System Requirements Review, dass offene TBD- und TBR-Punkte mit einem Plan und Zeitplan für ihren Abschluss identifiziert sind. Die Verfolgung gehört in ein Attribut oder ein Register, nicht nur in den Text: Ein in einen Satz getipptes „TBD“ hat keinen Verantwortlichen und kein Datum, und nichts erinnert jemanden daran, es zu schließen.
Anforderungstypen
Anforderungen zu klassifizieren hilft Prüfern, die richtigen Fragen zu stellen, und hilft, die Menge vollständig zu halten. Die folgenden Kategorien sind die gängigen; ISO/IEC/IEEE 29148 und der INCOSE-Leitfaden beschreiben ähnliche Mengen, und viele Projekte ergänzen eigene.
| Typ | Was er festlegt | EO-1-Beispiel | Worauf zu achten ist |
|---|---|---|---|
| Funktional | Was das System tun muss | 4.3 Fault Detection: „The C&DH shall enter safe mode within 10 seconds of undervoltage detection.“ | Eine Funktion ohne angehängte Leistung; die meisten funktionalen Anforderungen brauchen auch ein „wie gut“, hier „within 10 seconds“ |
| Leistung | Wie gut eine Funktion erfüllt wird: Menge, Rate, Genauigkeit, Zeit | 2.1 Pointing Accuracy: „The ADCS shall point the payload boresight within 0.1 degrees of the commanded target.“ | Fehlende Bedingungen (welcher Modus, welche Lebensphase) und fehlende Grenzrichtung |
| Schnittstelle | Was eine Grenze zu einem anderen System oder Element überschreitet, und seine Eigenschaften | 5.2 UHF Command Uplink: „The UHF transceiver shall receive ground commands at 9.6 kbps.“ Die vollständige Definition steht im Schnittstellensteuerungsdokument. | Anforderungen, die das ICD wiederholen, statt darauf zu verweisen, sodass beide auseinanderlaufen |
| Randbedingung | Eine von außen auferlegte Grenze für den Entwurf oder dafür, wie das System gebaut wird | 4.4 Downlink Encryption: „The C&DH shall encrypt each downlink frame with 256-bit keys.“ Ihre Begründung: Der Kundenvertrag verlangt verschlüsselte Bilddaten bei der Übertragung, die Anforderung kommt also von außerhalb des Projekts, nicht aus einer Abwägung darin. | Entwurfsentscheidungen, die als Randbedingungen geschrieben sind, obwohl niemand von außen sie auferlegt hat |
| Umwelt, Zuverlässigkeit, Sicherheit | Bedingungen, die zu überstehen sind, und zu erreichende Verlässlichkeit | 1.7 Mission Lifetime: „The spacecraft shall operate in orbit for at least 730 days.“ | Werte ohne die Wahrscheinlichkeit oder Konfidenz, für die sie beansprucht werden |
Die Grenze zwischen funktionalen und Leistungsanforderungen verläuft oft innerhalb eines Satzes: Viele Anforderungen nennen eine Funktion mit ihrer Leistung, wie 4.3. Das ist in Ordnung, solange der Satz noch eine einzige Verpflichtung enthält. Schnittstellenanforderungen behandelt der Leitfaden zum Schnittstellensteuerungsdokument ausführlicher, die Funktionen hinter funktionalen Anforderungen der Leitfaden zur Funktionsanalyse.
Durchgearbeitetes Beispiel: Review der EO-1-Spezifikation
Ein Review von SRS-001 anhand der Checkliste teilt die 32 Anforderungen in drei Gruppen. Die meisten bestehen. Einige haben kleine Befunde, die je einen Satz wert sind. Drei müssen neu formuliert werden.
Eine automatische Prüfung derselben Spezifikation stimmt mit dem Review überein: 29 von 32 Anforderungen werden als gut bewertet, und die drei schwachen brauchen Nacharbeit. Die Befunde zu 2.5 nennen jede verletzte Regel mit Name und Nummer, und genau das braucht ein Autor, um sie zu beheben. Die Prüfung kennzeichnet auch, was sie nicht entscheiden kann: Bei 3.1 warten Korrektheit und Machbarkeit auf einen Prüfer, weil sich der Text nach dem letzten Review geändert hat.
Kleine Befunde
- 1.6.2 Off-Nadir Imaging, „up to 25 degrees off nadir“: „up to“ liest sich als Maximum, gemeint ist aber eine Fähigkeit, die das Raumfahrzeug bei jedem Winkel von 0 bis 25 Grad haben muss. Eine falsche Lesart würde einen Entwurf, der nur im Nadir aufnimmt, als konform gelten lassen.
- 1.6.1 Ground Track Repeat, „its ground track“: ein Pronomen mit nur einem möglichen Bezug, der Befund ist also gering. Das „every“ im selben Satz ist ein Fehlalarm einer Regel für Allquantoren.
- 1.5 Daily Collection Volume hat eine Methode (Analyse) und Erfolgskriterien („Simulated daily volume of at least 3.2 GB over a 30-day plan“), aber noch keine verknüpfte Analyse. Der Wortlaut ist in Ordnung; die Verifikation ist nicht erledigt.
- 3.1 Orbit Average Power ist gut geschrieben, aber ihr Text hat sich nach der Genehmigung geändert, daher brauchen ihre Korrektheit und Machbarkeit erneut das Urteil eines Prüfers. Die Machbarkeit ist die eigentliche Frage: Die Paneele im aktuellen Entwurf liefern etwa 28 W im Orbitmittel.
Drei Neuformulierungen
2.5 Safe Mode Recovery. „The spacecraft should recover from safe mode quickly and resume imaging as appropriate“ verletzt mindestens sechs Regeln: „should“ statt „shall“, zwei durch „and“ verbundene Verpflichtungen, „quickly“ ohne Wert, die Ausweichklausel „as appropriate“, kein abschließender Punkt und keine Verifikation. Die Neuformulierung behält das eine Ergebnis, auf das es dem Kunden ankommt, und gibt ihm einen Wert:
The spacecraft shall resume imaging within 6 hours of a safe mode entry.
Die Begründung sollte sagen, woher die 6 Stunden kommen (N1 verlangt Warnungen zu Pflanzenstress am selben Tag, und 6.2 lässt 6 Stunden vom Downlink bis zur Auslieferung zu). Zählen die Schritte der Wiederherstellung für sich, etwa die erneute Sonnenausrichtung oder das Melden der Ursache, wird jeder zu einer eigenen Anforderung. Methode: Test, per Fehlerinjektion am Flatsat; Erfolgskriterium: Die Aufnahmen werden bei jedem injizierten Eintritt in den Safe Mode innerhalb von 6 Stunden wieder aufgenommen.
3.5 Battery Thermal Control. „The thermal design shall keep the battery warm enough (TBD).“ hat einen vagen Begriff, ein TBD im Text und eine Klammer. Die Behebung trennt die Verpflichtung, den offenen Wert und den Grund:
The thermal design shall keep the battery cell temperature at or above 0 °C while charging.
Die 0 °C sind beispielhaft: Lithium-Ionen-Zellen werden üblicherweise nicht unter dem Gefrierpunkt geladen, aber die echte Grenze kommt aus dem Datenblatt der Zelle und der thermischen Analyse. Bis diese Analyse sie festlegt, ist der Wert ein TBR des Thermal Engineer, mit einem Fälligkeitsdatum vor dem Review des thermischen Entwurfs. Die Neuformulierung legt auch eine Lücke offen, die das Original verbarg: Es gibt keine Anforderung für den Temperaturbereich beim Entladen, der eine eigene Aussage braucht.
6.4 Operator Interface. „The operator interface shall be user friendly and/or easy to use.“ hat zwei subjektive Begriffe und ein „and/or“. Gebrauchstauglichkeit lässt sich spezifizieren, aber nur über beobachtbare Aufgaben:
The operator interface shall let a trained operator book a ground station contact in no more than 5 minutes.
Aufgabe und Zeit sind beispielhaft. Eine echte Menge würde die wenigen Aufgaben auflisten, die zählen (einen Kontakt buchen, eine Zielliste hochladen, die neueste Zustandstelemetrie lesen), jede mit einer Zeit und einer Fehlergrenze, gemessen in einer Demonstration mit Betreibern, die die Schulung abgeschlossen haben.
Häufige Fehler
| Fehler | Was schiefgeht | Besser |
|---|---|---|
| Entwurfslösungen als Anforderungen schreiben | Der Entwurf steht fest, bevor die Abwägung getroffen ist, und eine bessere Option wird ausgeschlossen, ohne dass jemand das entschieden hat. | Den Bedarf nennen („die Zellen beim Laden auf mindestens 0 °C halten“) und die Ebene darunter die Heizung wählen lassen. |
| Die Sprache der Stakeholder direkt in Anforderungen kopieren | „Aktuelle Bilder zweimal pro Woche“ ist ein Bedarf; so, wie es geschrieben ist, ist es nicht verifizierbar. | Den Bedarf behalten und eine Anforderung mit Wert und Bedingung schreiben, die ihn erfüllt (1.6 within 72 hours). |
| Mehrere Anforderungen in einem Absatz | Eine Kennung trägt mehrere Verpflichtungen, die sich einen Status, einen Test und ein Schicksal teilen. | Eine Anforderung je Element, ein „shall“ je Aussage. |
| Werte ohne Bedingungen | „30 W“ zu Lebensbeginn und am Lebensende sind verschiedene Entwürfe. | Modus, Lebensphase, Umgebung und Mittelung angeben. |
| Keine Begründung | Niemand kann eine spätere Änderung beurteilen, und die Anforderung überlebt ihren Grund lange. | Den Grund und die Zahlen hinter dem Wert aufschreiben. |
| Testschwellen, die nicht aus der Anforderung abgeleitet sind | Ein Test besteht, während die Anforderung nicht erfüllt ist (TC-06 mit 72 W Spitze gegen 28 W im Orbitmittel). | Das Erfolgskriterium rechnerisch aus der Aussage ableiten und festhalten. |
| TBD in den Text getippt und vergessen | Der offene Wert hat keinen Verantwortlichen und kein Datum und gelangt in die Baseline. | Jedes TBD und TBR mit Verantwortlichem, Fälligkeitsdatum und Abschlussplan verfolgen. |
| Gold Plating | Anforderungen, nach denen niemand gefragt hat, verbrauchen Entwurfs- und Testaufwand. | Prüfen, dass jede Anforderung der obersten Ebene auf einen Bedarf oder eine Quelle zurückgeht. |
| Übermäßiges Vertrauen in automatische Prüfungen | Eine saubere Wortprüfung wird für eine korrekte Anforderung gehalten. | Werkzeuge für die mechanischen Regeln nutzen; ein Mensch beurteilt korrekt, machbar und notwendig. |
In Holarch ausprobieren
In einem LML-Projekt ist jede Anforderung eine Entität der Klasse Requirement mit den oben beschriebenen Attributen: Rationale, Status, Priority, Criticality, Owner, Source, Verification Method, Verification Level, Success Criteria und die TBD/TBR-Felder.
- Legen Sie die Demo mit Projekte verwalten → Projektdateien ▾ → Neues Demoprojekt → CubeSat (Geführtes Systems Engineering) an. Ihre Spezifikation enthält die drei schwachen Anforderungen und die offenen TBD/TBR-Punkte, die dieser Leitfaden verwendet.
- Öffnen Sie Bedarfe & Anforderungen → Qualität, wählen Sie das Dokument in der Bereichsliste und klicken Sie auf Qualität prüfen. Jede Anforderung wird nach den neun Merkmalen bewertet, und die Vorschläge nennen die Regelnummern aus dem INCOSE-Leitfaden, die eine Wortliste oder ein Muster prüfen kann. Korrekt und Machbar brauchen einen Prüfer: Klicken Sie auf die Markierung, um die Entscheidung festzuhalten.
- Formulieren Sie 2.5 wie oben neu und führen Sie die Prüfung erneut aus. Die Befunde zu Verknüpfung, Ausweichklausel und vagen Begriffen verschwinden.
- Öffnen Sie Bedarfe & Anforderungen → TBD/TBR, um die offenen Punkte mit Verantwortlichen und Fälligkeitsdaten zu sehen, und Schließen Sie einen, sobald sein Wert feststeht.
- Für eine zweite Meinung zu den Merkmalen, die eine Regel nicht entscheiden kann, verwenden Sie ✦ KI ▾ → KI-Anforderungsprüfung; jedes Urteil und jede Neuformulierung wird zur Prüfung angezeigt, bevor sich etwas ändert.
Die vollständige Referenz steht in der Dokumentation zu Anforderungsqualität und zum TBD/TBR-Register.
Die Checkliste herunterladen
Die Checkliste zur Anforderungsqualität mit EO-1-Beispielen vorher und nachher (CSV) enthält die Regeln der Checkliste mit ihren Prüffragen und Beispielen, zur Verwendung in einem Review oder als Ausgangspunkt für die eigenen Schreibregeln eines Projekts. Dieselbe Datei bietet auch der Leitfaden zur Nachverfolgbarkeit an.
Fragen zum Schreiben von Anforderungen
Shall, must oder will?
Jede Konvention funktioniert, wenn die Spezifikation sie definiert und einhält. Die verbreitetste verwendet „shall“ für verbindliche Anforderungen, „will“ für Tatsachen und Absichten zu Dingen außerhalb des Systems und „should“ für Ziele, die nicht verifiziert werden. Manche behördlichen Stilleitfäden bevorzugen aus Gründen der Verständlichkeit „must“. Das eigentliche Problem ist, sie innerhalb einer Spezifikation zu mischen.
Wie viele Anforderungen sollte ein System haben?
Es gibt keine richtige Zahl. Ein kleines Raumfahrzeug hat vielleicht einige Dutzend Systemanforderungen und einige Hundert darunter; ein großes Programm hat Tausende. Nützlicher sind die Fragen, ob jede Anforderung auf einen Bedarf oder ein Elternelement zurückgeht und ob jeder Bedarf Anforderungen unter sich hat.
Sind User Stories Anforderungen?
Eine User Story hält einen Bedarf und seinen Zweck in den Worten des Nutzers fest. Sie spielt die Rolle eines Stakeholder-Bedarfs, und ihre Abnahmekriterien liegen nahe an Verifikationskriterien. Für ein System, das als Hardware und Software zusammen gebaut, integriert und verifiziert wird, müssen die Stories trotzdem in Anforderungen übersetzt werden, die sich zuteilen und testen lassen.
Kann ein Werkzeug die Qualität von Anforderungen prüfen?
Ein Werkzeug kann die mechanischen Regeln zuverlässig prüfen: Modalverben, Verknüpfungswörter, vage Wörter, Ausweichklauseln, Pronomen, fehlende Links. Es kann nicht wissen, ob 30 W der richtige Wert ist oder ob die Paneele ihn liefern können. Nutzen Sie die automatische Prüfung, um die mechanischen Befunde vor einem Review zu beseitigen, damit die Prüfer ihre Zeit auf Korrektheit und Machbarkeit verwenden.
Wie es weitergeht
- Nachverfolgbarkeit von Anforderungen und Änderungsauswirkungen: diese Anforderungen mit Bedarfen, Entwurf und Tests verknüpfen und eine Änderung verfolgen.
- Funktionsanalyse: die Anforderungen in Funktionen übersetzen und diese zuteilen.
- Anforderungs-Verifikationsmatrix: die Verifikationsmethode für jede Anforderung planen und die Ergebnisse festhalten.
- Bedarfe und Anforderungen in Holarch: Dokumente, Qualitätsprüfungen, Baselines und Nachverfolgbarkeit in einem Modell.