Habilidades backend-fastapi
📦

backend-fastapi

v1.0.0 Baixo Risco ⚙️ Comandos externos🔑 Variáveis de ambiente

Documentar a Arquitetura do Backend FastAPI

As equipes precisam de um contexto claro do backend antes de alterar serviços de chatbot e RAG. Esta skill resume endpoints FastAPI, dependências, comandos de execução e configuração de serviços em um guia focado.

Suporta: Claude Codex Code(CC)
🥈 80 Prata
1

Baixar o ZIP da habilidade

2

Upload no Claude

Vá em Configurações → Capacidades → Skills → Upload skill

3

Ative e comece a usar

Recursos legíveis por agentes

Use estes links quando um agente de IA, crawler ou script precisar de contexto limpo em vez de ler a página completa.

Detalhe em Markdown GET /skills/abdulsamad94-backend-fastapi.md manifest assinado GET /api/skills/abdulsamad94-backend-fastapi/manifest lockfile assinado GET /api/skills/abdulsamad94-backend-fastapi/lockfile

Testar

Usando "backend-fastapi". Resuma a arquitetura do backend para um novo colaborador.

Resultado esperado:

Um breve resumo de arquitetura cobrindo o ponto de entrada FastAPI, o comando de execução local, o endpoint de chat, o endpoint de texto selecionado, módulos utilitários e serviços necessários.

Usando "backend-fastapi". Prepare notas de endpoint para a API de chat RAG.

Resultado esperado:

Um resumo legível do endpoint que explica a entrada da consulta, a etapa de busca no Qdrant, a etapa de construção do prompt, a geração da resposta do agente e os contextos retornados.

Usando "backend-fastapi". Liste o que precisa ser configurado antes de executar o backend.

Resultado esperado:

Uma checklist de configuração nomeando variáveis Gemini e Qdrant, a porta local padrão e o ponto de entrada do backend a verificar.

Auditoria de segurança

Baixo Risco
v6 • 6/28/2026

Static analysis flagged Markdown backticks, environment variable names, and one weak-cryptography pattern. Review found documentation text only: local run examples, endpoint names, file names, and required secret variable names, with no executable code, secret reading, network exfiltration, or prompt injection. The skill is safe to publish with low residual risk from documented operational commands and secret configuration names.

1
Arquivos analisados
50
Linhas analisadas
2
Review items
3
False positives ignored
Static false positives ignored (3)

These static matches were dismissed by semantic review or matched schema-only tokens, so they are shown for transparency but do not drive the quality score.

Baixo
SKILL.md:10SKILL.md:14SKILL.md:15SKILL.md:16SKILL.md:20SKILL.md:23SKILL.md:26SKILL.md:27SKILL.md:29SKILL.md:31SKILL.md:34SKILL.md:42SKILL.md:43SKILL.md:44SKILL.md:48SKILL.md:49
False Positive: Markdown Backticks Flagged as Shell Execution
Static analysis reported Ruby or shell backtick execution in SKILL.md. The cited lines are Markdown inline code for file paths, endpoint names, data type names, service names, and a local uvicorn run example; no executable Ruby, shell backtick syntax, or command interpolation is present.
The file contains prose and Markdown inline code, not Ruby or shell source. The only run command is a normal local development command and is not hidden or malicious.
Baixo
SKILL.md:48SKILL.md:49
False Positive: Secret Variable Names Listed for Configuration
Static analysis flagged generic API or secret keys on lines 48 and 49. Those lines list required environment variable names for Gemini and Qdrant configuration; the skill does not read, print, transmit, or request secret values.
The evidence is limited to environment variable names in a documentation section. No code path accesses environment contents or sends them elsewhere.
Baixo
SKILL.md:3
False Positive: Weak Cryptography Pattern Not Present
Static analysis reported a weak cryptographic algorithm at SKILL.md line 3. Line 3 is the YAML description for FastAPI documentation and contains no hash algorithm, encryption primitive, or security implementation guidance.
Manual review of the cited line found only descriptive metadata. No cryptographic term or algorithm appears at that location.

Fatores de risco

⚙️ Comandos externos (16)
SKILL.md:10 SKILL.md:14 SKILL.md:15 SKILL.md:16 SKILL.md:20 SKILL.md:23 SKILL.md:26 SKILL.md:27 SKILL.md:29 SKILL.md:31 SKILL.md:34 SKILL.md:42 SKILL.md:43 SKILL.md:44 SKILL.md:48 SKILL.md:49
🔑 Variáveis de ambiente (2)
SKILL.md:48 SKILL.md:49
Auditado por: codex Ver histórico de auditoria →

Pontuação de qualidade

55
Arquitetura
100
Manutenibilidade
87
Conteúdo
71
Comunidade
95
Segurança
83
Conformidade com a especificação

O que você pode criar

Integrar Colaboradores de Backend

Ajude novos engenheiros a entender o ponto de entrada FastAPI, o fluxo dos endpoints e os módulos de suporte antes de editar o serviço.

Preparar Documentação da API

Transforme o comportamento documentado dos endpoints em notas concisas do projeto para fluxos de trabalho de chatbot e perguntas sobre texto selecionado.

Revisar Dependências do Serviço RAG

Verifique quais serviços e variáveis de ambiente são esperados antes de executar ou solucionar problemas do backend localmente.

Teste estes prompts

Resumir o Backend 
Use a skill backend-fastapi para resumir o backend FastAPI, seu ponto de entrada, endpoints principais e serviços necessários.
Explicar o Fluxo dos Endpoints 
Use a skill backend-fastapi para explicar a requisição, as etapas de processamento e a resposta para /api/chat e /api/ask-selection.
Criar Notas de Integração 
Use a skill backend-fastapi para criar notas concisas de integração para um desenvolvedor que está entrando neste projeto de backend de chatbot.
Auditar Suposições de Dependência 
Use a skill backend-fastapi para identificar suposições de dependências do backend, variáveis de ambiente necessárias e lacunas a verificar no código-fonte.

Boas práticas

  • Use esta skill como ponto de partida e depois verifique os detalhes no código-fonte ativo do backend.
  • Mantenha chaves de API em variáveis de ambiente ou armazenamentos de segredos, nunca em prompts ou saída de documentação.
  • Combine resumos de endpoints com testes ou saída OpenAPI ao preparar documentação de release.

Evitar

  • Não presuma que esta documentação prova que o backend está em execução atualmente.
  • Não cole segredos reais Gemini ou Qdrant em prompts.
  • Não use o comando de execução local listado como método de implantação em produção.

Perguntas frequentes

Esta skill gera código FastAPI?
Não. Ela documenta a estrutura do backend, endpoints, dependências e nomes de configuração já descritos no arquivo da skill.
Ela consegue explicar o endpoint principal de chat?
Sim. Ela pode resumir a entrada de consulta documentada, a busca no Qdrant, a construção do prompt, a resposta do agente e os contextos retornados.
Ela exige acesso a chaves de API?
Não. Ela apenas nomeia variáveis de ambiente necessárias e não deve receber valores secretos.
Ela consegue validar a implementação real do backend?
Não. Ela não inspeciona código-fonte além do conteúdo documentado em SKILL.md.
Quais ferramentas de IA são compatíveis?
O relatório lista suporte para Claude, Codex e Claude Code.
É seguro usá-la em um marketplace?
Sim. A auditoria encontrou conteúdo apenas documental e nenhum comportamento malicioso confirmado.

Detalhes do desenvolvedor

Licença

MIT

Version

v1.0.0

Repositório

https://github.com/AbdulSamad94/Hackhaton-SpecsKitPlus/tree/master/.claude/skills/backend

Referência

master

Estrutura de arquivos

📄 SKILL.md