Communitygithub.com

AY Fix (Correção AY)

Pequenos fluxos de trabalho aprovados por humanos para agentes de codificação de IA.

O que é AY Fix (Correção AY)?

A habilidade AY Fix estabelece um contrato claro entre o agente de IA e o usuário humano para diagnosticar e corrigir problemas de software com precisão cirúrgica. Ela exige que o agente investigue fatos observáveis ​​e obtenha aprovação explícita antes de fazer alterações irreversíveis, evitando edições especulativas. A Skill é ideal para desenvolvedores que usam assistentes de codificação como Claude Code, Cursor ou Codex, pois impõe uma disciplina rigorosa: primeiro diagnostique a causa raiz com evidências reproduzíveis, depois decida o limite da correção (mínimo e reversível) e, finalmente, implemente a correção e a prove com verificações de regressão. Ela se baseia em um fluxo de trabalho de três etapas (Diagnosticar, Decidir o Limite, Reparar e Provar) que prioriza a preservação do trabalho existente do usuário e a minimização de riscos.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add ALVIN-YANG/ay-skills

Perguntar na sua IA favorita

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

Documentação

O que AY Fix (Correção AY) faz?

Prove a causa e, em seguida, faça o menor reparo autorizado que evite a recorrência.

Contrato de aprovação

  • Leia a solicitação completa e investigue fatos descobríveis antes de perguntar ao usuário.
  • Trate revisão, diagnóstico, explicação e planejamento como somente leitura, a menos que o usuário também solicite alteração.
  • Trate uma instrução precisa como aprovação quando o alvo, o resultado observável e o limite de aceitação estiverem claros.
  • Um resultado amplo autoriza investigação, não alterações em arquivos ou artefatos baseadas em escolhas que o agente precise inventar.
  • Para uma alteração materialmente subespecificada, apresente uma proposta recomendada e aguarde aprovação.
  • Após a aprovação, execute autonomamente dentro do limite aprovado; não pergunte sobre detalhes comuns de implementação.
  • Reabra a aprovação apenas quando novas evidências alterarem comportamento, arquitetura, contratos de dados, dependências, escopo, risco, custo, reversão ou ações externas.
  • Execute ações externas apenas quando a solicitação ou a proposta aprovada as incluir. Confirme o alvo exato antes de uma ação irreversível.
  • Preserve o trabalho não relacionado e criado pelo usuário. Verifique o resultado real solicitado antes de declarar conclusão.

Diagnosticar

  1. Capture o sintoma exato, o comportamento esperado, o ambiente e a camada de falha.
  2. Reproduza pelo caminho disponível mais próximo, ou nomeie a condição de reprodução ausente.
  3. Trace de volta a partir da saída ruim até o estado incorreto mais antigo. Leia alterações recentes e exemplos funcionais quando relevante.
  4. Formule hipóteses concorrentes e execute a menor verificação discriminatória. Instrumente limites quando a observação estiver faltando.
  5. Confirme a causa. Um cheiro plausível, correlação ou sintoma desaparecido não é prova.

Após uma hipótese falha, colete novas evidências antes de tentar outra. Não edite repetidamente no lugar do diagnóstico.

Decidir o limite do reparo

Se o usuário pediu apenas para diagnosticar, pare com a causa confirmada ou a próxima verificação discriminatória.

Se o usuário pediu para corrigir, prossiga sem outro ponto de verificação apenas quando o reparo da causa raiz for único, local, reversível e preservar o comportamento pretendido. Apresente primeiro uma proposta de reparo quando alternativas alterarem o comportamento do produto, arquitetura, contratos de dados, dependências, escopo, estado externo ou risco material.

Reparar e provar

Corrija a causa no limite responsável mais estreito, não no seu sintoma downstream. Adicione uma verificação de regressão quando existir uma costura de comportamento estável; não invente testes vazios para superfícies não testáveis.

Reexecute a reprodução original, a verificação de regressão e os vizinhos relevantes. Separe as evidências de ambiente, suporte, código-fonte, construção, pacote, implantação e tempo de execução real. Se a causa permanecer não comprovada, diga isso.

Relate a causa, a evidência discriminatória, o reparo, a prova e a incerteza restante.

Habilidades Relacionadas