Engenharia de Instruções & Social

Prompt Hub

Guia de Operação & Boas Práticas

A arte de estruturar prompts de alta performance. Gerencie, compartilhe, versione e colabore em instruções reutilizáveis.

Abrir Prompt Hub

Engenharia de Instrução

"Um bom prompt economiza horas de código e refinamento. No Hub, transformamos intuição individual em ativos reutilizáveis para todo o time."

Operação Social & Produtividade

Como catalogar e rodar templates inteligentes de prompts.

1. Fork & Coleção

Descubra instruções criadas por outras squads, faça um Fork para sua coleção privada e adapte as regras para seu projeto.

2. Variáveis Dinâmicas

Use marcações como [CONTEXTO] ou [FRAMEWORK] no corpo do prompt. O sistema solicita os inputs ao executar o template.

Integração de Máquina & API

API REST & Ferramentas do Prompt Hub

Consultar prompts/coleções públicas e publicar/atualizar skills de agentes por REST ou MCP.

Header: X-Api-Key

Como Obter sua Chave e Autenticar

Toda chamada exige o envio do header X-Api-Key: ask_.... Você pode gerar sua chave pessoal em Meu Espaço → Conectividade ou via painel de administração em Admin → API Keys.

Endpoints REST Disponíveis

GET/api/v1/prompt-hub/items

Lista prompts públicos.

Parâmetros: q (título/descrição/conteúdo), authorId, tag, page (1-based), pageSize (máx 100)

Retorno: { items[], page, pageSize, total, totalPages }

GET/api/v1/prompt-hub/items/{id}

Um prompt público completo.

Retorno: o prompt inteiro; 404 se for privado

GET/api/v1/prompt-hub/collections

Lista coleções públicas (trilhas de prompts).

Parâmetros: ownerId, page (1-based), pageSize (máx 100)

Retorno: { collections[], page, pageSize, total, totalPages }

GET/api/v1/prompt-hub/collections/{id}

Uma coleção com os prompts embutidos.

Retorno: a coleção + items[] já resolvidos (só os públicos)

POST/api/v1/prompt-hub/items

Importa ou cria uma skill/prompt (com suporte a SKILL.md e frontmatter YAML).

Parâmetros: title (ou name no frontmatter), content, description?, tags?, visibility?

Retorno: o prompt/skill criado com id

Exemplo Prático de Chamada

cURL

# 1. Listar prompts públicos:
curl -s "https://espacoagil.com.br/api/v1/prompt-hub/items?q=retrospectiva&pageSize=10" \
  -H "X-Api-Key: ask_SUA_CHAVE_AQUI"

# 2. Subir ou atualizar uma skill (SKILL.md com YAML frontmatter):
curl -X POST "https://espacoagil.com.br/api/v1/prompt-hub/items" \
  -H "X-Api-Key: ask_SUA_CHAVE_AQUI" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "---\nname: map-delphi-project\ndescription: Diagnóstico arquitetural de projetos Delphi\n---\n# Guia de Mapeamento...",
    "type": "skill",
    "visibility": "public"
  }'

Regras de Negócio & Detalhes de Integração

Leitura só enxerga registros com visibility="public" — mesmo recorte que a regra do Firestore aplica a quem não tem sessão.
Escrita habilitada via POST /api/v1/prompt-hub/items para ingestão automatizada de skills por IAs ou scripts externos.
Suporta extração automática de metadados do YAML frontmatter (name, description) e blocos com quebra de linha (>-).
Numa coleção, itens que ficaram privados depois de adicionados simplesmente somem do items[] — a coleção volta menor, sem erro.