Communitygithub.com

cookys/autopilot

Pipeline multi-foreman pour expédier un plan ou un bundle BACKLOG : de la sonde à la release poussée, via des contremaîtres Sonnet en arrière-plan et des mains hétérogènes, avec le chinois traditionnel comme déclencheur.

Qu'est-ce que autopilot ?

Cette compétence met en œuvre un pipeline multi-foreman pour expédier un plan ou un bundle BACKLOG de manière fiable, en utilisant des contremaîtres Sonnet en arrière-plan. Elle est principalement conçue pour les agents logiciels comme Claude Code, Cursor ou Codex, et se déroule en plusieurs étapes : sonde, planification, review, contremaître d'implémentation, contremaître de landing, vérification, et contremaître de clôture. Chaque étape produit des preuves traitées par l'agent suivant, mais seul l'opérateur humain (depth-0) a l'autorité d'accepter ou de refuser un résultat. L'ensemble du pipeline est écrit en chinois traditionnel et s'appuie sur des templates (dans `templates/*.md`), des règles stockées dans des fichiers de référence, et des mécanismes de vérification rigoureux (review combinée, test de gel, vérification de clone). Le but est d'éviter les erreurs coûteuses (comme l'envoi d'un commit shadow ou l'oubli de hooks Git) et de garantir que chaque livraison passe par toutes les étapes de qualité, y compris une revue combinée unique et une clôture complète jamais sautée.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/cookys/autopilot/tree/HEAD/.claude/skills/foreman-landing-pipeline

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

pipeline-foreman-debarquement

Pipeline multi-foreman pour expédier un plan ou un bundle BACKLOG : sonde → review du plan → contremaître d'implémentation → contremaître de landing → vérification profondeur-0 entre chaque étape → contremaître de clôture. depth-0 reste la seule autorité qui accepte un résultat ; la sortie de chaque foreman est une preuve, jamais un verdict.

0. Pré-travail (avant qu'aucun foreman n'existe)

  • Sonder toute information de plateforme dont le plan dépend et que vous n'avez pas vérifiée cette session par URL ou en exécutant l'outil réel (voir le projet CLAUDE.md "Ne pas" §). Une information non vérifiée est un candidat Spike, pas un fait — mettez-la dans le plan comme tel, ou sondez-la d'abord.
  • Écrire le plan, puis le passer dans la boucle de review du plan (autopilot:hetero-review → dispatch-plan-review), pas le jugement de cette compétence elle-même :
    • Rubrique figée par génération ; un changement de président nécessite l'approbation de l'opérateur, pas l'initiative d'un foreman.
    • Les décisions G1 sont contraignantes — chaque élément accepté est dans le périmètre des contraintes globales du brief d'implémentation, textuellement.
    • Au maximum G2. Si un élément de la rubrique est rejeté en G1, remplacez-le par un nouvel identifiant logique et un ticket plutôt que de ressusciter l'ancien.
    • Exécutez le test de gel avant de traiter le plan comme implémentable.
    • Une réparation limitée après le gel est autorisée pour les défauts que le test de gel lui-même révèle — pas une réouverture d'éléments de rubrique déjà jugés.

1. Contremaître d'implémentation

Dépêchez un foreman Sonnet en arrière-plan (Engine: sonnet en-tête — dispatch-model-guard refuse une dépêche sans cela) depuis templates/implement-brief.md. Jugement pour le brief :

  • Un clone, jamais le checkout principal. Le clone porte un commit fantôme ("PARALLEL-RUN LOCAL ONLY — enforcement_mode shadow mission_convergence, jamais atterrir") pour que dispatch-hetero.sh ne refuse pas sous le régime Mission. Mettez le commit fantôme dans le brief lui-même, lors de la configuration, écrit par depth-0 — ne l'envoyez jamais au foreman dans un message de suivi. Un message de suivi n'est pas une autorisation ; un commit fantôme refusé ou mal appliqué est ce que le coût de la vague-1b a engendré.
  • Lignes empilées : la base de chaque main = la tête acceptée de la ligne précédente (sa tête de réparation si réparée). Un commit de main par ligne, test RED d'abord, Verify exécute la propre suite de la ligne plus toutes les suites CONSOMMATEUR du contrat touché — pas seulement la suite du bundle.
  • La review par ligne a lieu ici, mais traitez-la comme nécessaire et non suffisante — voir §2 pour la review combinée.
  • Les échecs de rail (quota, 402, readiness, "Impossible d'utiliser ce modèle") sont des RAIL-FAIL, pas une raison pour que le foreman écrive du code lui-même.

1b. Dimensionner la forme avant l'envoi (2026-10-02/03)

  • Les lignes indépendantes s'exécutent en parallèle, pas empilées : une main Sonnet par ligne dans son propre répertoire de travail d'un clone, depuis templates/hand-brief-common.md. Empilez uniquement les vraies dépendances. Sept lignes S parallèles ont atterri en ~1 h ; un bundle de mains bon marché empilé de la même taille a pris ~3 h.
  • Choix de la main : les lignes volumineuses ou qui touchent aux signaux, pièges ou sandboxing reçoivent une main Sonnet (Agent, modèle sonnet), pas une main de rail bon marché — 6/7 lignes de main bon marché ont eu besoin d'un tour de réparation.
  • Ne sautez jamais la review par ligne pour gagner du temps : v2.36.108 l'a sautée et trois problèmes n'ont été découverts qu'à la review combinée, chacun coûtant un tour d'atterrissage.
  • Le balayage des consommateurs incluant L1 fait partie du Verify de chaque main (le modèle dit comment) ; une main qui exécute seulement sa suite bash repousse l'échec à la porte d'atterrissage.
  • Dites à l'opérateur le temps mur estimé lors de l'envoi.

2. Contremaître de landing

Brief frais depuis templates/land-brief.md, envoyé seulement après que depth-0 a accepté chaque ligne du contremaître d'implémentation à partir de preuves git (diff, pas d'auto-rapport). Jugement pour le brief :

  • Un clone frais depuis origin/develop, pas le clone d'implémentation. Mettez git config core.hooksPath .githooks dans la toute première ligne de configuration — un clone de landing sans cela livre sans que le qc-gate pre-push s'exécute jamais (v2.36.99 a livré un littéral <id> trailer de cette façon).
  • Cherry-pick des commits de main uniquement. Jamais le commit fantôme ; grep enforcement_mode dit toujours enforce après chaque pick.
  • La suite complète, pas une tranche limitée — un changement qui touche un contrat largement consommé a besoin de la hooks/tests/run.sh complète. Réexécutez chaque solo rouge ; tout ce qui est encore rouge est comparé à origin/develop dans un worktree jetable pour séparer le rouge préexistant du rouge introduit par la branche.
  • UNE review combinée sur origin/develop..HEAD, jamais une re-exécution des reviews par ligne. Une review combinée a attrapé ce que la review par ligne avait manqué sur ce pipeline exact (multiplexeur allow-bypass et cinq résultats en un tour — voir Règles apprises). ARRÊTEZ sur tout 🔴/🟠 dans ce verdict ; ne les récusez pas vous-même.
  • Publication seulement après que les portes sont vertes et que le verdict est SHIP-AS-IS : incrément de version, BACKLOG/CHANGELOG/INDEX, preflight-release.sh.
  • Les trailers sont remplis à partir de l'ID de review réel du manifeste de review (le JSON que la review combinée a effectivement produit), jamais laissés comme un texte littéral de placeholder. Poussez, puis confirmez avec git ls-remote origin develop.

3. Devoirs de depth-0 entre les étapes

  • Re-dériver chaque résultat réfuté vous-même. ADR-0001 (vérification sur attestation) : un "ce résultat est un faux positif" d'un foreman est une affirmation, pas un fait, jusqu'à ce que vous le re-dériviez du même diff.
  • Vérifier chaque push indépendamment : git ls-remote correspond au SHA rapporté, le trailer contient un ID de review réel (pas <id>), la gouvernance indique toujours enforce, et aucun commit fantôme n'a atterri.
  • Les foremans en attente ne se réveillent pas eux-mêmes. Utilisez une minuterie de fond "dead-man" (sleep <n>; echo WAKE-<tag>) parallèlement à l'envoi, plus une vérification de l'état git au réveil, plus SendMessage pour pousser un foreman qui aurait dû revenir et ne l'a pas fait.

4. Contremaître de clôture

Depuis templates/closeout-brief.md, sur le vrai dépôt (pas un clone — "rien d'autre ne s'exécute ici"). Cette étape n'est jamais sautée, même pour un petit bundle :

  • Synchro doc limitée exactement à la plage de diff qui a été livrée — corrigez uniquement la dérive réelle.
  • Une ligne BACKLOG pour tout ce qui a été découvert en cours de pipeline et qui n'était pas dans le périmètre à corriger maintenant (par exemple un incident de pollution suspecté mais non confirmé).
  • Un répertoire de preuves sous docs/plans/evidence/<date>-<slug>/ contenant chaque brief, chaque RAPPORT, chaque JSON de review, plus un README court nommant les sondes et les captures de la review combinée.
  • Mise à jour de HANDOFF dans son style existant (conventions zh-TW applicables — voir CLAUDE.md du projet).
  • Un commit, protégé de la même manière qu'un commit de landing s'il touche un chemin protégé par qc.

Réparation (quand les portes de landing deviennent rouges uniquement sur la branche de release)

Utilisez templates/repair-brief.md quand le run de porte du contremaître de landing trouve des suites rouges sur la branche de release mais vertes sur origin/develop. Bisect par cluster d'abord — faites confiance au bisect plutôt qu'à la supposition suspecte. Une main de réparation par cluster, sur une branche fantôme reconstruite (jamais la branche de release elle-même), reviewée de la même manière qu'une main de contremaître d'implémentation. Au plus un tour de réparation par cluster ; tout ce qui est encore rouge après cela est FAIL, rapporté, pas réparé par le foreman lui-même.

Règles — canoniques ailleurs (ne pas dupliquer ici)

Cette compétence est la liste de contrôle et les templates (templates/*.md). Les règles et leurs événements sources vivent dans :

  • skills/l5/references/hetero-impl-loop.md § "Les foremans Sonnet en tant que sous-agents Agent" : le commit fantôme va dans le brief, un clone de landing définit core.hooksPath, l'ID de trailer vient du manifeste, et le foreman de landing s'arrête sur 🔴/🟠.
  • references/evidence-discipline.md §42–§44 : l'existence d'un canal consultatif n'est pas la preuve qu'il arrive ; une review par ligne ne peut pas remplacer la review combinée ; un diff du vrai dépôt n'est pas la preuve d'une pollution de test.
  • Les pièges de garde-outils : la limite d'exécution bloque les mots destructeurs même dans le texte heredoc, donc écrivez d'abord les scripts dans un fichier ; pgrep -f/pkill -f se correspondent eux-mêmes. Ce sont dans la mémoire de l'opérateur, pas dans le dépôt.

Quand une nouvelle règle est apprise, ajoutez-la à ces fichiers, pas ici.

Skills associés