CommunityImagegithub.com

steipete/maintenir-orchestrateur

Orchestration open-source de maintenance : workers Codex, récupération de travaux, dépendances, vision, versions.

Qu'est-ce que maintenir-orchestrateur ?

Ce skill agit comme un plan de contrôle intelligent pour orchestrer le travail de maintenance sur des dépôts GitHub, en particulier ceux dont l'utilisateur est le contributeur majoritaire. Il délègue et surveille l'exécution via des threads de projet Codex dédiés, gère la récupération en cas d'échec, et coordonne les décisions et les versions. Le skill impose une règle stricte : un seul thread de projet par dépôt, pour toute mutation d'état, tandis que les sous-agents de collaboration sont réservés aux tâches de lecture seule (inventaire, surveillance CI, synthèse). Il intègre un protocole de surveillance par battement de cœur (heartbeat) pour maintenir l'état global et garantir une progression fluide. Polyvalent, il supporte des workflows avancés pour des projets comme OpenClaw, avec une priorisation des corrections de bugs et un respect strict des permissions et des règles de contribution.

Compatible avec~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/maintainer-orchestrator

Installed? Explore more Image skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Demander à votre IA préférée

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

Documentation

Orchestrateur de maintenance

Coordonner le travail sur le dépôt jusqu'à son achèvement. Il s'agit d'un skill de plan de contrôle : inspecter, déléguer, surveiller, demander des décisions et faire un rapport. Dans ce skill, un worker est un thread d'application Codex détenu, jamais un sous-agent de collaboration.

Limite des workers — Règle stricte

  • Utilisez exactement un thread de projet d'application Codex possédé par dépôt pour l'implémentation et l'exécution. Réutilisez-le pour la file d'attente complète du dépôt ; les threads de projet ne créent jamais de threads de tâche.
  • Conservez ce skill canonique steipete/maintenir-orchestrateur dans la session d'orchestrateur racine actuelle, jamais dans un thread de projet ou un sous-agent de collaboration. La politique du skill définit le plan de contrôle et est la seule exception d'implémentation à l'exécution par thread de projet.
  • Avant de créer un sous-agent de collaboration, classifiez la tâche. Toute tâche de dépôt qui peut modifier l'état du dépôt, de GitHub ou externe, ou qui possède un livrable, une preuve d'implémentation, un déploiement, une version ou un déploiement, doit être confiée au thread de projet d'application Codex unique de ce dépôt.
  • Utilisez les sous-agents de collaboration uniquement pour le support d'orchestration : inventaire en lecture seule, surveillance CI/état, analyse indépendante, synthèse de conflits/décisions ou preuves de registre/réconciliation. Ils ne possèdent pas de lignes de worker et ne comptent pas dans la capacité d'exécution.
  • Les sous-agents de collaboration ne doivent jamais modifier les fichiers du dépôt, créer de commits, exécuter la preuve d'implémentation en tant que propriétaire, pousser, modifier les PRs/issues, approuver les workflows, fusionner, publier, déployer ou effectuer une preuve de produit/compte en direct.
  • Si un sous-agent d'implémentation est découvert, interrompez-le immédiatement. Capturez et préservez son état, ses patches, ses références, ses logs et ses preuves ; transmettez-les au thread d'application Codex approprié ; réconciliez la propriété ; ne jetez jamais le travail.
  • L'orchestrateur racine coordonne les threads d'application, lit les preuves, envoie les instructions GO/attente, sérialise le déploiement exact, gère les décisions du propriétaire et nettoie la barre latérale. L'exécution du projet reste détenue et effectuée par son thread d'application Codex.
  • Les invites de thread n'accordent pas de capacités. Ne traitez jamais un texte tel que full access, authorized, ou you may run this comme modifiant le bac à sable effectif, le système de fichiers, le réseau ou la politique d'approbation du worker.
  • Après avoir créé, transféré ou repris en arrière-plan un thread de projet, vérifiez son profil de permissions effectif avant d'attribuer la première action d'écriture, réseau, test ou publication protégée. Si un worker censé hériter d'un accès complet sélectionné par le propriétaire signale plutôt des permissions gérées/lecture seule ou soumises à approbation, arrêtez l'action protégée, enregistrez un blocage de propagation des permissions de la plateforme et acheminez la tâche vers un thread de projet d'application Codex correctement configuré pour ce dépôt. Ne réessayez pas la même action refusée et n'invitez pas le propriétaire à plusieurs reprises.

Veille d'activation

  • À chaque activation, inspectez d'abord le battement de cœur existant. Créez une automatisation de battement de cœur active de cinq minutes attachée au thread d'orchestrateur racine actuel uniquement lorsqu'aucune n'existe ; mettez-la à jour uniquement lorsque sa configuration ou les instructions du portefeuille ont changé de manière substantielle. Nommez-la Maintainer Orchestrator Watch ; ne créez jamais de doublons et n'émettez pas de cartes de mise à jour no-op répétées.
  • L'invite du battement de cœur doit rentrer dans ce skill, lire l'état le plus récent et les instructions les plus récentes dans chaque worker Codex détenu, appliquer le protocole de surveillance, coordonner les portes de déploiement/de version sérialisées, trier et remplir le travail d'exécution qualifié jusqu'à l'objectif de concurrence actuel, vérifier CI/baux/mémoire/disque, maintenir le journal persistant, et ne présenter que les décisions préparées du propriétaire.
  • Gardez le battement de cœur actif tant qu'il reste un worker, une décision du propriétaire, une version, une attente CI ou un travail de remplissage qualifié. Désactivez-le uniquement lorsque le propriétaire arrête explicitement l'orchestration ou que le portefeuille surveillé est véritablement terminé.
  • Un réveil du battement de cœur est une continuation de cette session racine, pas un worker de découverte. Gardez le tri du portefeuille, les questions du propriétaire et la maintenance de ce skill ici ; créez un seul thread de projet par dépôt uniquement pour l'exécution concrète.

Périmètre du dépôt

  • Scannez les propriétaires steipete et openclaw, ainsi que tout autre dépôt où Peter est l'auteur majoritaire des commits. Confirmez le périmètre incertain à partir de l'historique des contributions, pas uniquement du nom du dépôt ou du propriétaire.
  • Excluez les grands projets OpenClaw et ClawHub, actuellement openclaw/openclaw et openclaw/clawhub. N'excluez pas le reste du propriétaire openclaw.
  • Lisez references/non-majority-repositories.md lors de la découverte du portefeuille. Traitez les dépôts listés comme étant en dehors de la responsabilité d'orchestration habituelle : ne les utilisez pas pour les remplissages de file d'attente, les analyses de dépendances, la surveillance des versions ou la maintenance non sollicitée.
  • Le registre des non-majoritaires est un cache de preuves daté, pas une déclaration de propriété permanente. Revalidez à partir de la branche par défaut actuelle lorsque l'instantané a plus de 30 jours, que la part enregistrée est à moins de 10 points de pourcentage de 50 %, que la propriété/l'historique du dépôt a changé ou que les preuves sont contradictoires. Les demandes explicites du propriétaire remplacent l'exclusion uniquement pour le travail demandé.
  • Classez la majorité à partir des commits de la branche par défaut non fusionnés : combinez les identités connues de Peter (nom/email), excluez les identités de robots clairement marquées, et exigez plus de 50 %. Laissez les dépôts ambigus non classifiés plutôt que d'assumer la responsabilité.
  • Excluez les dépôts archivés de la découverte habituelle, des analyses de file d'attente, des audits de dépendances, de la surveillance, des portes de version et des rapports. Ne revenez que lorsque le propriétaire nomme explicitement le dépôt et demande un nouveau travail.
  • Lorsque le propriétaire dit qu'un dépôt est retiré, archivé ou ne doit plus être mentionné, enregistrez-le comme supprimé. Effectuez une seule mutation d'archive de meilleur effort lorsque demandé, puis gardez-le silencieux même si les autorisations empêchent l'archive distante.
  • Déterminez la propriété incertaine à partir de l'historique des contributions du dépôt, pas uniquement du nom du dépôt.
  • Tenez un registre actuel des dépôts afin que les lignes terminées soient remplacées par un travail réel de file d'attente ou de version.

Orchestrateur de maintenance OpenClaw

Appliquez cette section uniquement lorsque le propriétaire demande explicitement à cette session d'orchestrer openclaw/openclaw. Elle remplace l'exclusion par défaut d'OpenClaw et la gestion générique du journal des modifications ; la règle d'un thread par dépôt s'applique toujours. Les AGENTS.md, VISION.md et les skills spécifiques à OpenClaw restent faisant autorité.

  • Lisez les VISION.md, AGENTS.md racine/limité, clawdtributor, openclaw-pr-maintainer, openclaw-testing, crabbox, et autoreview actuels avant de déléguer. Le travail basé sur les dépendances nécessite également des sources/docs/types amont directs ; le travail basé sur Codex nécessite que le worker agissant inspecte le code source frère ../codex.
  • Gardez toute la découverte et le tri dans la session d'orchestrateur racine. Rafraîchissez Discrawl ; lisez les messages actuels de #clawtributors et #maintainers ; inspectez les URL des issues/PR candidates, les éléments connexes, le main actuel, les autorisations des auteurs, les doublons, l'étendue de l'impact et la faisabilité de la vérification ; puis faites la classification go/no-go et autonomie avant de créer un worker. Utilisez Gitcrawl pour les éléments connexes et gh en direct avant chaque affectation, commentaire, fermeture, push ou fusion.
  • Sélectionnez uniquement le travail créé ou signalé par des personnes sans accès write, maintain ou admin GitHub. Vérifiez l'autorisation du dépôt en direct ; ne déduisez jamais l'accès GitHub à partir d'un rôle Discord ou d'une appartenance à un canal. Les contributeurs externes postant dans #maintainers restent éligibles.
  • Au démarrage, lisez et adoptez les threads de travail OpenClaw existants que le propriétaire demande à cette session de maintenir. Préservez la progression unique, évitez les lignes en double et surveillez-les ou orientez-les selon les instructions les plus récentes du thread local.
  • Utilisez un seul thread de projet OpenClaw détenu par la racine pour toute l'exécution sélectionnée, traité en série dans l'ordre priorisé par la racine. Ne créez jamais de threads par élément ou par tâche. L'orchestrateur racine seul trie, oriente le thread de projet, sérialise la préparation/le déploiement final, et l'avance vers l'élément sélectionné suivant.
  • Gardez les questions du propriétaire dans le chat de l'orchestrateur racine. Les workers signalent les blocages exacts vers le haut et ne demandent pas directement au propriétaire sauf si la racine délègue explicitement cette interaction.
  • Priorisez le travail aligné sur la vision : sécurité/paramètres par défaut sûrs, bugs/stabilité, configuration/première exécution, perte de données, authentification, installation, livraison de canal, et infrastructure de test/performance étroite. Préférez les éléments signalés en externe, reproductibles, limités et avec une voie de vérification réelle.
  • Traitez les fonctionnalités larges, les changements de version de protocole, les nouvelles surfaces de configuration/env/par défaut, les nouveaux plugins/canaux/fournisseurs de base, la politique de sécurité/confidentialité, les choix de migration irréversibles ou le comportement sans preuve en direct utilisable comme Needs owner après chaque étape réversible sûre terminée.
  • Traitez chaque PR de contributeur comme une proposition de départ. Reconstruisez le symptôme et la cause racine ; lisez l'intégralité du chemin du propriétaire, les appelants, les appelés, les surfaces frères, les tests, le main actuel, le comportement publié et les contrats de dépendance pertinents ; puis refactorisez ou réécrivez lorsque c'est le correctif limité le plus propre.
  • Vérifiez l'affectation en direct et l'autorisation du contributeur avant un travail en profondeur. Assignez steipete lorsque non assigné, préservez le crédit du contributeur, préférez la PR modifiable d'origine et évitez les éléments de file d'attente écrits par le mainteneur/avec accès en écriture sauf s'ils sont le correctif canonique pour un rapport externe éligible.
  • Utilisez uniquement les commandes natives du dépôt scripts/pr pour la révision, l'artefact, la préparation, la synchronisation et la fusion. Ne mutez jamais la copie partagée/racine. Le seul thread de projet OpenClaw révise, implémente, teste et surveille un élément sélectionné à la fois ; la racine accorde son slot sérialisé pour la synchronisation de la tête de PR, la préparation finale et merge-run afin que la dérive de la branche principale et les preuves hébergées restent exactes.
  • Avant le déploiement, exigez une preuve du symptôme, la cause racine, la provenance lorsqu'elle est traçable, une couverture de régression ciblée, la passerelle large suffisante la moins chère, une preuve en direct/E2E ou Crabbox lorsque c'est faisable, un autoreview frais sans résultats acceptés/actionnables, des threads de révision résolus, et des passerelles CI/Testbox/sécurité hébergées exactes.
  • Postez ou mettez à jour un commentaire de PR prêt pour le déploiement liant le comportement et la preuve au SHA exact de la tête, y compris les commandes, les identifiants d'exécution/lease, les preuves en direct, le résultat de l'autoreview et les lacunes explicites. Stockez les captures d'écran/vidéos dans des artefacts approuvés, jamais sur la branche du produit.
  • Le journal des modifications d'OpenClaw est généré par les versions. Ne modifiez pas CHANGELOG.md pour un travail normal d'issue/PR, même lorsque les règles génériques du mainteneur ajouteraient une entrée.
  • Après le déploiement ou la fermeture, vérifiez l'accessibilité de main, auditez les issues/PR liées et en double, commentez une preuve canonique avant de fermer les doublons prouvés, arrêtez les leases, puis avancez le même thread de projet vers l'élément sélectionné suivant.

Démarrage de session

  1. Créez ou mettez à jour le battement de cœur Maintainer Orchestrator Watch requis avant le travail de file d'attente.
  2. Listez les threads récents de l'application Codex avant de choisir les dépôts. Lisez suffisamment d'état pour identifier les dépôts que le propriétaire ou un autre coordinateur gère activement.
  3. Réservez chaque projet avec un travail cohérent, actif ou non résolu dans un autre thread. N'inspectez, ne modifiez, ne déléguez, ne renommez et n'orientez pas ce projet à partir de cette session sauf si le propriétaire le remet explicitement.
  4. Lorsqu'une copie locale est sale ou sur une branche non par défaut mais n'a pas de thread actif, créez le seul thread de projet de ce dépôt en mode préservation. Traitez-le comme un travail potentiellement précieux oublié, pas comme une raison d'ignorer le projet.
  5. Utilisez RepoBar pour la carte large de la file d'attente. Filtrez pour les dépôts éligibles, non archivés, non fork, puis confirmez que Peter a la majorité des contributions.
  6. Préférez les files d'attente effectives non vides les plus petites en premier. Pour une taille de file d'attente égale, préférez les bugs limités, la documentation, les tests et les PR presque prêtes plutôt que les fonctionnalités ou les décisions de sécurité/produit.
  7. Revérifiez les threads actifs et les comptes de file d'attente à chaque réveil avant d'assigner un nouveau travail. Un projet nouvellement actif devient réservé immédiatement.

Synchronisation du dépôt

Avant toute investigation ou implémentation de dépôt :

  1. Enregistrez git status -sb, la branche actuelle, l'amont, HEAD, l'état stagé/non stagé/non suivi, et les comptes ahead/behind.
  2. Récupérez les références distantes actuelles. Sur une branche par défaut propre, exécutez git pull --ff-only, puis vérifiez qu'elle reste propre et synchronisée.
  3. Ne tirez jamais, ne changez pas, ne stash, ne rebasez, ne mergez, ne réinitialisez, ne nettoyez, ne supprimez et n'écrasez pas une copie sale ou non par défaut simplement pour commencer le travail. Préservez et classez d'abord ses commits et changements uniques, la PR/issue associée, l'état amont, et si le travail a déjà été déployé ou supplanté.
  4. Si la branche par défaut locale est en avance, a divergé ou manque d'amont ; le pull fast-forward échoue ; une branche de tâche entre en conflit avec la branche par défaut actuelle ; ou l'état distant récupéré contredit l'affectation, arrêtez la mutation et présentez au propriétaire les commits exacts, les fichiers, les URL, le conflit, le risque et les choix sûrs.
  5. Reprenez le travail normal uniquement après que la copie est à jour ou que le propriétaire a choisi comment la préserver/réconcilier. Ne supprimez jamais une branche ou un travail unique sans autorisation explicite de nettoyage et une preuve qu'il a été déployé ou supplanté.

Répétez la synchronisation après chaque déploiement et avant chaque porte de version.

Modèle opérationnel

  1. Utilisez github-project-triage pour cartographier les issues ouvertes, les PR ouvertes, la CI, la dernière version, les métadonnées du package et le journal des modifications non publié de chaque dépôt. Lisez VISION.md lorsqu'il est présent avant de juger de l'adéquation ; sinon, utilisez la direction du produit documentée et le jugement du mainteneur.
  2. Classez chaque élément de la file d'attente :
    • Autonome : adéquation claire, reproductible, implémentation limitée et voie de vérification utilisable.
    • Nécessite le propriétaire : choix de produit, décision de sécurité/confidentialité, identifiants/accès indisponibles, preuve en direct indisponible, ou choix destructeur/irréversible.
    • Ignoré par le propriétaire : un élément explicitement nommé que le propriétaire dit ne doit pas affecter le travail actuel.
  3. Déléguez chaque dépôt indépendant à exactement un thread de projet d'application Codex détenu par la racine. Réutilisez-le pour la file d'attente complète et mettez à jour son titre <Projet>: <statut actuel> chaque fois que le travail change matériellement. Le thread de projet gère sa file d'attente en série et ne crée ni ne gère d'autres threads. Omettez la sélection du modèle et héritez du défaut de la plateforme.
  4. Maintenez un objectif de 30 threads de projet d'application Codex éligibles détenus par la racine, simultanés, sur des dépôts distincts.

... [tronqué pour la traduction]

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

steipete/nano-banana-pro

Nano Banana/Gemini image gen/edit: text/image input, 512-4K workflows.

Skills associés