Ingenieursphilosophie
Wählen Sie die Disziplinen aus, die für die aktuelle Aufgabe benötigt werden. Dieses Skill ist ein Routing-Leitfaden, keine universelle Checkliste. Halten Sie Verantwortlichkeiten auch dann getrennt, wenn mehrere Disziplinen gemeinsam angewendet werden.
Befugnis und Geltungsbereich
Der aktive Agent und die Aufgabe definieren Berechtigungen, Umfang, Git-Richtlinie, Delegierung und Ausgabeformat. Weder dieses Skill noch seine Referenzen erweitern diese Befugnis.
Das Lesen von Implementierungsanleitungen berechtigt nicht zu Bearbeitungen, Tests, Commits oder Veröffentlichungen. Ein reiner Lese-Review bleibt read-only. Eine Recherche- oder Schreibaufgabe wird nicht zur Implementierungsaufgabe. Wenden Sie Projektverträge vor stilistischen Standardwerten an. Diese Grundsätze berechtigen nicht zu nicht zusammenhängenden Arbeiten.
Referenzen auswählen und lesen
- Identifizieren Sie die aktuelle Tätigkeit und das betroffene Verhalten.
- Beziehen Sie Referenzen ein, die vom aktiven Agenten ausdrücklich gefordert werden.
- Wählen Sie aus den folgenden Tabellen zusätzliche Referenzen aus, wenn deren Bedingungen zutreffen.
- Lesen Sie jede ausgewählte Referenz vor der entsprechenden Arbeit. Nennen Sie sie nicht nur als geladen.
- Überdenken Sie die Auswahl, falls sich die Aufgabe ändert. Verwenden Sie bereits gelesene Referenzen erneut, sofern sich ihr Inhalt nicht geändert hat.
Alle nachfolgenden Pfade sind relativ zum Skill-Verzeichnis engineering-philosophy.
Eine generierte Kopie von Anweisungen ändert dieses Basisverzeichnis nicht.
Es handelt sich um Referenzdateien, nicht um unabhängig ladbare Skills.
Laden Sie bei Bedarf mehrere Referenzen, aber nicht automatisch alle sieben. Eine Referenz kann auf eine andere Disziplin verweisen, ohne dass diese für jede Aufgabe erforderlich ist. Lesen Sie eine verlinkte Referenz, wenn deren Anleitung benötigt wird, nicht nur weil ein Link existiert.
Wie die Arbeit ausgeführt wird
| Disziplin | Lesen, wenn | Referenz |
|---|---|---|
| Implementierung | Softwareänderungen einschließlich Konfiguration und Agentenanweisungen implementiert oder geprüft werden. | Implementierung |
| Review | Code, Patches, Dateien oder frühere Ergebnisse überprüft werden. | Review |
| Recherche | Externe Fakten, API-Verhalten, Kompatibilität oder Technologieentscheidungen geklärt werden. | Recherche |
| Schreiben | Dauerhafte technische Prosa oder agentengerichtete Anweisungen erstellt oder überarbeitet werden. | Schreiben |
Welche Anforderungen das Ergebnis erfüllen soll
| Disziplin | Lesen, wenn | Referenz |
|---|---|---|
| Code | Logik, Transformationen, Validierung, Zustandsübergänge oder Fehlerpfade implementiert oder geprüft werden. | Code |
| Architektur | Grenzen, Zuständigkeiten, Abhängigkeiten, Schnittstellen oder komponentenübergreifende Auswirkungen entworfen oder geprüft werden. | Architektur |
| Frontend | UI, Styling, Barrierefreiheit, Interaktion oder reaktionsfähiges Verhalten entworfen oder geprüft werden. | Frontend |
Aktivitäts- und Ergebnisdisziplinen kombinieren sich. Beispielsweise kann eine UI-Implementierung die Disziplinen Implementierung, Code und Frontend erfordern. Ein Code-Review verwendet die Disziplinen Review und relevante Ergebnisdisziplinen, ohne Implementierungsaufgaben zu übernehmen. Ein reiner Dokumentationsauftrag kann die Disziplin Schreiben verwenden, ohne Code oder Frontend zu laden.
Zuständigkeit und Berichterstattung
Jede Referenz ist Eigentümer ihrer Disziplin. Duplizieren Sie deren Regeln nicht in diesem Einstiegspunkt oder in Agenten-Definitionen.
code-review bleibt der separate Eigentümer der Review-Prozedur, der Schweregrad-Schwellenwerte, der Entscheidungen und des Berichtsformats.
asd-ste100 bleibt getrennt und ist Eigentümer seiner anwendbaren Regeln für kontrollierte Sprache.
Verwenden Sie nur relevante Grundsätze aus den tatsächlich gelesenen Referenzen. Erstellen Sie nicht standardmäßig einen Compliance-Bericht über alle sieben Disziplinen. Folgen Sie dem Berichtsformat des aktiven Agenten. Unterscheiden Sie beobachtete Nachweise, gelieferte Ergebnisse und nicht verifizierte Annahmen. Falls eine erforderliche Referenz nicht verfügbar ist, nennen Sie sie und erläutern Sie die daraus resultierende Einschränkung. Behaupten Sie nicht, ungelesene Anleitungen angewendet zu haben.