本文へ移動
cccskills
無料GitHub で公開

api-patterns

Princípios de design de API e tomada de decisão. Seleção REST vs GraphQL vs tRPC, formatos de resposta, versionamento, paginação.

インストール方法を見る

含まれるファイル(12)

  • SKILL.md2.7 KB
  • api-style.md1.1 KB
  • auth.md576 B
  • documentation.md549 B
  • graphql.md977 B
  • rate-limiting.md726 B
  • response.md921 B
  • rest.md1.3 KB
  • scripts/api_validator.py7.4 KB
  • security-testing.md2.8 KB
  • trpc.md801 B
  • versioning.md651 B

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

Padrões de API

Princípios de design de API e tomada de decisão para 2025. Aprenda a PENSAR, não copie padrões fixos.

🎯 Regra de Leitura Seletiva

Leia APENAS os arquivos relevantes para a solicitação! Verifique o mapa de conteúdo, encontre o que você precisa.


📑 Mapa de Conteúdo

ArquivoDescriçãoQuando Ler
api-style.mdÁrvore de decisão REST vs GraphQL vs tRPCEscolhendo tipo de API
rest.mdNomenclatura de recursos, métodos HTTP, códigos de statusProjetando API REST
response.mdPadrão envelope, formato de erro, paginaçãoEstrutura de resposta
graphql.mdDesign de schema, quando usar, segurançaConsiderando GraphQL
trpc.mdMonorepo TypeScript, segurança de tipoProjetos fullstack TS
versioning.mdVersionamento por URI/Header/QueryPlanejamento de evolução de API
auth.mdJWT, OAuth, Passkey, API KeysSeleção de padrão de autenticação
rate-limiting.mdToken bucket, janela deslizanteProteção de API
documentation.mdMelhores práticas OpenAPI/SwaggerDocumentação
security-testing.mdOWASP API Top 10, testes de autenticação/autorizaçãoAuditorias de segurança

🔗 Habilidades Relacionadas

NecessidadeHabilidade
Implementação de API@[skills/backend-development]
Estrutura de dados@[skills/database-design]
Detalhes de segurança@[skills/security-hardening]

✅ Checklist de Decisão

Antes de projetar uma API:

  • Perguntou ao usuário sobre os consumidores da API?
  • Escolheu o estilo de API para ESTE contexto? (REST/GraphQL/tRPC)
  • Definiu formato de resposta consistente?
  • Planejou estratégia de versionamento?
  • Considerou necessidades de autenticação?
  • Planejou rate limiting?
  • Abordagem de documentação definida?

❌ Anti-Padrões

NÃO FAÇA:

  • Use REST por padrão para tudo
  • Use verbos em endpoints REST (/getUsers)
  • Retorne formatos de resposta inconsistentes
  • Exponha erros internos aos clientes
  • Pule rate limiting

FAÇA:

  • Escolha o estilo de API baseado no contexto
  • Pergunte sobre os requisitos do cliente
  • Documente minuciosamente
  • Use códigos de status apropriados

Script

ScriptPropósitoComando
scripts/api_validator.pyValidação de endpoint de APIpython scripts/api_validator.py <project_path>

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

Especialista em construir experiências 3D para a web - Three.js, React Three Fiber, Spline, WebGL e cenas 3D interativas. Cobre configuradores de produtos, portfólios 3D, websites imersivos e adição de profundidade às experiências web. Use quando: website 3D, three.js, WebGL, react three fiber, experiência 3D.

日本語の概要は準備中です。原文の説明を表示しています。

artubss/SKILLS-CLAUDE-CODE112026年5月17日 更新

Quando o usuário quer planejar, projetar ou implementar um teste A/B ou experimento. Também use quando o usuário menciona "teste A/B", "split test", "experimento", "testar essa mudança", "copy variante", "teste multivariado" ou "hipótese". Para implementação de rastreamento, veja analytics-tracking.

日本語の概要は準備中です。原文の説明を表示しています。

artubss/SKILLS-CLAUDE-CODE112026年5月17日 更新

Auditar e melhorar a acessibilidade web seguindo as diretrizes WCAG 2.1. Use quando solicitado para "melhorar acessibilidade", "auditoria a11y", "conformidade WCAG", "suporte a leitor de tela", "navegação por teclado" ou "tornar acessível".

日本語の概要は準備中です。原文の説明を表示しています。

artubss/SKILLS-CLAUDE-CODE112026年5月17日 更新

Testes e benchmarking de agentes LLM incluindo testes comportamentais, avaliação de capacidades, métricas de confiabilidade e monitoramento em produção—onde até os melhores agentes alcançam menos de 50% em benchmarks do mundo real. Use quando: testes de agentes, avaliação de agentes, benchmark de agentes, confiabilidade de agentes, teste de agentes.

日本語の概要は準備中です。原文の説明を表示しています。

artubss/SKILLS-CLAUDE-CODE112026年5月17日 更新

Criar, gerenciar e orquestrar agentes de IA usando o CLI AI Maestro. Use quando o usuário pedir para "criar agente", "listar agentes", "deletar agente", "hibernar agente", "despertar agente", "instalar plugin", "mostrar agente", "reiniciar agente" ou qualquer tarefa de gerenciamento do ciclo de vida do agente.

日本語の概要は準備中です。原文の説明を表示しています。

artubss/SKILLS-CLAUDE-CODE112026年5月17日 更新

Gerencie múltiplos agentes CLI locais via sessões tmux (iniciar/parar/monitorar/atribuir) com agendamento compatível com cron.

日本語の概要は準備中です。原文の説明を表示しています。

artubss/SKILLS-CLAUDE-CODE112026年5月17日 更新

artubss のスキルをすべて見る

このスキルの問題を報告する