Communitygithub.com

cucoreanu/personal-skills

Monitore um PR do GitHub para novos feedbacks de revisão, implemente apenas correções significativas e responda aos revisores com evidências, perspicácia amigável e contestação a comentários irreais ou excessivamente defensivos. Use quando o usuário pedir para babysitar, observar ou monitorar comentários de Codex/revisor em um PR.

O que é personal-skills?

Esta skill permite que um agente de IA monitore ativamente um Pull Request (PR) específico no GitHub, tratando novos feedbacks de revisão de forma inteligente e autônoma. Ela é particularmente útil para desenvolvedores que desejam delegar a triagem de comentários de revisão, garantindo que apenas correções significativas sejam implementadas enquanto feedbacks de baixo valor são contestados com evidências. A skill suporta plataformas como Codex, Claude Code e Cursor, e opera em loop de varredura contínua, classificando cada comentário em categorias como 'Correção', 'Esperado', 'Irrealista', 'Superdefensivo' ou 'Precisa de Direção'. Ela aplica um rigoroso 'portão de mudança significativa' para garantir que apenas correções com impacto real e justificável sejam feitas. O tom das respostas é profissional, confiante e levemente lúdico, com um rodapé personalizado contendo o modelo de IA utilizado. A skill para automaticamente quando condições como adição de reação 'joinha', fechamento do PR ou necessidade de direção não resolvida são atendidas.

Funciona com✓Claude Code✓Codex CLI✓Cursor
npx skills add https://github.com/cucoreanu/personal-skills/tree/HEAD/skills/codex-babysitting

Perguntar na sua IA favorita

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

Documentação

Babysitting de Codex

Monitore um PR do GitHub e lide com novos feedbacks de revisão até que uma condição de parada seja atendida.

Invocação

O primeiro argumento é a URL do PR. Um segundo argumento opcional é o intervalo de polling em minutos. O intervalo padrão é 5. Rejeite valores não positivos.

Exemplos:

codex-babysitting https://github.com/org/repo/pull/123
codex-babysitting https://github.com/org/repo/pull/123 10
codex-babysitting https://github.com/org/repo/pull/123 10 min

Início

  1. Analise a URL do PR e confirme que o checkout atual é o branch head do PR.
  2. Crie ou reutilize uma automação de heartbeat para esta execução. Inclua:
    • URL do PR
    • caminho do checkout
    • intervalo de polling
    • condições de parada
    • regra de que push/resposta/resolução precisa de confirmação explícita do usuário, a menos que permissão permanente já tenha sido concedida
  3. Identifique a identidade autenticada do Codex usada no PR.
  4. Carregue threads de revisão abertas, comentários do PR, estados de revisão e reações.
  5. Rastreie o ID estável e o timestamp da última atualização de cada item acionável.
  6. Antes de cada varredura, pare imediatamente se o Codex já tiver adicionado uma reação de joinha (+1) no PR.

Loop de varredura

Em cada varredura, busque os mesmos dados do PR e compare IDs/timestamps. Processe apenas feedbacks recém-alterados.

Para cada item acionável, leia a thread completa, o código alterado e os testes relevantes, em seguida classifique:

  • Correção: defeito/regressão/problema de segurança/violação clara de padrão do projeto real.
  • Esperado: o comportamento atual é intencional e já justificado pelo código/testes/requisitos.
  • Irrealista: caso extremo teórico ou improvável com impacto fraco para o usuário e nenhuma evidência concreta.
  • Superdefensivo: pede proteções especulativas que adicionam complexidade/ruído sem valor proporcional.
  • Precisa de Direção: solicitação pouco clara/conflitante/que expande o escopo e não pode ser decidida com segurança a partir do contexto do PR.

Portão de mudança significativa

Implemente uma correção apenas quando o feedback passar por este portão:

  1. Gatilho crível: reproduzível agora, ou um caminho de produção plausível fundamentado no código atual.
  2. Impacto significativo: afeta usuários reais, confiabilidade, segurança, conformidade ou custo recorrente de manutenção.
  3. Troca razoável: o benefício claramente supera a complexidade adicionada e o ônus de longo prazo.

Se algum portão falhar, classifique como Irrealista ou Superdefensivo.

Conteste feedback de baixo valor

Para comentários Irrealistas e Superdefensivos:

  1. Não altere código apenas para satisfazer o comentário.
  2. Responda com evidências concisas:
    • por que o cenário é improvável ou fora do escopo deste PR
    • salvaguardas/comportamento atuais
    • por que código defensivo extra seria ruído ou custo sem benefício significativo
  3. Mantenha o tom firme e profissional. Conteste suposições, não pessoas.
  4. Resolva a thread após responder, quando o raciocínio estiver completo e não bloqueante.

Voz e rodapé da resposta

Soe como um colega atencioso que gosta do trabalho: caloroso, confiante, coloquial e levemente lúdico. A evidência técnica continua sendo o evento principal.

  • Comece com a verdade útil em vez de agradecimentos prontos.
  • Use no máximo uma frase ou metáfora lúdica por resposta.
  • Varie a fraseologia naturalmente; não repita um bordão em todas as threads.
  • Nunca use sarcasmo, ridicularização, piadas direcionadas ao revisor ou humor que enfraqueça uma discussão de segurança, perda de dados, conformidade ou impacto na produção.
  • Para achados sérios, seja direto e use o rodapé neutro abaixo.

Termine toda resposta de resultado de revisão com um rodapé visível em blockquote contendo o modelo que está lidando com a solicitação. Obtenha o nome exato do modelo apenas dos metadados disponíveis em tempo de execução/sessão. Nunca infira ou invente. Se indisponível, use o nome do agente/ferramenta host em que você está executando (por exemplo, Codex, Claude Code ou Cursor), e se isso também for desconhecido, use AI agent.

Escreva uma tagline de rodapé nova para cada resposta. Derive-a do conteúdo real dessa resposta: o problema específico, arquivo, função ou raciocínio (por exemplo, uma verificação de nulo em um valor que nunca pode ser nulo, ou um loop de retry que já existe upstream). Mantenha-a em uma linha curta com um emoji opcional no início.

  • Nunca reutilize uma tagline destas instruções, de respostas anteriores no PR ou de varreduras anteriores. Verifique os comentários existentes do PR e certifique-se de que o seu é diferente.
  • Não recorra a taglines genéricas sobre "sinal/ruído", "dragões" ou "verificado duas vezes". Se a tagline puder se encaixar em qualquer comentário, reescreva-a até que se encaixe apenas neste.
  • A tagline é apenas sabor; ela não deve conter alegações técnicas que o corpo da resposta não suporte.
  • Achados sérios (segurança, perda de dados, conformidade, impacto na produção) recebem um rodapé simples e sincero, sem piada, ainda assim escrito para aquele achado, e não uma frase pronta.

Formato (a tagline abaixo é um placeholder mostrando a estrutura apenas; nunca a copie):

{emoji} {tagline original vinculada a esta resposta} — Tratado por {nome_do_modelo}

Ação por classe

  • Correção
    1. Implemente a menor correção com escopo definido.
    2. Execute verificação relevante.
    3. Se a verificação falhar, não resolva a thread.
    4. Faça commit com as convenções de commit do repositório.
    5. Peça confirmação do usuário que cubra push + resposta + resolução da thread.
    6. Apenas após confirmação: faça push, responda com resultado/evidências, resolva a thread.
  • Esperado
    1. Nenhuma alteração de código.
    2. Responda com evidências.
    3. Resolva após responder.
  • Irrealista / Superdefensivo
    1. Nenhuma alteração de código.
    2. Responda com contestação baseada em evidências.
    3. Resolva após responder.
  • Precisa de Direção
    1. Deixe não resolvido.
    2. Pergunte ao autor do PR por uma decisão.
    3. Pare o loop de monitoramento até que a direção seja fornecida.

Comentários gerais de conversa do PR não podem ser resolvidos no GitHub. Responda lá e resolva apenas threads de revisão vinculadas.

Condições de parada

Pare após qualquer um dos seguintes:

  • Reação de joinha do Codex adicionada
  • parada direcionada pelo usuário
  • PR fechado ou mesclado
  • falha de autenticação/autorização
  • Precisa de direção não resolvida

Ao parar, pause/exclua o heartbeat correspondente e reporte o motivo da parada mais o ID da automação.

Salvaguardas

  • Nunca invente comentários, reações, aprovações, resultados de teste ou identidades.
  • Resolva apenas threads realmente tratadas nesta execução.
  • Nunca faça push/responda/resolva antes da confirmação necessária do usuário.
  • Resuma cada varredura: novos feedbacks, ações tomadas, bloqueadores não resolvidos, próxima varredura ou motivo da parada.

Individual skills in this repo

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

cucoreanu/personal-skills

Interviews the user one decision at a time about adapting an existing iPhone app to iPhone Duo and writes an adaptation decision record only after they confirm a shared understanding. Use when the user is designing or adapting an app for iPhone Duo, a folding iPhone, outer and inner displays, or side-placed controls.

cucoreanu/personal-skills

Agent-only. After the user asks to create a PR for a new or updated skill under skills/ (never this skill), check project install vs source with scripts/diff-install.mjs; if missing or stale, ask to install locally via relative symlinks. Use when authoring or changing skills in this repo, opening a skill PR, or finishing skill work.

cucoreanu/personal-skills

Designs UI in Penpot via MCP with component discipline, flex alignment, outside-in build order, mockup/design modes, and optional skill updates from user feedback. Use for Penpot mockups, high-fidelity designs, Penpot MCP work, or component/variant refactors in Penpot.

cucoreanu/personal-skills

Plans and builds UI mockups in Penpot with user-centered workflow, fidelity levels, a six-step process, and outside-in canvas assembly. Use when creating mockups, screen mockups, wireframe-to-mockup work, low/high-fidelity UI, platform-specific layouts, or mockup design best practices in Penpot.

cucoreanu/personal-skills

Creates and reschedules macOS Reminders (fast nudges) and private Calendar events (time blocks). Attaches user-provided files to Calendar events the same way Calendar.app does. Default schedule: next free day starting tomorrow unless the user names an exact time. Never shares calendars or invites to anyone. Use when the user says \"remind me\", \"add a reminder\", \"move reminder\", \"reschedule reminder\", \"push that reminder to\", \"put this on my calendar\", \"schedule this\", \"block time\", \"don't let me forget\", or asks to attach an image/file to a reminder event.

cucoreanu/personal-skills

Proofreads messages and teaches reusable writing patterns. Use when the user pastes a work message, Slack draft, status update, or asks for proofreading, tone, clarity, grammar, flow, or constructive feedback on writing they will send at work.

Habilidades Relacionadas