Best Practices für DeepSeek Harness

Trennen Sie Produktfakten von Teamrichtlinien

Prüfen Sie vor dem Handeln einen kleinen Bereich

1. 01

   Lesen Sie zuerst die Projektanweisungen

   Lokalisieren Sie Repository- und verschachtelte Anweisungsdateien und identifizieren Sie dann, welche Regeln auf den Zielpfad angewendet werden.

2. 02

   Untersuchen Sie nur den relevanten Bereich

   Lesen Sie die Zieldateien, Tests, Konfiguration und kürzliche lokale Änderungen, bevor Sie die Suche ausweiten.

3. 03

   Nennen Sie die beabsichtigte Änderung und den Nachweis

   Nennen Sie die Dateien im Umfang, das erwartete beobachtbare Ergebnis, den Überprüfungsbefehl und den Wiederherstellungspunkt.

4. 04

   Arbeiten Sie in reversiblen Schritten

   Nehmen Sie jeweils eine kohärente Änderung vor und prüfen Sie den Unterschied, bevor Sie zur nächsten Grenze übergehen.

Verwenden Sie das kleinste wirksame Berechtigungsset

Bewahren Sie Anmeldeinformationen außerhalb von Eingabeaufforderungen und Repositories auf

• Geben Sie nur die minimal erforderliche Berechtigung für die aktuelle Operation weiter, vorzugsweise über einen scoped Provider oder ein kurzlebiges Token.
• Fügen Sie keine Geheimnisse in Chat, Projektanweisungen, Protokolle, Screenshots, Fixtures oder committete Umgebungsdateien ein.
• Bevor Sie einen Diff oder ein Artefakt teilen, scannen Sie verfolgte und nicht verfolgte Änderungen auf Geheimnisse und sensible lokale Pfade.
• Wenn eine Offenlegung möglich ist, widerrufen oder rotieren Sie zuerst; das Löschen einer Datei macht eine kopierte Anmeldeinformation nicht ungültig.

Entwerfen Sie jede Änderung für eine Rücknahme

1. 01

   Erfassen Sie die Basislinie

   Zeichnen Sie die aktuelle Revision, Konfiguration, Tests und jeden externen Zustand auf, den die Operation ändern könnte.

2. 02

   Bevorzugen Sie nicht-destruktive Operationen

   Verwenden Sie gezielte Upserts, additive Migrationen, wiederherstellbare Dateiverschiebungen und exakte Ziele anstelle von umfassenden Löschungen oder Zurücksetzungen.

3. 03

   Untersuchen Sie den vollständigen Diff

   Trennen Sie beabsichtigte Änderungen von bereits vorhandener Benutzerarbeit und bestätigen Sie, dass generierte Dateien mit ihrer Quelle übereinstimmen.

4. 04

   Testen Sie die Wiederherstellung, wo ein Fehler relevant ist

   Bei Paketen, Migrationen oder Bereitstellungen üben Sie Deinstallation, Rückmigration, Versionsrollback oder Snapshot-Wiederherstellung vor der Freigabe aus.

Prüfen Sie das tatsächliche Verhalten, nicht nur eine Abschlussbehauptung

1. Führen Sie den spezifischen Test durch, der das bearbeitete Verhalten nachweist.
2. Führen Sie Typ-, Format-, Build- und umfassendere Regressionstests durch, die dem Risiko angemessen sind.
3. Testen Sie den Produktions-Build und den tatsächlich beteiligten Browser, Laufzeit, die Datenbank oder den Paketpfad.
4. Überprüfen Sie Konsole, Netzwerk, Protokolle, Datenbankergebnisse und Ausgabeartefakte, anstatt sich nur auf einen Exit-Code zu verlassen.
5. Erfassen Sie Fehler ehrlich; ein erneuter Versuch gilt nur dann als Beweis, wenn die ursprüngliche Ursache verstanden wird.

Behandeln Sie Skills und Plugins als Bestandteile der Lieferkette

Eine Fähigkeit ist ein wiederverwendbares Anweisungspaket, während ein Plugin ausführbare Funktionen hinzufügen kann. Vor der Verwendung sollten die Quelle und die angeforderten Funktionen überprüft, wenn möglich eine unveränderliche Version festgelegt, Lizenzen und Prüfsummen überprüft, Tests in Isolation durchgeführt, Eigentum dokumentiert und ein Aktualisierungs- sowie Entfernungspfad definiert werden. Änderungen erneut überprüfen, anstatt einem Namen dauerhaftes Vertrauen zu schenken.

Diagnostizieren Sie Fehler von der Grenze nach innen

1. Reproduzieren Sie mit der kleinsten Eingabe und einem sauberen oder verworfenen Arbeitsbereich.
2. Bestätigen Sie das aktive Profil, die Plugin-Versionen, die Anbieter-Konfiguration, das Stammverzeichnis des Arbeitsbereichs, das Berechtigungsprofil und die gemeldete Sandbox-Durchsetzung.
3. Trennen Sie Modellausgabeprobleme von Werkzeug-, Shell-, Netzwerk-, Berechtigungs-, UI- oder Persistenzfehlern.
4. Überprüfen Sie strukturierte Ereignisse und Protokolle und vergleichen Sie sie anschließend mit einer als gut bekannten Basislinie.
5. Ändern Sie eine Variable, führen Sie denselben Beweis erneut aus und bewahren Sie die fehlgeschlagenen Belege auf, bis die Ursache festgestellt ist.