Communitygithub.com

tangjuyo/reels-blocker

Crea o actualiza la constitución del proyecto a partir de entradas de principios interactivas o proporcionadas.

¿Qué es reels-blocker?

El skill `tangjuyo/reels-blocker` permite a un agente de IA crear o modificar la constitución de un proyecto, un documento de gobierno interno que define principios, reglas y procedimientos. Es útil para equipos de desarrollo que desean formalizar acuerdos de gobernanza directamente desde el agente, asegurando consistencia y trazabilidad. Funciona con cualquier agente compatible que lea habilidades (skills) en formato markdown (como Claude Code, Cursor, Codex). El agente primero evalúa la entrada del usuario para distinguir contenido constitucional de solicitudes de implementación, que se difieren sin ejecutar. Luego ejecuta hooks de extensión configurados (`before_constitution` y `after_constitution`), resuelve una plantilla de constitución, recopila valores para los marcadores de posición, redacta la actualización, valida el resultado y escribe el archivo `.specify/memory/constitution.md`. Finalmente, produce un resumen con la nueva versión, decisiones de bump, elementos pendientes y un mensaje de commit sugerido, además de una sección de próximas acciones para las intenciones diferidas que no son de gobierno.

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

Preguntar en tu IA favorita

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

Documentación

Entrada del usuario

$ARGUMENTS

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

Guardia de alcance

El trabajo propio de este comando se limita a actualizar la constitución del proyecto. Las plantillas y comandos dependientes leen la constitución en tiempo de ejecución y no se modifican aquí.

  • Clasifica cada parte de la entrada del usuario como contenido de la constitución o como una intención separada que no sea de gobernanza.
  • Si la entrada incluye solicitudes de implementación de funcionalidades, generación de código, refactorización, construcción o despliegue, NO DEBES ejecutarlas. En su lugar, extráelas como intenciones diferidas.
  • NO DEBES crear, modificar o eliminar archivos fuente de la aplicación, rutas de funcionalidades, componentes, pruebas, archivos de despliegue u otros artefactos no relacionados con el flujo de trabajo de la constitución.
  • Si no está claro si una instrucción es contenido de la constitución, pide aclaración antes de realizar cambios.
  • Después de completar la actualización de la constitución, incluye una sección Próximas acciones para cada intención diferida. Enumera la intención original y sugiere el comando adecuado de Spec Kit, como /speckit-specify, sin invocarlo.
  • Si no hay intenciones que no sean de gobernanza, omite la sección Próximas acciones.

Comprobaciones previas a la ejecución

Verificar hooks de extensión (antes de la actualización de la constitución):

  • Comprueba si existe .specify/extensions.yml en la raíz del proyecto.
  • Si existe, léelo y busca entradas bajo la clave hooks.before_constitution.
  • Si el YAML no se puede analizar o no es válido, no lo omitas en silencio: informa al usuario de que no se pudo leer .specify/extensions.yml (incluye el error del analizador) y que no se verificaron hooks, incluidos los hooks obligatorios (optional: false) registrados allí, luego continúa normalmente.
  • Filtra los hooks donde enabled sea explícitamente false. Trata los hooks sin un campo enabled como habilitados por defecto.
  • Para cada hook restante, no intentes interpretar ni evaluar las expresiones de condition del hook:
    • Si el hook no tiene un campo condition, o es nulo/vacío, trata el hook como ejecutable.
    • Si el hook define una condition no vacía, omite el hook y deja 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, reemplaza los puntos (.) con guiones (-). Por ejemplo, speckit.git.commit → /speckit-git-commit.
  • Para cada hook ejecutable, genera la siguiente salida según su bandera optional:
    • Hook opcional (optional: true):
      ## Extension Hooks
      
      **Pre-Hook Opcional**: {extension}
      Comando: `/{command}`
      Descripción: {description}
      
      Indicación: {prompt}
      Para ejecutar: `/{command}`
      
    • Hook obligatorio (optional: false):
      ## Extension Hooks
      
      **Pre-Hook Automático**: {extension}
      Ejecutando: `/{command}`
      EXECUTE_COMMAND: {command}
      
      Espera 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 no existe .specify/extensions.yml, omítelo en silencio.

Esquema

Estás actualizando la constitución del proyecto en .specify/memory/constitution.md. El andamio constitucional activo se resuelve en tiempo de comando a partir de constitution-template a través de la pila de resolución de plantillas/preajustes de Spec Kit.

Sigue este flujo de ejecución:

  1. Ejecuta .specify/scripts/bash/resolve-template.sh constitution-template --json desde la raíz del repositorio y analiza TEMPLATE_CONTENT como la plantilla activa.

    • El resolvedor compartido aplica las sobrescrituras del proyecto, componiendo capas de preajustes y capas de extensión antes de recurrir a la plantilla base. DEBE tener éxito antes de continuar.
    • Si falla, detente e informa del error de resolución; no continúes con solo una capa de plantilla contribuyente.
    • Si existe .specify/memory/constitution.md, cárgalo como fuente de los valores y enmiendas actuales específicos del proyecto. Conserva la información que aún sea aplicable al aplicar el andamio recién resuelto.
    • Si no existe, usa la plantilla resuelta como documento inicial.
    • No escribas de nuevo en ninguna capa de plantilla versionada.
    • Identifica cada token marcador de posición de la forma [ALL_CAPS_IDENTIFIER]. IMPORTANTE: El usuario podría requerir menos o más principios de los utilizados en la plantilla. Si se especifica un número, respétalo: sigue la plantilla general. Actualizarás el documento en consecuencia.
  2. Recopila/deriva valores para los marcadores de posición:

    • Si la entrada del usuario (conversación) proporciona un valor, úsalo.
    • De lo contrario, infiérelo del contexto existente del repositorio (README, documentación, versiones anteriores de la constitución si están incrustadas).
    • Para las fechas de gobernanza: RATIFICATION_DATE es la fecha de adopción original (si se desconoce, pregunta o marca como TODO), LAST_AMENDED_DATE es hoy si se realizan cambios, de lo contrario mantén el anterior.
    • CONSTITUTION_VERSION debe incrementarse según las reglas de versionado semántico:
      • MAJOR: Eliminaciones o redefiniciones de gobierno/principios que rompen la compatibilidad hacia atrás.
      • MINOR: Nuevo principio/sección añadido o guía materialmente ampliada.
      • PATCH: Aclaraciones, redacción, correcciones tipográficas, refinamientos no semánticos.
    • Si el tipo de bump de versión es ambiguo, propón un razonamiento antes de finalizar.
  3. Redacta el contenido actualizado de la constitución usando la plantilla resuelta como estructura requerida:

    • Reemplaza cada marcador de posición con texto concreto (sin tokens entre corchetes restantes, excepto los slots de plantilla que el proyecto ha decidido no definir todavía; justifica explícitamente cualquier excepción).
    • Mantén la jerarquía de encabezados; los comentarios se pueden eliminar una vez reemplazados, a menos que aún añadan orientación aclaratoria.
    • Asegúrate de que cada sección de Principio tenga: una línea de nombre sucinta, un párrafo (o lista con viñetas) que capture las reglas no negociables, y una justificación explícita si no es obvia.
    • Asegúrate de que la sección de Gobernanza enumere el procedimiento de enmienda, la política de versionado y las expectativas de revisión de cumplimiento.
  4. Genera un Informe de Impacto de Sincronización como un comentario HTML al principio del archivo de constitución después de la actualización. Este informe es material de borrador temporal para la revisión humana de la enmienda, no contenido de gobernanza; se espera que se elimine antes de confirmar el archivo de constitución enmendado.

    • Cambio de versión: anterior → nuevo.
    • Lista de principios modificados (título anterior → título nuevo si se renombró).
    • Secciones añadidas.
    • Secciones eliminadas.
    • TODOs de seguimiento si algún marcador de posición se difirió intencionalmente.
  5. Validación antes de la salida final:

    • Sin tokens entre corchetes inexplicables restantes.
    • La línea de versión coincide con el informe.
    • Fechas en formato ISO YYYY-MM-DD.
    • Los principios son declarativos, comprobables y libres de lenguaje vago (reemplazar "debería" con DEBE/DEBERÍA según corresponda).
  6. Escribe la constitución completa de nuevo en .specify/memory/constitution.md (sobrescribe).

  7. Genera un resumen final para el usuario con:

    • Nueva versión y justificación del bump.
    • Cualquier marcador de posición TODO o elementos diferidos que requieran seguimiento manual.
    • Mensaje de confirmación sugerido (por ejemplo, docs: enmendar constitución a vX.Y.Z (adiciones de principios + actualización de gobernanza)).
    • Una sección Próximas acciones para cualquier intención diferida que no sea de gobernanza.

Requisitos de formato y estilo:

  • Usa exactamente los encabezados Markdown de la plantilla (no reduzcas/aumentes niveles).
  • Ajusta las líneas largas de justificación para mantener la legibilidad (<100 caracteres idealmente), pero no lo fuerces con cortes incómodos.
  • Mantén una sola línea en blanco entre secciones.
  • Evita espacios en blanco finales.

Si el usuario proporciona actualizaciones parciales (por ejemplo, solo una revisión de principio), realiza igualmente los pasos de validación y decisión de versión.

Si falta información crítica (por ejemplo, la fecha de ratificación es realmente desconocida), inserta TODO(<FIELD_NAME>): explicación e inclúyelo en el Informe de Impacto de Sincronización bajo los elementos diferidos.

Escribe solo .specify/memory/constitution.md; no crees ni modifiques archivos fuente de plantilla.

Comprobaciones posteriores a la ejecución

Verificar hooks de extensión (después de la actualización de la constitución): Comprueba si existe .specify/extensions.yml en la raíz del proyecto.

  • Si existe, léelo y busca entradas bajo la clave hooks.after_constitution.
  • Si el YAML no se puede analizar o no es válido, no lo omitas en silencio: informa al usuario de que no se pudo leer .specify/extensions.yml (incluye el error del analizador) y que no se verificaron hooks, incluidos los hooks obligatorios (optional: false) registrados allí, luego continúa normalmente.
  • Filtra los hooks donde enabled sea explícitamente false. Trata los hooks sin un campo enabled como habilitados por defecto.
  • Para cada hook restante, no intentes interpretar ni evaluar las expresiones de condition del hook:
    • Si el hook no tiene un campo condition, o es nulo/vacío, trata el hook como ejecutable.
    • Si el hook define una condition no vacía, omite el hook y deja 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, reemplaza los puntos (.) con guiones (-). Por ejemplo, speckit.git.commit → /speckit-git-commit.
  • Para cada hook ejecutable, genera la siguiente salida según su bandera optional:
    • Hook opcional (optional: true):
      ## Extension Hooks
      
      **Hook Opcional**: {extension}
      Comando: `/{command}`
      Descripción: {description}
      
      Indicación: {prompt}
      Para ejecutar: `/{command}`
      
    • Hook obligatorio (optional: false):
      ## Extension Hooks
      
      **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 no existe .specify/extensions.yml, omítelo en silencio.

Individual skills in this repo

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

Skills relacionados