Que fait Codeck ?
Utilisez Codeck comme pont d'exécution pendant que l'agent de codage courant reste l'hôte et le modérateur. Considérez le sélecteur de modèle d'un produit hôte comme non lié : changer le modèle de chat actif n'est pas la même chose que consulter des modèles externes via Codeck.
Choisir le workflow
- Utilisez un seul
askpour un deuxième avis en lecture seule de la part d'un exécuteur nommé. - Utilisez un council pour des avis indépendants provenant de deux ou plusieurs fournisseurs de modèles véritablement différents.
- Utilisez
delegateuniquement lorsque l'utilisateur demande explicitement à un exécuteur externe d'implémenter des modifications. - Utilisez
pickavantautolorsque le routage est incertain.
Ne décrivez jamais un seul modèle jouant plusieurs rôles comme un consensus multi-modèles. Étiquetez-le single-model-multi-role.
Pré-vol
- Exécutez
command -v codeck. - S'il est indisponible, arrêtez-vous et expliquez que la CLI Codeck est requise. Ne l'installez pas sans autorisation de l'utilisateur.
- Exécutez
codeck doctoretcodeck listdans le projet cible. - Utilisez uniquement des exécuteurs sains et configurés dont le mode et les permissions déclarés correspondent à la tâche.
- Si le projet n'est pas initialisé, demandez avant d'exécuter
codeck initcar cela crée des fichiers.codeck/.
Lisez references/providers.md lors de la configuration des exécuteurs, du choix des fournisseurs pour un réseau régional, ou pour expliquer pourquoi un modèle demandé est indisponible.
Préparer le transfert
Rédigez un bref document Markdown compact pour un travail non trivial. Incluez l'objectif, les contraintes, les questions, les critères d'acceptation et uniquement les fichiers nécessaires au modèle externe. Préférez une pièce jointe plutôt que d'intégrer un long brief dans la commande :
codeck ask <executor> "Lisez le brief de tâche ci-joint et fournissez une revue basée sur des preuves." -f task.md
N'incluez pas de secrets, d'identifiants, de fichiers sources non liés ou de données utilisateur privées. Informez l'utilisateur lorsque le contenu de la tâche quittera le produit hôte et sera envoyé à un autre fournisseur.
Lisez references/artifacts.md pour le schéma du brief d'entrée et de l'artefact final.
Exécuter un council multi-modèles
- Gardez l'agent de codage actuel comme modérateur.
- Sélectionnez au moins deux exécuteurs sains soutenus par des fournisseurs distincts. Privilégiez l'adéquation des capacités et la disponibilité plutôt que l'ordre des marques.
- Donnez à chaque expert du premier tour les mêmes faits et la question centrale, ainsi qu'un rôle de révision distinct.
- Recueillez les réponses du premier tour de manière indépendante avant d'exposer la réponse d'un expert à un autre.
- Extrayez les affirmations, les preuves, les hypothèses, les risques et les désaccords.
- Posez des questions de suivi ciblées uniquement sur les désaccords importants. Joignez les résultats précédents pertinents sous forme de fichiers Markdown.
- Arrêtez-vous lorsque les critères d'acceptation sont remplis, que les désaccords restants sont explicitement documentés, ou que la limite de tours configurée est atteinte.
- Produisez
report.md,summary.mdetdecisions.jsonlorsque la rédaction d'artefacts est dans le périmètre ; sinon, renvoyez la même structure dans la réponse.
Utilisez codeck compare <executor-a>,<executor-b> "<task>" -f task.md lorsque tous les experts doivent recevoir la même invite. Utilisez des appels codeck ask séparés lorsque les rôles ou les questions de suivi diffèrent. Ne revendiquez pas une exécution parallèle à moins que l'exécution observée n'ait réellement eu lieu simultanément.
Lisez references/moderation.md pour les invites de rôle, la gestion des désaccords et les règles de convergence.
Router en toute sécurité
- Par défaut, utilisez
ask, qui est destiné à la consultation en lecture seule. - N'ajoutez pas
-yet n'appelez pasdelegateà moins que l'utilisateur n'ait autorisé l'implémentation externe. - Traitez les champs de permission comme des déclarations, sauf si la CLI sous-jacente applique également un bac à sable.
- Ne remplacez pas silencieusement un fournisseur. Signalez l'exécuteur demandé, l'exécuteur/fournisseur réel et la raison du repli.
- Ne codez pas en dur les ID de modèle actuels. Découvrez-les ou lisez-les à partir de la configuration locale car les noms des modèles des fournisseurs changent.
- Si moins de deux fournisseurs distincts sont disponibles, continuez uniquement en tant que consultation mono-modèle et énoncez la limitation.
- Conservez les sorties externes brutes ou les ID d'exécution Codeck afin que la synthèse reste vérifiable.
Retourner le résultat
Commencez par la conclusion du modérateur. Indiquez ensuite :
- quels exécuteurs et fournisseurs sous-jacents ont réellement fonctionné ;
- où ils étaient d'accord et en désaccord ;
- quelles preuves soutiennent la décision ;
- les risques non résolus et la vérification recommandée ;
- tout repli, échec, utilisation estimée ou limitation régionale.
Gardez le résumé court et orienté vers la décision. Conservez le raisonnement détaillé et l'attribution des sources dans le rapport complet.