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.ymlen 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.ymlno 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
enabledsea explícitamentefalse. Tratar los hooks sin un campoenabledcomo habilitados por defecto. - Para cada hook restante, no intentar interpretar o evaluar las expresiones de
conditiondel hook:- Si el hook no tiene un campo
condition, o es nulo/vacío, tratar el hook como ejecutable - Si el hook define una
conditionno vacía, omitir el hook y dejar la evaluación de la condición a la implementación de HookExecutor
- Si el hook no tiene un campo
- 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):
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## 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.{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.
- Hook opcional (
- Si no hay hooks registrados o
.specify/extensions.ymlno existe, omitir silenciosamente
Esquema
- Ejecutar
.specify/scripts/bash/check-prerequisites.sh --json --require-tasks --include-tasksdesde 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"). - SI EXISTE: Cargar
.specify/memory/constitution.mdpara los principios del proyecto y las restricciones de gobernanza. - Del script ejecutado, extraer la ruta a las tareas.
- 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
- 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 unaTseguida de al menos tres dígitos, por ejemploT001—/speckit-convergeasigna nuevos IDs conT{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 herramientalist_issuesdel servidor MCP de GitHub para buscar issues que ya cubren esos IDs. No pasar un valorstate, ya que omitirlo hace que la herramienta devuelva tanto issues abiertos como cerrados. SolicitarperPage: 100para mantener bajo el número de llamadas, y dado que la herramienta usa paginación basada en cursor, solicitar páginas con el parámetroafter(usando elendCursorde 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 contengaT1000no coincidiría en absoluto, porque el\bfinal 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 comoST001coincida, y obligan a que se consuma toda la ejecución de dígitos, por lo queT100nunca puede coincidir dentro deT1000; esto también reconoce títulos escritos comoT001 ...,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 regeneratasks.mdo se vuelve a invocar el skill. - 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.mdcomienzan 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 formaT001: <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 proyectose convierte en el títuloT001: 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.
- Saltar cualquier tarea cuyo ID ya esté presente en el conjunto de issues existentes del paso anterior, e informarlo (por ejemplo,
[!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.ymlno 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
enabledsea explícitamentefalse. Tratar los hooks sin un campoenabledcomo habilitados por defecto. - Para cada hook restante, no intentar interpretar o evaluar las expresiones de
conditiondel hook:- Si el hook no tiene un campo
condition, o es nulo/vacío, tratar el hook como ejecutable - Si el hook define una
conditionno vacía, omitir el hook y dejar la evaluación de la condición a la implementación de HookExecutor
- Si el hook no tiene un campo
- 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):
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## Hooks de Extensión **Hook Automático**: {extension} Ejecutando: `/{command}` EXECUTE_COMMAND: {command}{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.
- Hook opcional (
- Si no hay hooks registrados o
.specify/extensions.ymlno existe, omitir silenciosamente