Bonnes pratiques pour DeepSeek Harness

Séparer les faits sur le produit de la politique de l'équipe

Lire une petite portée avant d'agir

1. 01

   Lire les instructions du projet en premier

   Localiser les fichiers d'instructions au niveau du dépôt et imbriqués, puis identifier quelles règles s'appliquent au chemin cible.

2. 02

   Inspecter seulement la surface pertinente

   Lire les fichiers cibles, les tests, la configuration et les changements locaux récents avant d'élargir la recherche.

3. 03

   Indiquez le changement prévu et la preuve

   Nommez les fichiers concernés, le résultat observable attendu, la commande de vérification et le point de restauration.

4. 04

   Travaillez par incréments réversibles

   Effectuez un changement cohérent à la fois et examinez la différence avant de passer à la limite suivante.

Utilisez l'ensemble d'autorisations efficace le plus restreint

Garder les identifiants en dehors des invites et des dépôts

• Ne transmettez que les informations d'identification minimales requises pour l'opération en cours, de préférence via un fournisseur restreint ou un jeton à durée de vie courte.
• Ne collez pas de secrets dans le chat, les instructions de projet, les journaux, les captures d'écran, les fixtures ou les fichiers d'environnement commis.
• Avant de partager un diff ou un artefact, analysez les modifications suivies et non suivies pour détecter les secrets et les chemins locaux sensibles.
• Si une exposition est possible, révoquez ou faites pivoter d'abord; la suppression d'un fichier n'invalide pas un identifiant copié.

Concevez chaque modification pour permettre un retour en arrière

1. 01

   Capturez la base de référence

   Enregistrez la révision actuelle, la configuration, les tests et tout état externe que l'opération peut modifier.

2. 02

   Privilégiez les opérations non destructives

   Utilisez des upserts ciblés, des migrations additives, des déplacements de fichiers récupérables et des cibles exactes au lieu de suppressions ou réinitialisations larges.

3. 03

   Inspectez la différence complète

   Séparez les modifications prévues du travail utilisateur préexistant et confirmez que les fichiers générés correspondent à leur source.

4. 04

   Testez la récupération là où l’échec importe

   Pour les packages, migrations ou déploiements, exercez la désinstallation, la migration inverse, le retour à une version précédente ou la restauration à partir d’un snapshot avant la publication.

Vérifiez le comportement réel, pas une affirmation de complétion

1. Exécutez le test limité qui prouve le comportement modifié.
2. Exécutez les vérifications de type, format, compilation et régressions plus larges appropriées au risque.
3. Testez le build de production et le navigateur, le runtime, la base de données ou le chemin de paquet réellement concerné.
4. Inspectez la console, le réseau, les journaux, les résultats de la base de données et les artefacts de sortie au lieu de vous fier uniquement à un code de sortie.
5. Enregistrez les échecs honnêtement; une nouvelle tentative n’est une preuve que lorsque la cause originale est comprise.

Traitez les Skills et les plugins comme des composants de la chaîne d'approvisionnement

Un Skill est un ensemble d'instructions réutilisable, tandis qu'un plugin peut ajouter des capacités exécutables. Avant utilisation, examinez la source et les capacités demandées, épinglez si possible une version immuable, vérifiez les licences et les sommes de contrôle, testez en isolation, documentez la responsabilité et définissez une procédure de mise à jour et de suppression. Réexaminez les modifications au lieu d'accorder une confiance permanente à un nom.

Diagnostiquez les échecs depuis la frontière vers l'intérieur

1. Reproduisez avec l’entrée la plus petite possible et un espace de travail propre ou jetable.
2. Confirmez le Profile actif, les versions des plugins, la configuration du fournisseur, la racine de l'espace de travail, le permission preset et le niveau d'application de la sandbox signalé.
3. Séparez les problèmes de sortie du modèle des échecs liés à l’outil, au shell, au réseau, aux identifiants, UI ou à la persistance.
4. Inspectez les événements et journaux structurés, puis comparez-les avec une base connue correcte.
5. Changez une variable, relancez la même preuve et conservez les preuves de l’échec jusqu’à ce que la cause soit établie.