| name | create-card |
| description | Use this skill when the user asks to create a GitHub Issue. Trigger for prompts like "create a card", "open an issue", "add a task to the board", "create a bug report". Do not trigger for code creation, PR reviews, or commit generation. |
| allowed-tools | Bash(gh *) |
Guardrails
- Escopo restrito à criação de Issues — nunca criar PRs, comentários em código ou qualquer outro artefato do GitHub
- Sem acesso ao código-fonte — apenas leitura do repositório para contexto; nunca modificar arquivos
- Sem criação de Issues em repositórios externos — apenas no repositório atual
- Sem atribuição automática de responsáveis — nunca atribuir assignees sem confirmação do usuário
- Sem definição automática de milestones ou projetos — apenas title, body e labels
- Labels restritas ao conjunto definido — apenas
feat, fix, chore, spike
Skill: Create Card
MCP
1. Criar Issue via GitHub MCP
create_issue → criar a Issue com title, body e labels
Se a tool falhar, gerar cont conteúdo formatado para criação manual.
Objetivo
Guia a criação de uma Issue no GitHub seguindo os templates definidos por tipo de card. A Issue é criada diretamente via GitHub API. Em caso de falha, gera o conteúdo formatado para preenchimento manual.
Contextos Necessários
Entrada
O usuário deve fornecer:
- Tipo do card — Feature, Bug, Tech Debt ou Spike. Se não informado, perguntar:
Qual o tipo do card?
1. Feature — nova funcionalidade
2. Bug — comportamento incorreto
3. Tech Debt — melhoria técnica
4. Spike — investigação ou prova de conceito
- Título — descrição breve do card
- Detalhes — informações suficientes para preencher o template correspondente
Se os detalhes forem insuficientes para preencher alguma seção, perguntar antes de criar.
Passos
1. Confirmar entradas
Se tipo ou título não foram informados, perguntar antes de prosseguir.
2. Selecionar template
Conforme o tipo informado, selecionar o template correspondente em card-specification.md:
| Tipo | Template | Label |
|---|
| Feature | Template Feature | feat |
| Bug | Template Bug | fix |
| Tech Debt | Template Tech Debt | chore |
| Spike | Template Spike | spike |
3. Preencher template
Preencher todas as seções do template com base nas informações fornecidas pelo usuário:
- Feature: Descrição, Critérios de Aceite (Given/When/Then), Tasks Técnicas, Observações
- Bug: Descrição, Como Reproduzir, Critérios de Aceite, Tasks Técnicas, Observações
- Tech Debt: Descrição, Motivação, Critérios de Aceite, Tasks Técnicas, Observações
- Spike: Descrição, Objetivo, Critérios de Conclusão, Tasks de Investigação, Resultado Esperado, Observações
4. Criar Issue via GitHub API
POST /repos/{owner}/{repo}/issues
Authorization: Bearer {GITHUB_TOKEN}
Content-Type: application/json
{
"title": "[Tipo]: [Título]",
"body": "[conteúdo do template preenchido]",
"labels": ["[label correspondente ao tipo]"]
}
Se a chamada for bem-sucedida, retornar:
- URL da Issue criada
- Número da Issue para referência nos commits (
CARD: #[id])
5. Fallback — falha na API
Se a chamada à GitHub API falhar, gerar o conteúdo completo formatado para preenchimento manual:
## Como criar manualmente
1. Acesse: GitHub → Issues → New Issue
2. Título: [título gerado]
3. Label: [label correspondente]
4. Conteúdo:
[template preenchido completo]
Output Esperado
Sucesso via API
✅ Issue criada com sucesso!
Título: [Tipo]: [Título]
URL: https://github.com/[owner]/[repo]/issues/[id]
Referência para commits: CARD: #[id]
Fallback — conteúdo manual
⚠️ Não foi possível criar a Issue via API.
Utilize o conteúdo abaixo para criação manual:
[conteúdo completo do template preenchido]
Validação
Antes de criar a Issue, verificar:
Prompt Examples
- "cria um card de feature para o endpoint de pedidos"
- "abre uma issue de bug para o erro de autenticação"
- "adiciona um tech debt para refatorar o OrderService"
- "cria um spike para investigar o uso de Redis"
- "quero criar uma tarefa no board"
Related Skills
create-feature — iniciar o desenvolvimento após a criação do cardwrite-commit — referenciar o card criado no commit correspondente
Error Handling
- Token GitHub inválido ou ausente — informar que não é possível criar via API e gerar o conteúdo formatado para criação manual
- Tipo de card não informado — nunca assumir o tipo; sempre perguntar antes de prosseguir
- Título não informado — nunca gerar um card sem título; sempre solicitar ao usuário
- Critérios de aceite insuficientes — se a descrição fornecida não permitir gerar ao menos um critério de aceite no formato Given/When/Then, perguntar mais detalhes antes de criar
