voltar ao catálogo

executar-task

Implementa tarefas de funcionalidades carregando skills necessárias, lendo contexto de PRD/TechSpec/Investigação/Spike, analisando dependências e executando a implementação com testes. Marca tarefas como concluídas no tasks.md e aciona o agente task-reviewer ao finalizar. Use quando o usuário pedir para implementar uma tarefa, executar uma tarefa ou começar a trabalhar em um número de tarefa específico. Não use para criar tarefas, rodar QA, revisão de código ou correção de bugs.

Versão: v1.0.0Autor: Fabio de StefaniPlugin: executar-taskTags: task, implementacao, execucao, testes
/plugin install executar-task@nextfit-hub-ai

Execução de Tarefas

Skills Companheiras

Esta skill invoca outras skills do marketplace durante a execução. Cada skill funciona independentemente, mas o fluxo canônico pressupõe:

Obrigatórias em runtime (a etapa é abortada se não estiverem disponíveis):

  • verificar-testes-pre-impl — Etapa 5: verifica cobertura de testes antes da implementação.
  • task-review — Etapa 8: revisão automatizada ao concluir a task.

Opcionais (carregadas conforme o contexto da task):

  • criar-testes-unitarios — Etapa 2: quando a task envolve criar/alterar testes C#.
  • code-reviewer — Etapa 2: quando a task pede review pragmático antes do commit.

Pré-requisito (produz o input):

  • criar-tasks — gera [num]_task.md + tasks.md que esta skill consome.

Comando para instalar o pacote completo:

/plugin install criar-tasks@nextfit-hub-ai
/plugin install executar-task@nextfit-hub-ai
/plugin install verificar-testes-pre-impl@nextfit-hub-ai
/plugin install task-review@nextfit-hub-ai
/plugin install criar-testes-unitarios@nextfit-hub-ai
/plugin install code-reviewer@nextfit-hub-ai

Se uma skill obrigatória não estiver disponível na sessão, informe o usuário para instalá-la antes de prosseguir.

Procedimentos

Etapa 1: Configuração Pré-Tarefa (Obrigatória)

  1. Identifique o tipo e nome do documento-fonte a partir do input do usuário. As tasks ficam em subdiretórios organizados por tipo:
    • ./docs/tasks/prd-[nome]/ — tasks de PRD
    • ./docs/tasks/investigacao-[nome]/ — tasks de Investigação
    • ./docs/tasks/spike-[nome]/ — tasks de Spike
  2. Leia o arquivo de definição da tarefa em ./docs/tasks/[tipo]-[nome]/[num]_task.md.
  3. Leia o documento-fonte conforme o tipo:
    • PRD: ./docs/tasks/prd-[nome]/prd.md
    • Investigação: ./docs/tasks/investigacao-[nome]/investigacao.md
    • Spike: ./docs/tasks/spike-[nome]/spike.md
  4. Leia o Tech Spec em ./docs/tasks/[tipo]-[nome]/techspec.md para requisitos técnicos.
  5. Leia o tasks.md do subdiretório para entender o contexto geral e dependências entre tasks.
  6. Identifique dependências de tarefas anteriores e verifique se estão concluídas.
  7. NÃO pule nenhuma dessas leituras.

Etapa 2: Carregar Skills e Padrões do Projeto

  1. Leia CLAUDE.md na raiz do projeto para regras gerais e armadilhas comuns.
  2. Leia os padrões de código em .claude/rules/:
    • .claude/rules/code-style.md — estilo de código
    • .claude/rules/naming-conventions.md — convenções de nomenclatura
    • .claude/rules/entity-patterns.md — padrões de entidade
    • .claude/rules/service-patterns.md — padrões de serviço
    • .claude/rules/repository-patterns.md — padrões de repositório
    • .claude/rules/application-patterns.md — padrões de aplicação
    • .claude/rules/controller-patterns.md — padrões de controller
    • .claude/rules/testing-patterns.md — padrões de testes
    • .claude/rules/rabbitmq-patterns.md — padrões de RabbitMQ
    • .claude/rules/infrastructure-patterns.md — padrões de infraestrutura
  3. Leia o checklist consolidado em references/code-standards.md.
  4. Identifique as tecnologias envolvidas na tarefa (EF Core, RabbitMQ, Hangfire, FluentValidation, etc.).
  5. Carregue as skills correspondentes do marketplace com base nas tecnologias utilizadas (ex: criar-testes-unitarios, escrever-queries, code-reviewer).
  6. Use o Context7 MCP para analisar a documentação das bibliotecas e frameworks envolvidos quando necessário.

Etapa 3: Análise da Tarefa (Obrigatória)

  1. Analise a tarefa considerando:
    • Objetivos principais.
    • Como a tarefa se encaixa no contexto do projeto.
    • Alinhamento com as regras e padrões do projeto (.claude/rules/).
    • Possíveis abordagens ou soluções.
  2. EXIBA ao usuário um resumo da tarefa com os seguintes campos (não prossiga sem exibir):
    • ID e Nome da Tarefa.
    • Contexto do documento-fonte (pontos principais).
    • Requisitos do Tech Spec (requisitos técnicos principais).
    • Dependências.
    • Objetivos Principais.
    • Riscos/Desafios.

Etapa 4: Plano de Abordagem (Obrigatório)

  1. EXIBA ao usuário uma abordagem passo a passo numerada antes de escrever qualquer código.
  2. NÃO inicie a Etapa 6 sem ter exibido o plano nesta etapa.

Etapa 5: Verificação de Cobertura de Testes Pré-Implementação (Obrigatória)

Execute o subagent verificar-testes-pre-impl.

  1. Forneça ao subagent a lista de arquivos-fonte existentes que serão modificados, identificados nas Etapas 3 e 4.
  2. O subagent verificará a cobertura de testes e, se necessário, perguntará ao usuário se deseja criá-los antes da implementação.
  3. Aguarde a conclusão do subagent e exiba o resultado ao usuário antes de prosseguir para a Etapa 6.

Etapa 6: Implementação (Obrigatória)

  1. Inicie a implementação imediatamente após a verificação de testes.
  2. Siga todos os padrões do projeto estabelecidos no CLAUDE.md, .claude/rules/ e references/code-standards.md.
  3. Implemente soluções sem gambiarras ou workarounds.
  4. Crie e execute todos os testes da tarefa antes de considerá-la finalizada.

Etapa 7: Marcar Tarefa como Concluída (Obrigatório)

  1. Após implementação e testes bem-sucedidos, marque a tarefa como concluída no ./docs/tasks/[tipo]-[nome]/tasks.md.

Etapa 8: Revisão (Obrigatória)

  1. Invoque a Skill task-review usando o Skill tool com os argumentos [num] [tipo]-[nome] (ex: task-review com args 2 prd-otimizacao-vazao-items-4-2-3-e-4-3-1). Esta skill é responsável por conduzir a revisão completa e gerar o artefato [num]_task_review.md no subdiretório da task.
  2. Aguarde a conclusão da skill — ela executará build, testes e criará o arquivo de revisão automaticamente.
  3. Corrija quaisquer problemas críticos ou major identificados pelo revisor.
  4. Não finalize a tarefa até que os problemas da revisão sejam resolvidos.

Tratamento de Erros

  • Se o diretório ./docs/tasks/ não existir ou estiver vazio, informe ao usuário que não há tasks geradas.
  • Se o arquivo da tarefa não existir, liste os subdiretórios disponíveis em ./docs/tasks/ e peça ao usuário para especificar.
  • Se as dependências não estiverem concluídas, avise o usuário e pergunte se deve prosseguir.
  • Se os testes falharem, corrija os problemas antes de marcar a tarefa como concluída.
  • Se o task-reviewer identificar problemas críticos, resolva-os antes de finalizar.