Communitygithub.com

tangjuyo/reels-blocker

Convierte tareas existentes en issues de GitHub procesables y ordenados por dependencias para la funcionalidad, basándose en los artefactos de diseño disponibles.

¿Qué es reels-blocker?

Este skill, reels-blocker, automatiza la conversión de una lista de tareas (definidas en un archivo tasks.md) en issues de GitHub, respetando dependencias y evitando duplicados. Primero, verifica la existencia de hooks de extensión opcionales u obligatorios definidos en `.specify/extensions.yml` que deben ejecutarse antes del proceso. Luego, ejecuta un script de verificación de requisitos previos para obtener el directorio de la funcionalidad y los documentos disponibles, y carga la constitución del proyecto si existe. El skill identifica el repositorio remoto de Git y, solo si es una URL de GitHub, procede a obtener los issues existentes para desduplicación usando el servidor MCP de GitHub, emparejando títulos de issues con patrones de ID de tarea como `T001`. Finalmente, para cada tarea sin issue correspondiente, crea un nuevo issue con el formato `T001: <descripción>`. Soporta hooks posteriores a la conversión y proporciona informes detallados de las acciones realizadas. Es útil para equipos que gestionan el desarrollo de funcionalidades con issues de GitHub y desean mantener un registro claro y ordenado de las tareas pendientes, evitando la creación accidental de issues duplicados cuando se regenera la lista de tareas.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Entrada de Usuario

$ARGUMENTS

DEBES considerar la entrada del usuario antes de proceder (si no está vacía).

Verificaciones Previas a la Ejecución

Verificar hooks de extensión (antes de la conversión tareas-a-issues):

  • Comprobar si existe .specify/extensions.yml en la raíz del proyecto.
  • Si existe, leerlo y buscar entradas bajo la clave hooks.before_taskstoissues
  • Si el YAML no se puede analizar o es inválido, no omitirlo silenciosamente: informar al usuario que .specify/extensions.yml no se pudo leer (incluir el error del analizador) y que no se verificaron hooks, incluidos los obligatorios (optional: false) registrados allí, luego continuar normalmente
  • Filtrar los hooks donde enabled sea explícitamente false. Tratar los hooks sin un campo enabled como habilitados por defecto.
  • Para cada hook restante, no intentar interpretar o evaluar las expresiones de condition del hook:
    • Si el hook no tiene un campo condition, o es nulo/vacío, tratar el hook como ejecutable
    • Si el hook define una condition no vacía, omitir el hook y dejar la evaluación de la condición a la implementación de HookExecutor
  • Al construir invocaciones de comandos a partir de nombres de comandos de hooks, reemplazar los puntos (.) con guiones (-). Por ejemplo, speckit.git.commit → /speckit-git-commit.
  • Para cada hook ejecutable, generar lo siguiente según su bandera optional:
    • Hook opcional (optional: true):
      ## Hooks de Extensión
      
      **Pre-Hook Opcional**: {extension}
      Comando: `/{command}`
      Descripción: {description}
      
      Prompt: {prompt}
      Para ejecutar: `/{command}`
      
    • Hook obligatorio (optional: false):
      ## Hooks de Extensión
      
      **Pre-Hook Automático**: {extension}
      Ejecutando: `/{command}`
      EXECUTE_COMMAND: {command}
      
      Esperar el resultado del comando del hook antes de proceder al Esquema.
      
      Después de emitir el bloque anterior, DEBES invocar realmente el hook y esperar a que termine antes de continuar. Ejecútalo de la misma manera que ejecutarías el comando tú mismo en este agente/sesión (la invocación puede diferir del id literal {command} mostrado arriba, por ejemplo, un agente en modo skills lo ejecuta como /skill:speckit-... o $speckit-...). Emitir el bloque por sí solo no ejecuta el hook.
  • Si no hay hooks registrados o .specify/extensions.yml no existe, omitir silenciosamente

Esquema

  1. Ejecutar .specify/scripts/bash/check-prerequisites.sh --json --require-tasks --include-tasks desde la raíz del repositorio y analizar la lista FEATURE_DIR y AVAILABLE_DOCS. Todas las rutas deben ser absolutas. Para comillas simples en argumentos como "I'm Groot", usar sintaxis de escape: por ejemplo 'I'''m Groot' (o entrecomillar con dobles si es posible: "I'm Groot").
  2. SI EXISTE: Cargar .specify/memory/constitution.md para los principios del proyecto y las restricciones de gobernanza.
  3. Del script ejecutado, extraer la ruta a las tareas.
  4. Obtener el remoto de Git ejecutando:
git config --get remote.origin.url

[!CAUTION] SOLO PROCEDER A LOS SIGUIENTES PASOS SI EL REMOTO ES UNA URL DE GITHUB

  1. Obtener issues existentes para desduplicación: Antes de crear nada, construir el conjunto de IDs de tarea que se van a procesar desde tasks.md (cada uno es una T seguida de al menos tres dígitos, por ejemplo T001 — /speckit-converge asigna nuevos IDs con T{M+1:03d}, que es un piso más que un techo, por lo que una vez que un archivo tiene más de 999 tareas los IDs tienen cuatro dígitos o más). Luego usar la herramienta list_issues del servidor MCP de GitHub para buscar issues que ya cubren esos IDs. No pasar un valor state, ya que omitirlo hace que la herramienta devuelva tanto issues abiertos como cerrados. Solicitar perPage: 100 para mantener bajo el número de llamadas, y dado que la herramienta usa paginación basada en cursor, solicitar páginas con el parámetro after (usando el endCursor de la respuesta anterior). Para cada título de issue, emparejarlo con el patrón de ID de tarea \bT\d{3,}\b (el {3,} acepta IDs de cuatro dígitos o más — con \d{3} un título que contenga T1000 no coincidiría en absoluto, porque el \b final no puede colocarse entre dos dígitos, por lo que esa tarea se omitiría silenciosamente sin desduplicación ni creación; los límites de palabra aún evitan que un token como ST001 coincida, y obligan a que se consuma toda la ejecución de dígitos, por lo que T100 nunca puede coincidir dentro de T1000; esto también reconoce títulos escritos como T001 ..., T001: ... o [T001] ...) y, cuando coincida con uno de tus IDs de tarea, marcar ese ID como que ya tiene un issue. Dejar de paginar tan pronto como cada ID de tarea haya sido emparejado, o cuando no haya más páginas, para no seguir obteniendo todo el historial de issues del repositorio una vez que todos los IDs de tarea están contabilizados. Esto limita el número de llamadas en repositorios con grandes historiales de issues y aún previene duplicados cuando el comando se vuelve a ejecutar después de que se regenera tasks.md o se vuelve a invocar el skill.
  2. Para cada tarea en la lista, usar el servidor MCP de GitHub para crear un nuevo issue en el repositorio que sea representativo del remoto de Git. Las líneas de tarea en tasks.md comienzan con una casilla de verificación de markdown, por lo que primero eliminar el - [ ] inicial (y cualquier marcador [P] / [US#]) para recuperar el ID de la tarea y su descripción. Crear el issue con un título canónico único de la forma T001: <descripción>, con el ID escrito una vez seguido de la descripción de la tarea (por ejemplo, la línea - [ ] T001 Crear estructura del proyecto se convierte en el título T001: Crear estructura del proyecto).
    • Saltar cualquier tarea cuyo ID ya esté presente en el conjunto de issues existentes del paso anterior, e informarlo (por ejemplo, T001 ya tiene un issue, saltando).
    • Solo crear issues para tareas que aún no tengan un issue coincidente.

[!CAUTION] BAJO NINGUNA CIRCUNSTANCIA CREAR ISSUES EN REPOSITORIOS QUE NO COINCIDAN CON LA URL REMOTA

Verificaciones Posteriores a la Ejecución

Verificar hooks de extensión (después de la conversión tareas-a-issues): Comprobar si existe .specify/extensions.yml en la raíz del proyecto.

  • Si existe, leerlo y buscar entradas bajo la clave hooks.after_taskstoissues
  • Si el YAML no se puede analizar o es inválido, no omitirlo silenciosamente: informar al usuario que .specify/extensions.yml no se pudo leer (incluir el error del analizador) y que no se verificaron hooks, incluidos los obligatorios (optional: false) registrados allí, luego continuar normalmente
  • Filtrar los hooks donde enabled sea explícitamente false. Tratar los hooks sin un campo enabled como habilitados por defecto.
  • Para cada hook restante, no intentar interpretar o evaluar las expresiones de condition del hook:
    • Si el hook no tiene un campo condition, o es nulo/vacío, tratar el hook como ejecutable
    • Si el hook define una condition no vacía, omitir el hook y dejar la evaluación de la condición a la implementación de HookExecutor
  • Al construir invocaciones de comandos a partir de nombres de comandos de hooks, reemplazar los puntos (.) con guiones (-). Por ejemplo, speckit.git.commit → /speckit-git-commit.
  • Para cada hook ejecutable, generar lo siguiente según su bandera optional:
    • Hook opcional (optional: true):
      ## Hooks de Extensión
      
      **Hook Opcional**: {extension}
      Comando: `/{command}`
      Descripción: {description}
      
      Prompt: {prompt}
      Para ejecutar: `/{command}`
      
    • Hook obligatorio (optional: false):
      ## Hooks de Extensión
      
      **Hook Automático**: {extension}
      Ejecutando: `/{command}`
      EXECUTE_COMMAND: {command}
      
      Después de emitir el bloque anterior, DEBES invocar realmente el hook y esperar a que termine antes de continuar. Ejecútalo de la misma manera que ejecutarías el comando tú mismo en este agente/sesión (la invocación puede diferir del id literal {command} mostrado arriba, por ejemplo, un agente en modo skills lo ejecuta como /skill:speckit-... o $speckit-...). Emitir el bloque por sí solo no ejecuta el hook.
  • Si no hay hooks registrados o .specify/extensions.yml no existe, omitir silenciosamente

Individual skills in this repo

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

Skills relacionados