mrcha033/skills

Advisor Review

Utilisez les scripts fournis dans ce répertoire de compétence. Une invocation explicite est un verrou : exécutez le réviseur dans la même tâche parente avant une réponse finale substantielle ou une action qui suit ou entre en conflit avec la revue. La collecte d’éléments en lecture seule peut se poursuivre pendant la construction du dossier.

Ne cherchez pas dans le catalogue global d’outils un conseiller. N’ouvrez pas une seconde tâche visible par l’utilisateur. La seule exécution enfant est le processus codex exec isolé démarré par scripts/run_advisor.py.

Prérequis

Nécessite l’exécution shell, un CLI codex local authentifié, l’accès à la route de modèle demandée gpt-5.6-sol et un accès sortant à l’API Codex depuis le shell parent. Un sandbox parent qui bloque le réseau des sous-processus bloque également le réviseur imbriqué. Si un prérequis est manquant, signalez que la revue indépendante est bloquée ; n’affaiblissez pas le sandbox sans autorisation de l’utilisateur ou de la tâche.

L’exécuteur n’est pas une barrière de confidentialité. Nettoyez les preuves et artefacts avant de construire le dossier.

Workflow

1. Annoncez que l’Advisor Review est utilisé et pourquoi.

2. Sélectionnez une phase :

   • plan : challenger une approche proposée.
   • stuck : diagnostiquer un travail en échec ou en boucle.
   • pivot : comparer une approche sensiblement différente.
   • final : auditer un travail terminé et ses preuves finales.

3. Lisez references/context-contract.md.

4. Choisissez le mode de contexte :

   • packet : des faits courts ancrés aux sources suffisent.
   • bundle : des artefacts textuels nettoyés (logs, chronologies, diffs) affectent sensiblement le diagnostic.

5. Construisez advisor-context-2.0 avec scripts/build_context_packet.py.

   • Pour stuck, incluez les actions et résultats exacts dans l’ordre chronologique.
   • Donnez une source concrète à chaque fait observé.
   • Incluez les résultats négatifs, les états contradictoires et les limitations du contexte.
   • Ne tronquez jamais silencieusement un texte critique pour la décision. Un échec du constructeur est une revue bloquée.

6. Lisez references/review-rubric.md.

7. Sélectionnez l’effort :

   1. Honorez une demande explicite de high, xhigh ou max.
   2. Utilisez max uniquement pour une revue la plus approfondie explicitement demandée ou une décision critique, difficile à annuler, présentant une ambiguïté majeure non résolue.
   3. Utilisez xhigh pour des défaillances inter-composants, des preuves vérifiées contradictoires, deux approches échouées ou plus, des pivots majeurs, ou des affirmations d’achèvement à fort impact.
   4. Sinon, utilisez high.

8. Exécutez exactement une revue isolée par défaut et sauvegardez son reçu :

   python3 scripts/run_advisor.py \
     --input context-packet.json \
     --effort xhigh \
     --output advisor-receipt.json
   

   Conservez le reçu renvoyé dans la tâche invocatrice. Un reçu produit dans une autre tâche visible par l’utilisateur n’est pas un transfert.

9. Vérifiez le reçu :

   • request.requested_model doit être gpt-5.6-sol.
   • request.requested_effort doit correspondre à l’effort sélectionné.
   • observed_model et observed_effort peuvent être null ; le CLI actuel n’expose pas de manière fiable l’identité côté service. Ne décrivez jamais l’identité demandée comme une identité réelle vérifiée.
   • Toute erreur d’exécution, échec de schéma, dépassement de délai ou incohérence de hachage de contexte bloque la revue.
   • L’enfant isolé utilise un CODEX_HOME temporaire avec uniquement le fichier d’authentification hôte lié lorsqu’il est présent. Il désactive également les plugins, le chargement distant de plugins, la recherche de compétences et l’exécution multi-agents, de sorte que les catalogues de compétences non liés ne peuvent pas consommer le contexte de la revue.

10. Lisez references/decision-contract.md. Résolvez chaque recommandation R# comme adopt, reject ou defer, puis exécutez :

    python3 scripts/validate_decision.py \
      --receipt advisor-receipt.json \
      --decision advisor-decision.json
    

11. N’agissez pas sur les recommandations du conseiller tant que l’enregistrement de décision n’est pas validé. Une recommandation destructive nécessite en outre une autorisation utilisateur confirmée.

12. Continuez la tâche parente en utilisant l’action suivante validée et la condition d’arrêt.

Règles pour le travail bloqué

• Diagnostiquez avant de modifier l’état.
• Distinguez la frontière d’exécution : tâche parente, processus réviseur isolé et toute autre tâche visible par l’utilisateur sont séparés.
• Ne laissez pas le reçu d’une tâche distincte remplacer un transfert dans la même tâche.
• Préférez une expérience en lecture seule ou réversible qui sépare les hypothèses concurrentes.
• Après une correction répétée de l’utilisateur, ne répétez pas la même prescription sans nouvelle preuve.
• N’élargissez pas le périmètre d’un sous-système défaillant aux plugins, services, dépôts ou packages, sauf si des preuves les relient.

Budget de revue

Utilisez une revue par défaut. Une seconde n’est autorisée que lorsque de nouvelles preuves modifient sensiblement la décision ou qu’une contre-vérification finale à haut risque est justifiée. Une troisième n’est autorisée que pour concilier un conflit concret. Ne créez jamais une boucle de revue ouverte.

Barrière de modification du comportement de la compétence

Lors de la modification d’Advisor Review elle-même, exécutez les tests déterministes et au moins un fixture de comportement nettoyé :

python3 scripts/evaluate_advisor_behavior.py \
  --fixture behavior-fixture.json \
  --receipt advisor-receipt.json

Utilisez des fixtures appariés ancien/nouveau lorsque c’est pratique. Jugez la détection, le lien des preuves, les expériences bornées et le taux d’actions risquées – pas la similarité du texte.

Rapport

Rapportez :

• la phase, le mode de contexte, le modèle Sol demandé, l’effort demandé et le statut de vérification d’identité ;
• le verdict du conseiller et le diagnostic lié aux preuves ;
• la disposition (adopt/reject/defer) de chaque recommandation importante ;
• l’action suivante sélectionnée et la condition d’arrêt ;
• les risques non résolus ou les limitations du contexte.

Appelez le résultat une revue indépendante de style conseiller, pas une parité avec Claude Advisor.