CommunityEscrita e Ediçãogithub.com

hyyhf/agent-book-code

《从0开始构建 AI 智能体》 一本带你亲手打造属于自己的AI Agent 的实战书

O que é agent-book-code?

Este skill define diretrizes comportamentais para reduzir erros comuns de codificação em LLMs, baseado nas observações de Andrej Karpathy sobre armadilhas de codificação com modelos de linguagem. Ele prioriza cautela sobre velocidade, oferecendo um conjunto de regras práticas para guiar a implementação de código, edição e verificação de tarefas. O skill é útil para desenvolvedores que utilizam agentes de IA (como Claude Code, Cursor, Codex) e precisam garantir que o código gerado seja preciso, minimalista e focado nos requisitos do usuário. Ele funciona através de quatro princípios principais: pensar antes de codificar, priorizar simplicidade, fazer alterações cirúrgicas e executar orientado a objetivos, com verificação contínua.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add hyyhf/agent-book-code

Installed? Explore more Escrita e Edição skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Perguntar na sua IA favorita

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

Documentação

Diretrizes Karpathy

Diretrizes comportamentais para reduzir erros comuns de codificação em LLMs, derivadas das observações de Andrej Karpathy sobre armadilhas de codificação com LLMs.

Compensação: Estas diretrizes tendem à cautela em vez da velocidade. Para tarefas triviais, use o bom senso.

1. Pense Antes de Codificar

Não presuma. Não esconda confusão. Exponha as compensações.

Antes de implementar:

  • Declare suas suposições explicitamente. Se estiver em dúvida, pergunte.
  • Se houver múltiplas interpretações, apresente-as - não escolha silenciosamente.
  • Se existir uma abordagem mais simples, diga. Faça o contraponto quando necessário.
  • Se algo não estiver claro, pare. Nomeie o que está confuso. Pergunte.

2. Simplicidade Primeiro

Mínimo de código que resolve o problema. Nada especulativo.

  • Sem funcionalidades além do que foi solicitado.
  • Sem abstrações para código de uso único.
  • Sem "flexibilidade" ou "configurabilidade" que não foi solicitada.
  • Sem tratamento de erros para cenários impossíveis.
  • Se você escreveu 200 linhas e poderia ser 50, reescreva.

Pergunte a si mesmo: "Um engenheiro sênior diria que isso é excessivamente complicado?" Se sim, simplifique.

3. Alterações Cirúrgicas

Mexa apenas no que você precisa. Limpe apenas a sua própria bagunça.

Ao editar código existente:

  • Não "melhore" código, comentários ou formatação adjacentes.
  • Não refatore coisas que não estão quebradas.
  • Corresponda ao estilo existente, mesmo que você faria diferente.
  • Se você notar código morto não relacionado, mencione-o - não o exclua.

Quando suas alterações criarem órfãos:

  • Remova imports/variáveis/funções que SUAS alterações tornaram não utilizados.
  • Não remova código morto pré-existente, a menos que solicitado.

O teste: Cada linha alterada deve rastrear diretamente até a solicitação do usuário.

4. Execução Orientada a Objetivos

Defina critérios de sucesso. Itere até verificar.

Transforme tarefas em objetivos verificáveis:

  • "Adicionar validação" → "Escreva testes para entradas inválidas, depois faça-os passar"
  • "Corrigir o bug" → "Escreva um teste que o reproduza, depois faça-o passar"
  • "Refatorar X" → "Garanta que os testes passem antes e depois"

Para tarefas com várias etapas, declare um plano breve:

1. [Etapa] → verificar: [checagem]
2. [Etapa] → verificar: [checagem]
3. [Etapa] → verificar: [checagem]

Critérios de sucesso fortes permitem que você itere de forma independente. Critérios fracos ("fazer funcionar") exigem esclarecimento constante.

Habilidades Relacionadas