본문으로 건너뛰기
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>

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

댓글

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

보내면 바로 공개됩니다. 이메일 주소나 전화번호 같은 개인 정보는 쓰지 마세요. URL은 2개까지입니다.

0 / 1,000자

이 양식은 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의 스킬 모두 보기

이 스킬의 문제 신고