跳到正文
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(原文)

安装前可以查看交给 AI 代理的指令内容。

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>

评价

还没有评价。欢迎分享你的使用感受。

评论

无需登录即可发表。欢迎分享使用感受、提问,或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

提交后会立即公开。请勿填写邮箱、电话等个人信息。URL 最多 2 个。

0 / 1000 字

此表单受 reCAPTCHA 保护,适用 Google 的隐私权政策和服务条款。

同一仓库的技能

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 的全部技能

报告此技能的问题