Communitygithub.com

tangjuyo/reels-blocker

Converte tarefas existentes em issues do GitHub acionáveis e ordenadas por dependência, com base nos artefatos de design disponíveis.

O que é reels-blocker?

Este skill converte uma lista de tarefas de um arquivo `tasks.md` em issues do GitHub devidamente ordenadas por dependência. Ele primeiro verifica a existência de hooks de extensão configurados no arquivo `.specify/extensions.yml`, executando hooks opcionais ou obrigatórios antes e depois da conversão. Em seguida, obtém o diretório da funcionalidade e a lista de documentos disponíveis executando um script de pré-requisitos, carrega a constituição do projeto (se existir) e valida se o repositório Git remoto é um URL do GitHub. O skill faz a deduplicação de issues já existentes que correspondem a IDs de tarefa (no formato `Txxx` ou mais dígitos), usando o MCP server do GitHub com paginação eficiente. Por fim, cria novas issues apenas para tarefas que ainda não possuem issue correspondente, seguindo o título canônico "Txxx: <descrição>". Suporta os formatos de markdown com checkbox e marcadores opcionais `[P]` / `[US#]`.

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

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 conversão de tarefas para issues):

  • Verifique se o arquivo .specify/extensions.yml existe na raiz do projeto.
  • Se existir, leia-o e procure por entradas sob a chave hooks.before_taskstoissues.
  • 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 os hooks onde enabled está explicitamente como false. Trate hooks sem o 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 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, gere a seguinte saída com base em sua flag optional:
    • Hook opcional (optional: true):
      ## Extension Hooks
      
      **Pre-Hook Opcional**: {extension}
      Command: `/{command}`
      Description: {description}
      
      Prompt: {prompt}
      To execute: `/{command}`
      
    • Hook obrigatório (optional: false):
      ## Extension Hooks
      
      **Pre-Hook Automático**: {extension}
      Executing: `/{command}`
      EXECUTE_COMMAND: {command}
      
      Wait for the result of the hook command before proceeding to the Outline.
      
      Após emitir o bloco acima, você DEVE de fato 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 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, pule silenciosamente.

Outline

  1. Execute .specify/scripts/bash/check-prerequisites.sh --json --require-tasks --include-tasks a partir da raiz do repositório e analise a lista FEATURE_DIR e AVAILABLE_DOCS. Todos os caminhos devem ser absolutos. Para aspas simples em argumentos como "I'm Groot", use a sintaxe de escape: por exemplo 'I'''m Groot' (ou use aspas duplas se possível: "I'm Groot").
  2. SE EXISTIR: Carregue .specify/memory/constitution.md para princípios do projeto e restrições de governança.
  3. A partir do script executado, extraia o caminho para as tarefas.
  4. Obtenha o remote Git executando:
git config --get remote.origin.url

[!CAUTION] PROSSIGA PARA OS PRÓXIMOS PASSOS SOMENTE SE O REMOTE FOR UMA URL DO GITHUB

  1. Buscar issues existentes para deduplicação: Antes de criar qualquer coisa, construa o conjunto de IDs de tarefas que você está prestes a processar a partir de tasks.md (cada uma é um T seguido por pelo menos três dígitos, por exemplo T001 — /speckit-converge atribui novos IDs com T{M+1:03d}, que é um piso e não um teto; portanto, quando um arquivo tem mais de 999 tarefas, os IDs têm quatro ou mais dígitos). Em seguida, use a ferramenta list_issues do servidor MCP do GitHub para procurar issues que já cobrem esses IDs. Não passe um valor state, pois omiti-lo faz com que a ferramenta retorne issues abertas e fechadas. Solicite perPage: 100 para manter o número de chamadas baixo e, como a ferramenta usa paginação baseada em cursor, solicite páginas com o parâmetro after (usando o endCursor da resposta anterior). Para cada título de issue, compare-o com o padrão de ID de tarefa \bT\d{3,}\b (o {3,} aceita IDs de quatro ou mais dígitos — com \d{3} um título contendo T1000 não corresponderia, pois o \b final não pode ficar entre dois dígitos, então essa tarefa seria silenciosamente nem deduplicada nem criada; as bordas de palavra ainda impedem que um token como ST001 corresponda, e forçam todo o grupo de dígitos a ser consumido, então T100 nunca pode corresponder dentro de T1000; isso também reconhece títulos escritos como T001 ..., T001: ... ou [T001] ...) e, quando corresponder a um de seus IDs de tarefa, marque esse ID como já tendo uma issue. Pare de paginar assim que cada ID de tarefa tiver sido correspondido, ou quando não houver mais páginas, para não continuar buscando todo o histórico de issues do repositório depois que todos os IDs de tarefa forem contabilizados. Isso limita o número de chamadas em repositórios com grandes históricos de issues e ainda previne duplicatas quando o comando é reexecutado após tasks.md ser regenerado ou o skill ser reinvocado.
  2. Para cada tarefa na lista, use o servidor MCP do GitHub para criar uma nova issue no repositório que represente o remote Git. As linhas de tarefa em tasks.md começam com uma caixa de seleção markdown, então primeiro remova o - [ ] inicial (e quaisquer marcadores [P] / [US#]) para recuperar o ID da tarefa e sua descrição. Crie a issue com um título canônico único no formato T001: <descrição>, com o ID escrito uma vez seguido pela descrição da tarefa (por exemplo, a linha - [ ] T001 Create project structure se torna o título T001: Create project structure).
    • Pule qualquer tarefa cujo ID já esteja presente no conjunto de issues existentes da etapa anterior e informe (por exemplo, T001 already has an issue, skipping).
    • Crie issues apenas para tarefas que ainda não têm uma issue correspondente.

[!CAUTION] EM HIPÓTESE ALGUMA CRIE ISSUES EM REPOSITÓRIOS QUE NÃO CORRESPONDAM À URL DO REMOTE

Verificações de Pós-Execução

Verificar hooks de extensão (após a conversão de tarefas para issues): Verifique se o arquivo .specify/extensions.yml existe na raiz do projeto.

  • Se existir, leia-o e procure por entradas sob a chave hooks.after_taskstoissues.
  • 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 os hooks onde enabled está explicitamente como false. Trate hooks sem o 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 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, gere a seguinte saída com base em sua flag optional:
    • Hook opcional (optional: true):
      ## Extension Hooks
      
      **Hook Opcional**: {extension}
      Command: `/{command}`
      Description: {description}
      
      Prompt: {prompt}
      To execute: `/{command}`
      
    • Hook obrigatório (optional: false):
      ## Extension Hooks
      
      **Hook Automático**: {extension}
      Executing: `/{command}`
      EXECUTE_COMMAND: {command}
      
      Após emitir o bloco acima, você DEVE de fato 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 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, pule silenciosamente.

Individual skills in this repo

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

Habilidades Relacionadas