Communitygithub.com

tangjuyo/reels-blocker

Gera um tasks.md acionável e ordenado por dependências para a funcionalidade com base nos artefatos de design disponíveis.

O que é reels-blocker?

Esta skill gera um arquivo `tasks.md` estruturado e acionável a partir de artefatos de design, como `plan.md`, `spec.md`, `data-model.md` e `contracts/`. Ela organiza as tarefas por histórias de usuário em fases, seguindo regras rigorosas de formato com IDs, marcadores de prioridade e caminhos de arquivo. A skill suporta hooks de extensão opcionais e obrigatórios (via `.specify/extensions.yml`) para automação antes e depois da geração, e trabalha com qualquer plataforma de agente que aceite comandos slash ou execução de scripts. Ideal para times de desenvolvimento que precisam de um plano de implementação granular, independente e testável para novas funcionalidades.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/tangjuyo/reels-blocker/tree/HEAD/.claude/skills/speckit-tasks

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Entrada do Usuário

$ARGUMENTS

Você DEVE considerar a entrada do usuário antes de prosseguir (se não estiver vazia).

Verificações de Pré-Execução

Verificar hooks de extensão (antes da geração de tarefas):

  • Verifique se .specify/extensions.yml existe na raiz do projeto.
  • Se existir, leia-o e procure por entradas sob a chave hooks.before_tasks.
  • Se o YAML não puder ser analisado ou for inválido, não ignore silenciosamente: informe ao usuário que .specify/extensions.yml não pôde ser lido (inclua o erro do analisador) e que nenhum hook foi verificado, incluindo quaisquer hooks obrigatórios (optional: false) registrados ali, depois continue normalmente.
  • Filtre hooks onde enabled é explicitamente false. Trate hooks sem um campo enabled como habilitados por padrão.
  • Para cada hook restante, não tente interpretar ou avaliar expressões de condition do hook:
    • Se o hook não tiver um campo condition, ou ele for nulo/vazio, trate o hook como executável.
    • Se o hook definir uma condition não vazia, pule o hook e deixe a avaliação da condição para a implementação do HookExecutor.
  • Ao construir invocações de comando a partir de nomes de comando de hook, substitua pontos (.) por hífens (-). Por exemplo, speckit.git.commit → /speckit-git-commit.
  • Para cada hook executável, produza a seguinte saída com base em sua flag optional:
    • Hook opcional (optional: true):
      ## Extension Hooks
      
      **Pre-Hook Opcional**: {extension}
      Comando: `/{command}`
      Descrição: {description}
      
      Prompt: {prompt}
      Para executar: `/{command}`
      
    • Hook obrigatório (optional: false):
      ## Extension Hooks
      
      **Pre-Hook Automático**: {extension}
      Executando: `/{command}`
      EXECUTE_COMMAND: {command}
      
      Aguarde o resultado do comando do hook antes de prosseguir para o Esboço.
      
      Após emitir o bloco acima, você DEVE realmente invocar o hook e aguardar sua conclusão antes de continuar. Execute-o da mesma forma que você executaria o comando neste agente/sessão (a invocação pode diferir do {command} literal mostrado acima, por exemplo, um agente em modo skills o executa como /skill:speckit-... ou $speckit-...). Apenas emitir o bloco não executa o hook.
  • Se nenhum hook estiver registrado ou .specify/extensions.yml não existir, ignore silenciosamente.

Esboço

  1. Configuração: Execute .specify/scripts/bash/setup-tasks.sh --json a partir da raiz do repositório e analise FEATURE_DIR, TASKS_TEMPLATE_CONTENT, TASKS_TEMPLATE e AVAILABLE_DOCS. FEATURE_DIR e TASKS_TEMPLATE devem ser caminhos absolutos quando fornecidos. AVAILABLE_DOCS é uma lista de nomes de documentos/caminhos relativos disponíveis em FEATURE_DIR (por exemplo, research.md ou contracts/). Para aspas simples em argumentos como "I'm Groot", use sintaxe de escape: por exemplo, 'I'''m Groot' (ou aspas duplas se possível: "I'm Groot").

  2. Carregar documentos de design: Leia de FEATURE_DIR:

    • Obrigatório: plan.md (stack tecnológica, bibliotecas, estrutura), spec.md (histórias de usuário com prioridades).
    • Opcional: data-model.md (entidades), contracts/ (contratos de interface), research.md (decisões), quickstart.md (cenários de teste).
    • SE EXISTIR: Carregue .specify/memory/constitution.md para princípios do projeto e restrições de governança.
    • Nota: Nem todos os projetos têm todos os documentos. Gere tarefas com base no que estiver disponível.
  3. Executar o fluxo de trabalho de geração de tarefas:

    • Carregue plan.md e extraia stack tecnológica, bibliotecas, estrutura do projeto.
    • Carregue spec.md e extraia histórias de usuário com suas prioridades (P1, P2, P3, etc.).
    • Se data-model.md existir: Extraia entidades e mapeie para histórias de usuário.
    • Se contracts/ existir: Mapeie contratos de interface para histórias de usuário.
    • Se research.md existir: Extraia decisões para tarefas de configuração.
    • Gere tarefas organizadas por história de usuário (veja Regras de Geração de Tarefas abaixo).
    • Gere o grafo de dependências mostrando a ordem de conclusão das histórias de usuário.
    • Crie exemplos de execução paralela por história de usuário.
    • Valide a completude das tarefas (cada história de usuário tem todas as tarefas necessárias, testáveis independentemente).
  4. Gerar tasks.md: Use TASKS_TEMPLATE_CONTENT (da saída JSON acima) como estrutura. Para compatibilidade com scripts de configuração mais antigos que omitem TASKS_TEMPLATE_CONTENT, leia TASKS_TEMPLATE em vez disso. Preencha com:

    • Nome correto da funcionalidade de plan.md.
    • Fase 1: Tarefas de configuração (inicialização do projeto).
    • Fase 2: Tarefas fundamentais (pré-requisitos bloqueantes para todas as histórias de usuário).
    • Fase 3+: Uma fase por história de usuário (em ordem de prioridade de spec.md).
    • Cada fase inclui: objetivo da história, critérios de teste independentes, testes (se solicitados), tarefas de implementação.
    • Fase Final: Polimento e preocupações transversais.
    • Todas as tarefas devem seguir o formato rigoroso de lista de verificação (veja Regras de Geração de Tarefas abaixo).
    • Caminhos de arquivo claros para cada tarefa.
    • Seção de dependências mostrando ordem de conclusão das histórias.
    • Exemplos de execução paralela por história.
    • Seção de estratégia de implementação (MVP primeiro, entrega incremental).

Hooks de Pós-Execução Obrigatórios

Você DEVE concluir esta seção antes de relatar a conclusão ao usuário.

Verifique se .specify/extensions.yml existe na raiz do projeto.

  • Se não existir, ou nenhum hook estiver registrado sob a chave hooks.after_tasks, pule para o Relatório de Conclusão.
  • Se existir, leia-o e procure por entradas sob a chave hooks.after_tasks.
  • Se o YAML não puder ser analisado ou for inválido, não ignore silenciosamente: informe ao usuário que .specify/extensions.yml não pôde ser lido (inclua o erro do analisador) e que nenhum hook foi verificado, incluindo quaisquer hooks obrigatórios (optional: false) registrados ali, depois continue para o Relatório de Conclusão.
  • Filtre hooks onde enabled é explicitamente false. Trate hooks sem um campo enabled como habilitados por padrão.
  • Para cada hook restante, não tente interpretar ou avaliar expressões de condition do hook:
    • Se o hook não tiver um campo condition, ou ele for nulo/vazio, trate o hook como executável.
    • Se o hook definir uma condition não vazia, pule o hook e deixe a avaliação da condição para a implementação do HookExecutor.
  • Ao construir invocações de comando a partir de nomes de comando de hook, substitua pontos (.) por hífens (-). Por exemplo, speckit.git.commit → /speckit-git-commit.
  • Para cada hook executável, produza a seguinte saída com base em sua flag optional:
    • Hook obrigatório (optional: false) — Você DEVE emitir EXECUTE_COMMAND: para cada hook obrigatório:
      ## Extension Hooks
      
      **Hook Automático**: {extension}
      Executando: `/{command}`
      EXECUTE_COMMAND: {command}
      
      Após emitir o bloco acima, você DEVE realmente invocar o hook e aguardar sua conclusão antes de continuar. Execute-o da mesma forma que você executaria o comando neste agente/sessão (a invocação pode diferir do {command} literal mostrado acima, por exemplo, um agente em modo skills o executa como /skill:speckit-... ou $speckit-...). Apenas emitir o bloco não executa o hook.
    • Hook opcional (optional: true):
      ## Extension Hooks
      
      **Hook Opcional**: {extension}
      Comando: `/{command}`
      Descrição: {description}
      
      Prompt: {prompt}
      Para executar: `/{command}`
      

Relatório de Conclusão

Caminho de saída para tasks.md gerado e resumo:

  • Contagem total de tarefas.
  • Contagem de tarefas por história de usuário.
  • Oportunidades paralelas identificadas.
  • Critérios de teste independentes para cada história.
  • Escopo MVP sugerido (tipicamente apenas a História de Usuário 1).
  • Validação de formato: Confirme que TODAS as tarefas seguem o formato de lista de verificação (caixa de seleção, ID, rótulos, caminhos de arquivo).

Contexto para geração de tarefas: $ARGUMENTS

O tasks.md deve ser imediatamente executável — cada tarefa deve ser específica o suficiente para que um LLM possa completá-la sem contexto adicional.

Regras de Geração de Tarefas

CRÍTICO: Tarefas DEVEM ser organizadas por história de usuário para permitir implementação e teste independentes.

Testes são OPCIONAIS: Gere tarefas de teste apenas se explicitamente solicitado na especificação da funcionalidade ou se o usuário solicitar abordagem TDD.

Formato de Lista de Verificação (OBRIGATÓRIO)

Cada tarefa DEVE seguir estritamente este formato:

- [ ] [TaskID] [P?] [Story?] Descrição com caminho do arquivo

Componentes do Formato:

  1. Caixa de seleção: SEMPRE comece com - [ ] (caixa de seleção markdown).
  2. ID da Tarefa: Número sequencial (T001, T002, T003...) em ordem de execução.
  3. Marcador [P]: Inclua APENAS se a tarefa for paralelizável (arquivos diferentes, sem dependências de tarefas incompletas).
  4. Rótulo [Story]: OBRIGATÓRIO para tarefas da fase de história de usuário apenas.
    • Formato: [US1], [US2], [US3], etc. (mapeia para histórias de usuário de spec.md).
    • Fase de configuração: SEM rótulo de história.
    • Fase fundamental: SEM rótulo de história.
    • Fases de história de usuário: DEVEM ter rótulo de história.
    • Fase de polimento: SEM rótulo de história.
  5. Descrição: Ação clara com caminho exato do arquivo.

Exemplos:

  • ✅ CORRETO: - [ ] T001 Criar estrutura do projeto conforme plano de implementação
  • ✅ CORRETO: - [ ] T005 [P] Implementar middleware de autenticação em src/middleware/auth.py
  • ✅ CORRETO: - [ ] T012 [P] [US1] Criar modelo User em src/models/user.py
  • ✅ CORRETO: - [ ] T014 [US1] Implementar UserService em src/services/user_service.py
  • ❌ ERRADO: - [ ] Criar modelo User (faltando ID e rótulo de história)
  • ❌ ERRADO: T001 [US1] Criar modelo (faltando caixa de seleção)
  • ❌ ERRADO: - [ ] [US1] Criar modelo User (faltando ID da tarefa)
  • ❌ ERRADO: - [ ] T001 [US1] Criar modelo (faltando caminho do arquivo)

Organização de Tarefas

  1. Das Histórias de Usuário (spec.md) — ORGANIZAÇÃO PRIMÁRIA:

    • Cada história de usuário (P1, P2, P3...) recebe sua própria fase.
    • Mapeie todos os componentes relacionados para sua história:
      • Modelos necessários para aquela história.
      • Serviços necessários para aquela história.
      • Interfaces/UI necessárias para aquela história.
      • Se testes forem solicitados: Testes específicos para aquela história.
    • Marque dependências das histórias (a maioria das histórias deve ser independente).
  2. Dos Contratos:

    • Mapeie cada contrato de interface → para a história de usuário que ele serve.
    • Se testes forem solicitados: Cada contrato de interface → tarefa de teste de contrato [P] antes da implementação na fase daquela história.
  3. Do Modelo de Dados:

    • Mapeie cada entidade para a(s) história(s) de usuário que precisam dela.
    • Se a entidade serve múltiplas histórias: Coloque na história mais antiga ou na fase de Configuração.
    • Relacionamentos → tarefas de camada de serviço na fase de história apropriada.
    • Para cada campo com restrições em data-model.md (comprimento máximo, nullable/obrigatório, valores de enum, regras de validação), cite a restrição literalmente na descrição da tarefa para que não seja deixada ao critério do momento da implementação.
  4. Da Configuração/Infraestrutura:

    • Infraestrutura compartilhada → Fase de Configuração (Fase 1).
    • Tarefas fundamentais/bloqueantes → Fase Fundamental (Fase 2).
    • Configuração específica da história → dentro da fase daquela história.

Estrutura de Fases

  • Fase 1: Configuração (inicialização do projeto).
  • Fase 2: Fundamental (pré-requisitos bloqueantes — DEVE ser concluída antes das histórias de usuário).
  • Fase 3+: Histórias de Usuário em ordem de prioridade (P1, P2, P3...).
    • Dentro de cada história: Testes (se solicitados) → Modelos → Serviços → Endpoints → Integração.
    • Cada fase deve ser um incremento completo e testável independentemente.
  • Fase Final: Polimento e Preocupações Transversais.

Concluído Quando

  • tasks.md gerado com todas as fases, IDs de tarefas e caminhos de arquivo.
  • Hooks de extensão despachados ou ignorados de acordo com as regras em Hooks de Pós-Execução Obrigatórios acima.
  • Conclusão relatada ao usuário com contagem de tarefas, detalhamento por história e escopo MVP.

Individual skills in this repo

This repo contains 9 individual skills — each has its own dedicated page.

Habilidades Relacionadas