|
| 1 | +--- |
| 2 | +name: criar-task-linear |
| 3 | +description: Use quando o usuario pedir para criar uma task, issue, card ou tarefa no Linear, ou quando mencionar criar trabalho no backlog do projeto Painel Vagas |
| 4 | +--- |
| 5 | + |
| 6 | +# Criar Task no Linear |
| 7 | + |
| 8 | +Skill para criar tasks padronizadas no Linear, no time **Painel Vagas (PAV)**. |
| 9 | + |
| 10 | +## Pre-requisito: MCP do Linear |
| 11 | + |
| 12 | +Esta skill depende do MCP server `linear-server` estar configurado. Se as ferramentas `mcp__linear-server__*` nao estiverem disponiveis, informe ao usuario: |
| 13 | + |
| 14 | +> O MCP do Linear nao esta configurado. Para usar esta skill, adicione o server `linear-server` nas configuracoes do Claude Code. Consulte a documentacao do MCP para configurar. |
| 15 | +
|
| 16 | +## Padrao obrigatorio |
| 17 | + |
| 18 | +Toda task criada deve seguir esta estrutura: |
| 19 | + |
| 20 | +| Campo | Valor | |
| 21 | +|---|---| |
| 22 | +| **Team** | `Painel Vagas` | |
| 23 | +| **State** | `Backlog` | |
| 24 | +| **Priority** | `4` (Low) — perguntar ao usuario se deseja alterar | |
| 25 | +| **Title** | Titulo objetivo e claro, em portugues | |
| 26 | +| **Description** | Markdown com descricao + criterios de aceite | |
| 27 | + |
| 28 | +## Fluxo |
| 29 | + |
| 30 | +```dot |
| 31 | +digraph flow { |
| 32 | + "Usuario pede task" -> "Coletar informacoes"; |
| 33 | + "Coletar informacoes" -> "Titulo claro?"; |
| 34 | + "Titulo claro?" -> "Montar descricao" [label="sim"]; |
| 35 | + "Titulo claro?" -> "Perguntar ao usuario" [label="nao"]; |
| 36 | + "Perguntar ao usuario" -> "Montar descricao"; |
| 37 | + "Montar descricao" -> "Perguntar prioridade"; |
| 38 | + "Perguntar prioridade" -> "Criar no Linear"; |
| 39 | + "Criar no Linear" -> "Confirmar ao usuario"; |
| 40 | +} |
| 41 | +``` |
| 42 | + |
| 43 | +1. Extrair ou perguntar: o que a task deve resolver |
| 44 | +2. Redigir titulo objetivo (portugues, sem prefixos como "Task:" ou "feat:") |
| 45 | +3. Montar descricao em Markdown com secoes obrigatorias (ver template) |
| 46 | +4. **Perguntar ao usuario** se quer manter prioridade Low ou alterar (Urgent=1, High=2, Medium=3, Low=4) |
| 47 | +5. Criar a issue via `mcp__linear-server__save_issue` |
| 48 | +6. Confirmar com o identificador (ex: PAV-42) e link |
| 49 | + |
| 50 | +## Template de descricao |
| 51 | + |
| 52 | +```markdown |
| 53 | +## Contexto |
| 54 | +[O que motivou essa task e qual problema ela resolve] |
| 55 | + |
| 56 | +## O que deve ser feito |
| 57 | +[Descricao clara do trabalho esperado] |
| 58 | + |
| 59 | +## Criterios de aceite |
| 60 | +- [ ] [Criterio 1] |
| 61 | +- [ ] [Criterio 2] |
| 62 | +- [ ] [Criterio 3] |
| 63 | +``` |
| 64 | + |
| 65 | +## Exemplo de chamada |
| 66 | + |
| 67 | +``` |
| 68 | +mcp__linear-server__save_issue( |
| 69 | + team: "Painel Vagas", |
| 70 | + title: "Adicionar validacao de email no formulario de registro", |
| 71 | + description: "## Contexto\nO formulario de registro aceita emails invalidos...\n\n## O que deve ser feito\nAdicionar validacao de formato de email...\n\n## Criterios de aceite\n- [ ] Emails invalidos exibem mensagem de erro\n- [ ] Emails validos passam sem bloqueio\n- [ ] Testes unitarios cobrem os cenarios", |
| 72 | + state: "Backlog", |
| 73 | + priority: 4 |
| 74 | +) |
| 75 | +``` |
| 76 | + |
| 77 | +## Prioridades disponiveis |
| 78 | + |
| 79 | +| Valor | Nome | |
| 80 | +|---|---| |
| 81 | +| 1 | Urgente | |
| 82 | +| 2 | Alta | |
| 83 | +| 3 | Media | |
| 84 | +| 4 | Baixa (padrao) | |
| 85 | + |
| 86 | +## Erros comuns |
| 87 | + |
| 88 | +- **Nao perguntar a prioridade** — sempre perguntar antes de criar |
| 89 | +- **Titulo vago** — "Corrigir bug" nao serve; use "Corrigir erro de autenticacao ao fazer login com Google" |
| 90 | +- **Sem criterios de aceite** — toda task deve ter pelo menos 2 criterios verificaveis |
| 91 | +- **Idioma errado** — titulo e descricao devem ser em portugues |
0 commit comments