CommunityImagemgithub.com

steipete/maintainer-orchestrator

Orquestração de manutenção open-source: workers do Codex app, recuperação de trabalho, dependências, visão, lançamentos.

O que é maintainer-orchestrator?

O `maintainer-orchestrator` é uma skill de plano de controle que coordena o trabalho em repositórios até a conclusão. Ele inspeciona, delega, monitora, solicita decisões do proprietário e gera relatórios, usando threads do Codex app como workers de execução. A skill impõe uma regra rigorosa de um thread por repositório, garantindo que tarefas mutáveis (como commits, PRs, lançamentos) sejam executadas exclusivamente pelo thread do Codex app, enquanto subagentes de colaboração são usados apenas para suporte somente leitura (como inventário ou síntese de decisões). Inclui um mecanismo de heartbeat automático ('Maintainer Orchestrator Watch') para manter o monitoramento ativo e reabastecer filas de trabalho, além de protocolos detalhados para descoberta de repositórios, classificação de propriedade (maioria de commits), tratamento de exclusões (ex: projetos grandes como OpenClaw/ClawHub) e sincronização segura de checkouts locais. A skill é voltada para ecossistemas open-source complexos e suporta plataformas como Codex, Claude Code e terminais Linux/macOS, sendo projetada para manter a integridade do trabalho e evitar conflitos entre sessões de orquestração.

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

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Orchestrator de Manutenção

Coordene o trabalho do repositório até a conclusão. Esta é uma skill de plano de controle: inspecionar, delegar, monitorar, solicitar decisões e relatar. Nesta skill, um worker é um thread do Codex app de propriedade, nunca um subagente de colaboração.

Limite do Worker — Regra Rígida

  • Use exatamente um thread de projeto do Codex app por repositório para implementação e execução. Reutilize-o para a fila completa do repositório; threads de projeto nunca criam threads de tarefa.
  • Mantenha esta skill canônica maintainer-orchestrator na sessão atual do orchestrator raiz, nunca em um thread de projeto ou subagente de colaboração. A política da skill define o plano de controle e é a única exceção de implementação para execução em thread de projeto.
  • Antes de gerar um subagente de colaboração, classifique a tarefa. Qualquer tarefa de repositório que possa modificar o repositório, GitHub ou estado externo, ou que seja dona de uma entrega, prova de implementação, landing, lançamento ou implantação, deve ir para o único thread de projeto do Codex app daquele repositório.
  • Use subagentes de colaboração apenas para suporte de orquestração: inventário somente leitura, monitoramento de CI/status, análise independente, síntese de conflitos/decisões ou evidências de ledger/reconciliação. Eles não possuem lanes de worker nem contam para a capacidade de execução.
  • Subagentes de colaboração nunca devem editar arquivos do repositório, criar commits, executar prova de implementação como proprietário, fazer push, modificar PRs/issues, aprovar workflows, fazer merge, lançar, implantar ou realizar prova de produto/conta ao vivo.
  • Se um subagente de implementação for descoberto, interrompa-o imediatamente. Faça snapshot e preserve seu estado, patches, refs, logs e evidências; entregue-os ao thread apropriado do Codex app; reconcilie a propriedade; nunca descarte trabalho.
  • O orquestrador raiz coordena threads do app, lê evidências, envia instruções GO/espera, serializa landing exato no HEAD, lida com decisões do proprietário e limpa a barra lateral. A execução do projeto permanece de propriedade e executada por seu thread do Codex app.
  • Prompts de thread não concedem capacidades. Nunca trate texto como acesso total, autorizado ou você pode executar isso como alteração da sandbox efetiva, sistema de arquivos, rede ou política de aprovação do worker.
  • Após criar, entregar ou retomar em background um thread de projeto, verifique seu perfil de permissão efetivo antes de atribuir a primeira ação protegida de escrita, rede, teste ou publicação. Se um worker que deveria herdar acesso total selecionado pelo proprietário relatar permissões gerenciadas/somente leitura ou aprovadas, pare a ação protegida, registre um bloqueador de propagação de permissão da plataforma e atribua a tarefa a um thread de projeto do Codex app configurado corretamente para aquele repositório. Não tente novamente a mesma ação negada nem solicite repetidamente ao proprietário.

Vigilância de Ativação

  • Em cada ativação, inspecione primeiro o heartbeat existente. Crie uma automação de heartbeat ativo de cinco minutos anexada apenas ao thread do orquestrador raiz atual quando nenhum existir; atualize-o apenas quando sua configuração ou instruções de portfólio mudaram materialmente. Nomeie-o Maintainer Orchestrator Watch; nunca crie duplicatas ou emita cartões de atualização no-op repetidos.
  • O prompt do heartbeat deve re-entrar nesta skill, ler o estado mais recente e as instruções mais novas em cada worker do Codex app de propriedade, aplicar o Protocolo de Monitoramento, coordenar gates serializados de landing/lançamento, triar raiz e reabastecer trabalho de execução qualificado para o alvo de concorrência atual, verificar CI/leases/memória/disco, manter o log persistente e apresentar apenas decisões preparadas do proprietário.
  • Mantenha o heartbeat ativo enquanto houver qualquer worker, decisão do proprietário, lançamento, espera de CI ou trabalho de reabastecimento qualificado restante. Desabilite-o apenas quando o proprietário parar explicitamente a orquestração ou o portfólio monitorado estiver genuinamente completo.
  • Um despertar do heartbeat é uma continuação desta sessão raiz, não um worker de descoberta. Mantenha triagem de portfólio, perguntas do proprietário e manutenção desta skill aqui; crie um thread de projeto por repositório apenas para execução concreta.

Escopo do Repositório

  • Escaneie os proprietários steipete e openclaw, mais qualquer outro repositório onde Peter seja o autor majoritário de commits. Confirme escopo incerto a partir do histórico de contribuições, não apenas pelo nome do repositório ou proprietário.
  • Exclua os grandes projetos OpenClaw e ClawHub, atualmente openclaw/openclaw e openclaw/clawhub. Não exclua o restante do proprietário openclaw.
  • Leia references/non-majority-repositories.md durante a descoberta de portfólio. Trate os repositórios listados como fora da responsabilidade de orquestração rotineira: não os use para reabastecimento de fila, varreduras de dependência, monitoramento de lançamento ou manutenção não solicitada.
  • O ledger de não-majoritários é um cache de evidências datado, não uma declaração permanente de propriedade. Revalide a partir do branch padrão atual quando o snapshot for mais antigo que 30 dias, a participação registrada estiver dentro de 10 pontos percentuais de 50%, a propriedade/histórico do repositório tiver mudado ou as evidências conflitarem. Solicitações explícitas do proprietário substituem a exclusão apenas para o trabalho solicitado.
  • Classifique majoritário a partir de commits no branch padrão que não sejam de merge: combine identidades conhecidas de nome/email de Peter, exclua identidades de bots claramente marcadas e exija mais de 50%. Mantenha repositórios ambíguos não classificados em vez de assumir responsabilidade.
  • Exclua repositórios arquivados da descoberta rotineira, varreduras de fila, auditorias de dependência, monitoramento, gates de lançamento e relatórios. Reentre apenas quando o proprietário nomear explicitamente o repositório e solicitar novo trabalho.
  • Quando o proprietário disser que um repositório está aposentado, arquivado ou não deve ser mencionado novamente, registre-o como suprimido. Faça uma mutação de arquivamento com o melhor esforço quando solicitado, depois mantenha-o silencioso mesmo que as permissões impeçam o arquivamento remoto.
  • Determine propriedade incerta a partir do histórico de contribuições do repositório, não apenas pelo nome do repositório.
  • Mantenha um ledger de repositórios atualizado para que lanes concluídas sejam substituídas por trabalho real de fila ou lançamento.

OpenClaw Orchestrator de Manutenção

Aplique esta seção apenas quando o proprietário pedir explicitamente a esta sessão para orquestrar openclaw/openclaw. Ela substitui a exclusão padrão do OpenClaw e o manuseio genérico de changelog; a regra de um thread por repositório ainda se aplica. Os arquivos AGENTS.md, VISION.md e skills específicas do OpenClaw permanecem autoritativos.

  • Leia os atuais VISION.md, AGENTS.md raiz/escopo, clawdtributor, openclaw-pr-maintainer, openclaw-testing, crabbox e autoreview antes de delegar. Trabalho baseado em dependências também requer fonte/docs/tipos upstream diretos; trabalho baseado em Codex requer que o worker atuante inspecione o código fonte irmão ../codex.
  • Mantenha toda descoberta e triagem na sessão do orquestrador raiz. Atualize o Discrawl; leia as mensagens atuais de #clawtributors e #maintainers; inspecione URLs de issues/PRs candidatas, itens relacionados, main atual, permissões de autor, duplicatas, raio de explosão e viabilidade de verificação; depois faça a classificação go/no-go e autonomia antes de criar um worker. Use Gitcrawl para itens relacionados e gh ao vivo antes de cada atribuição, comentário, fechamento, push ou merge.
  • Selecione apenas trabalho de autoria ou relatado por pessoas sem acesso write, maintain ou admin no GitHub. Verifique a permissão do repositório ao vivo; nunca infira acesso ao GitHub a partir de uma função ou canal do Discord. Contribuidores externos postando em #maintainers permanecem elegíveis.
  • Na inicialização, leia e adote threads de trabalho do OpenClaw existentes que o proprietário pede que esta sessão mantenha. Preserve o progresso único, evite lanes duplicadas e monitore ou oriente-os sob a instrução mais recente local ao thread.
  • Use um thread de projeto do OpenClaw de propriedade raiz para toda execução selecionada, processado serialmente em ordem de prioridade da raiz. Nunca crie threads por item ou tarefa. O orquestrador raiz sozinho tria, orienta o thread do projeto, serializa preparação/landing final e avança para o próximo item selecionado.
  • Mantenha perguntas do proprietário no chat do orquestrador raiz. Workers relatam bloqueadores exatos para cima e não perguntam ao proprietário diretamente, a menos que a raiz delegue explicitamente essa interação.
  • Priorize trabalho alinhado à Visão: segurança/padrões seguros, bugs/estabilidade, configuração/primeira execução, perda de dados, autenticação, instalação, entrega de canal e infraestrutura de teste/desempenho restrita. Prefira itens relatados externamente, reproduzíveis, delimitados e com um caminho real de verificação.
  • Trate funcionalidades amplas, mudanças de versão de protocolo, novas superfícies de config/env/default, novos plugins/core/canais/provedores, decisões de política de segurança/privacidade, escolhas de migração irreversíveis ou comportamento sem prova ao vivo utilizável como Needs owner após cada passo reversível seguro estar completo.
  • Trate cada PR de contribuidor como uma proposta inicial. Reconstrua o sintoma e a causa raiz; leia todo o caminho do proprietário, chamadores, chamados, superfícies irmãs, testes, main atual, comportamento enviado e contratos de dependência relevantes; depois refatore ou reescreva quando essa for a correção delimitada mais limpa.
  • Verifique atribuição ao vivo e permissão do contribuidor antes de trabalho profundo. Atribua steipete quando não atribuído, preserve o crédito do contribuidor, prefira o PR original gravável e evite itens de fila de autoria do mantenedor/acesso de escrita, a menos que sejam a correção canônica para um relatório externo elegível.
  • Use apenas comandos nativos do repositório scripts/pr para revisão, artefato, preparação, sincronização e merge para landing. Nunca mude o checkout compartilhado/raiz. O único thread de projeto do OpenClaw revisa, implementa, testa e monitora um item selecionado de cada vez; a raiz concede seu slot serializado para sincronização HEAD do PR, preparo final e merge-run para que a deriva da mainline e as evidências hospedadas permaneçam exatas.
  • Antes de landear, exija prova do sintoma, causa raiz, proveniência quando rastreável, cobertura de regressão focada, o portão amplo suficiente mais barato, prova ao vivo/E2E ou Crabbox quando viável, autoreview fresco sem descobertas aceitas/acessíveis, threads de revisão resolvidas e gates exatos de CI/Testbox/segurança hospedados.
  • Poste ou atualize um comentário de PR pronto para landear vinculando comportamento e prova ao SHA exato do HEAD, incluindo comandos, IDs de execução/lease, evidências ao vivo, resultado de autoreview e lacunas explícitas. Armazene capturas de tela/vídeos em artefatos aprovados, nunca no branch do produto.
  • O changelog do OpenClaw é gerado por lançamento. Não edite CHANGELOG.md para trabalho normal de issue/PR, mesmo quando regras genéricas de mantenedor adicionariam uma entrada.
  • Após landear ou fechar, verifique a acessibilidade de main, audite issues/PRs vinculadas e duplicadas, comente prova canônica antes de fechar duplicatas comprovadas, pare leases, depois avance o mesmo thread de projeto para o próximo item selecionado.

Inicialização de Sessão

  1. Crie ou atualize o heartbeat necessário Maintainer Orchestrator Watch antes do trabalho de fila.
  2. Liste threads recentes do Codex app antes de escolher repositórios. Leia estado suficiente para identificar repositórios que o proprietário ou outro coordenador está tratando ativamente.
  3. Reserve todo projeto com trabalho coerente ativo ou não resolvido em outro thread. Não inspecione, mude, delegue, renomeie ou oriente esse projeto a partir desta sessão, a menos que o proprietário o entregue explicitamente.
  4. Quando um checkout local estiver sujo ou em um branch não padrão, mas não tiver thread ativo, crie o único thread de projeto desse repositório em modo de preservação. Trate-o como trabalho esquecido potencialmente valioso, não como motivo para ignorar o projeto.
  5. Use RepoBar para o mapa amplo da fila. Filtre para repositórios elegíveis, não arquivados, não forks, depois confirme que Peter tem a maioria das contribuições.
  6. Prefira as menores filas efetivas não vazias primeiro. Dentro de tamanho igual de fila, prefira bugs delimitados, docs, testes e PRs quase prontos sobre funcionalidades ou decisões de segurança/produto.
  7. Reconfira threads ativos e contagens de fila em cada despertar antes de atribuir novo trabalho. Um projeto recém-ativo torna-se reservado imediatamente.

Sincronização de Repositório

Antes de qualquer investigação ou implementação de repositório:

  1. Registre git status -sb, branch atual, upstream, HEAD, estado staged/unstaged/untracked e contagens ahead/behind.
  2. Busque refs remotas atuais. Em um branch padrão limpo, execute git pull --ff-only, depois verifique se permanece limpo e sincronizado.
  3. Nunca execute pull, switch, stash, rebase, merge, reset, clean, delete ou sobrescreva um checkout sujo ou não padrão meramente para iniciar trabalho. Primeiro preserve e classifique seus commits e mudanças únicas, PR/issue associado, estado upstream e se o trabalho já foi landeado ou substituído.
  4. Se o branch padrão local estiver à frente, divergiu ou não tem upstream; o fast-forward pull falhar; um branch de tarefa conflitar com o branch padrão atual; ou o estado remoto buscado contradizer a atribuição, pare a mutação e apresente ao proprietário os commits exatos, arquivos, URLs, conflito, risco e escolhas seguras.
  5. Retome o trabalho comum apenas após o checkout estar atualizado ou o proprietário escolher como preservar/reconciliá-lo. Nunca delete um branch ou trabalho único sem autorização explícita de limpeza e prova de que foi landeado ou substituído.

Repita a sincronização após cada landing e antes de qualquer gate de lançamento.

Modelo Operacional

  1. Use github-project-triage para mapear issues abertas, PRs abertos, CI, último lançamento, metadados de pacote e changelog não lançado de cada repositório. Leia VISION.md quando presente antes de julgar adequação; caso contrário, use direção documentada do produto e julgamento do mantenedor.
  2. Classifique cada item da fila:
    • Autonomous: ajuste claro, reproduzível, implementação delimitada e caminho de verificação utilizável.
    • Needs owner: escolha do produto, decisão de segurança/privacidade, credenciais/acesso indisponíveis, prova ao vivo indisponível ou escolha destrutiva/irreversível.
    • Ignored by owner: um item explicitamente nomeado que o proprietário diz que não deve afetar o trabalho atual.
  3. Delegue cada repositório independente para exatamente um thread de projeto do Codex app de propriedade raiz. Reutilize-o para a fila completa e atualize seu título <Projeto>: <status atual> sempre que o trabalho mudar materialmente. O thread do projeto lida com sua fila serialmente e nunca cria ou gerencia outros threads. Omita seleção de modelo e herde o padrão da plataforma.
  4. Mantenha um alvo de 30 threads de projeto do Codex app de propriedade raiz simultâneos elegíveis em repositórios distintos.

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.

Habilidades Relacionadas