Communitygithub.com

tangjuyo/bloqueador-de-reels

Executa o fluxo de trabalho de planejamento de implementação usando o modelo de plano para gerar artefatos de design.

O que é bloqueador-de-reels?

Esta skill orquestra o fluxo de trabalho de planejamento de implementação para projetos de software. Ela é útil para desenvolvedores e agentes de IA que precisam planejar e documentar a implementação de novas funcionalidades de forma estruturada, gerando artefatos de design como especificações de funcionalidades, modelos de dados, contratos de interface e guias de validação. A skill é agnóstica de plataforma, funcionando em qualquer ambiente que suporte a execução de scripts bash e tenha os arquivos de configuração necessários (.specify/). O fluxo começa carregando a especificação da funcionalidade e a constituição do projeto, executa verificações de extensão (hooks) antes e depois do planejamento, gera um documento de pesquisa para resolver incertezas, e então produz os artefatos de design finais. Ela também gerencia a execução de hooks opcionais e obrigatórios, garantindo que extensões possam ser integradas ao processo de planejamento.

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

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

Verifique por ganchos de extensão (antes do planejamento):

  • Verifique se .specify/extensions.yml existe na raiz do projeto.
  • Se existir, leia-o e procure por entradas sob a chave hooks.before_plan.
  • Se o YAML não puder ser analisado ou for inválido, não pule silenciosamente: informe ao usuário que .specify/extensions.yml não pôde ser lido (inclua o erro do analisador) e que nenhum gancho foi verificado, incluindo quaisquer ganchos obrigatórios (optional: false) registrados lá, e continue normalmente.
  • Filtre os ganchos onde enabled está explicitamente false. Trate ganchos sem o campo enabled como habilitados por padrão.
  • Para cada gancho restante, não tente interpretar ou avaliar expressões de condition do gancho:
    • Se o gancho não tiver o campo condition, ou ele for nulo/vazio, trate o gancho como executável.
    • Se o gancho definir uma condition não vazia, pule o gancho 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 gancho, substitua pontos (.) por hífens (-). Por exemplo, speckit.git.commit → /speckit-git-commit.
  • Para cada gancho executável, produza o seguinte com base em sua flag optional:
    • Gancho opcional (optional: true):
      ## Ganchos de Extensão
      
      **Gancho Pré-Hook Opcional**: {extensão}
      Comando: `/{comando}`
      Descrição: {descrição}
      
      Prompt: {prompt}
      Para executar: `/{comando}`
      
    • Gancho obrigatório (optional: false):
      ## Ganchos de Extensão
      
      **Gancho Pré-Hook Automático**: {extensão}
      Executando: `/{comando}`
      EXECUTE_COMMAND: {comando}
      
      Aguarde o resultado do comando do gancho antes de prosseguir para o Esboço.
      
      Após emitir o bloco acima, você DEVE realmente invocar o gancho 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 literal {comando} mostrado acima, por exemplo, um agente em modo skills executa como /skill:speckit-... ou $speckit-...). Apenas emitir o bloco não executa o gancho.
  • Se nenhum gancho estiver registrado ou .specify/extensions.yml não existir, pule silenciosamente.

Esboço

  1. Configuração: Execute .specify/scripts/bash/setup-plan.sh --json da raiz do repositório e analise o JSON para FEATURE_SPEC, IMPL_PLAN, FEATURE_DIR, BRANCH. Para aspas simples em argumentos como "Eu sou o Groot", use sintaxe de escape: por exemplo 'Eu'''sou o Groot' (ou aspas duplas, se possível: "Eu sou o Groot").

  2. Carregar contexto: Leia FEATURE_SPEC e .specify/memory/constitution.md. Carregue o modelo IMPL_PLAN (já copiado).

  3. Executar fluxo de trabalho do plano: Siga a estrutura no modelo IMPL_PLAN para:

    • Preencher o Contexto Técnico (marque desconhecidos como "PRECISA DE ESCLARECIMENTO")
    • Preencher a seção Verificação Constitucional a partir da constituição
    • Avaliar portões (ERROR se violações injustificadas)
    • Fase 0: Gerar research.md (resolver todos os PRECISA DE ESCLARECIMENTO)
    • Fase 1: Gerar data-model.md, contracts/, quickstart.md
    • Reavaliar Verificação Constitucional pós-design

Ganchos 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 se nenhum gancho estiver registrado sob hooks.after_plan, pule para o Relatório de Conclusão.
  • Se existir, leia-o e procure por entradas sob a chave hooks.after_plan.
  • Se o YAML não puder ser analisado ou for inválido, não pule silenciosamente: informe ao usuário que .specify/extensions.yml não pôde ser lido (inclua o erro do analisador) e que nenhum gancho foi verificado, incluindo quaisquer ganchos obrigatórios (optional: false) registrados lá, e continue para o Relatório de Conclusão.
  • Filtre os ganchos onde enabled está explicitamente false. Trate ganchos sem o campo enabled como habilitados por padrão.
  • Para cada gancho restante, não tente interpretar ou avaliar expressões de condition do gancho:
    • Se o gancho não tiver o campo condition, ou ele for nulo/vazio, trate o gancho como executável.
    • Se o gancho definir uma condition não vazia, pule o gancho 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 gancho, substitua pontos (.) por hífens (-). Por exemplo, speckit.git.commit → /speckit-git-commit.
  • Para cada gancho executável, produza o seguinte com base em sua flag optional:
    • Gancho obrigatório (optional: false) — Você DEVE emitir EXECUTE_COMMAND: para cada gancho obrigatório:
      ## Ganchos de Extensão
      
      **Gancho Automático**: {extensão}
      Executando: `/{comando}`
      EXECUTE_COMMAND: {comando}
      
      Após emitir o bloco acima, você DEVE realmente invocar o gancho 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 literal {comando} mostrado acima, por exemplo, um agente em modo skills executa como /skill:speckit-... ou $speckit-...). Apenas emitir o bloco não executa o gancho.
    • Gancho opcional (optional: true):
      ## Ganchos de Extensão
      
      **Gancho Opcional**: {extensão}
      Comando: `/{comando}`
      Descrição: {descrição}
      
      Prompt: {prompt}
      Para executar: `/{comando}`
      

Relatório de Conclusão

O comando termina após o design da Fase 1. Relate o branch, o caminho do IMPL_PLAN e os artefatos gerados.

Fases

Fase 0: Esboço e Pesquisa

  1. Extraia desconhecidos do Contexto Técnico acima:

    • Para cada PRECISA DE ESCLARECIMENTO → tarefa de pesquisa
    • Para cada dependência → tarefa de melhores práticas
    • Para cada integração → tarefa de padrões
  2. Gere e despache agentes de pesquisa:

    Para cada desconhecido no Contexto Técnico:
      Tarefa: "Pesquisar {desconhecido} para {contexto da funcionalidade}"
    Para cada escolha de tecnologia:
      Tarefa: "Encontrar melhores práticas para {tecnologia} em {domínio}"
    
  3. Consolide os resultados em research.md usando o formato:

    • Decisão: [o que foi escolhido]
    • Justificativa: [por que foi escolhido]
    • Alternativas consideradas: [o que mais foi avaliado]

Saída: research.md com todos os PRECISA DE ESCLARECIMENTO resolvidos

Fase 1: Design e Contratos

Pré-requisitos: research.md completo

  1. Extraia entidades da especificação da funcionalidade → data-model.md:

    • Nome da entidade, campos, relacionamentos
    • Regras de validação a partir dos requisitos
    • Transições de estado, se aplicável
  2. Defina contratos de interface (se o projeto tiver interfaces externas) → /contracts/:

    • Identifique quais interfaces o projeto expõe para usuários ou outros sistemas
    • Documente o formato de contrato apropriado para o tipo de projeto
    • Exemplos: APIs públicas para bibliotecas, esquemas de comando para ferramentas CLI, endpoints para serviços web, gramáticas para parsers, contratos de UI para aplicações
    • Pule se o projeto for puramente interno (scripts de build, ferramentas descartáveis, etc.)
  3. Crie um guia de validação quickstart → quickstart.md:

    • Documente cenários de validação executáveis que provem que a funcionalidade funciona de ponta a ponta
    • Inclua pré-requisitos, comandos de configuração, comandos de teste/execução e resultados esperados
    • Use links ou referências para contratos e detalhes do modelo de dados em vez de duplicá-los
    • Não inclua código de implementação completo, corpos de modelos/serviços/controladores, migrações ou suítes de teste completas
    • Mantenha este artefato como um guia de validação/execução; os detalhes de implementação pertencem a tasks.md e à fase de implementação

Saída: data-model.md, /contracts/*, quickstart.md

Regras-chave

  • Use caminhos absolutos para operações de sistema de arquivos; use caminhos relativos ao projeto para referências na documentação
  • ERROR em falhas de portão ou esclarecimentos não resolvidos

Feito Quando

  • Fluxo de trabalho do plano executado e artefatos de design gerados
  • Ganchos de extensão despachados ou pulados de acordo com as regras em Ganchos de Pós-Execução Obrigatórios acima
  • Conclusão reportada ao usuário com branch, caminho do plano e artefatos gerados

Individual skills in this repo

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

Habilidades Relacionadas