AlanWYChen/agent-skills

Guia o desenvolvimento de aplicações de produção em web, mobile e sistemas backend. Use ao implementar ou auditar fluxos de trabalho de produção; direcione para o domínio aplicável e orientações de suporte.

O que é agent-skills?

Este pacote de habilidades fornece um conjunto de habilidades de engenharia de produção especializadas por domínio para desenvolvimento de aplicações. Ele organiza guias em três domínios principais — web, mobile e backend — cada um com orientações personalizadas sobre segurança, observabilidade, testes, CI/CD e autenticação. A abordagem evita conselhos genéricos, duplicando e adaptando preocupações importantes para cada contexto. O pacote também inclui fluxos de trabalho compartilhados, como uma política de Dependabot, e um processo de roteamento claro que direciona os agentes de IA a ler primeiro o guia do domínio relevante e, em seguida, as habilidades de suporte aplicáveis, antes de executar uma auditoria de produção específica do domínio. É particularmente útil para agentes como o Claude Code, Cursor ou Codex ao implementar ou auditar sistemas de produção completos, garantindo que práticas como validação de entrada, autorização no servidor e observabilidade sejam seguidas consistentemente.

Funciona com✓Claude Code~Codex CLI~Cursor

npx skills add https://github.com/AlanWYChen/agent-skills/tree/HEAD/production-engineering-skills

Documentação

Habilidades de Engenharia de Produção

Propósito

Este é um pacote de habilidades roteadas por domínio para desenvolvimento de aplicações de produção.

Escolha o domínio relevante primeiro:

Guia web para aplicações baseadas em navegador e sites
Guia mobile para aplicativos móveis iOS, Android e multiplataforma
Guia backend para APIs, serviços, workers, filas, serviços de dados e sistemas de plataforma

Cada domínio intencionalmente duplica preocupações importantes como:

segurança
observabilidade
testes
CI/CD
autenticação

As versões duplicadas são personalizadas para o domínio, em vez de tratadas como conselhos genéricos.

Fluxos de trabalho de repositório compartilhados

Política de Dependabot: use ao configurar ou auditar cronogramas de atualização de dependências, mesclagem automática oficial de Ações do GitHub e revisão manual para dependências de aplicação. Esta política é compartilhada entre domínios; leia-a apenas quando a tarefa for sobre Dependabot.

Roteamento

Ao trabalhar em uma tarefa:

Identifique se a tarefa é principalmente web, mobile, backend ou multide domínio.
Leia o SKILL.md vinculado daquele domínio.
Leia apenas as habilidades de suporte aplicáveis usando seus links relativos. Resolva cada link relativo ao arquivo que o contém, sem depender da descoberta automática de habilidades aninhadas.
Antes de concluir, execute a auditoria de produção específica do domínio.
Para sistemas com vários domínios, execute a auditoria para cada domínio afetado.

Princípios Globais

Construa fluxos de trabalho completos, não demonstrações de caminho feliz.
Nunca trate verificações de IU de frontend/mobile como autorização autoritativa.
Valide entradas não confiáveis em tempo de execução.
Não exponha segredos aos clientes.
Prefira observabilidade e recuperabilidade ao falha silenciosa.
Use Ações do GitHub como implementação padrão de CI/CD, a menos que o repositório já use outro sistema.
Teste fluxos de trabalho críticos na camada apropriada, em vez de usar excessivamente um tipo de teste.