Communitygithub.com

AmanVarshney01/tcut

Implementa tareas de un cambio en OpenSpec. Úsalo cuando el usuario quiera empezar a implementar, continuar una implementación o trabajar a través de las tareas.

¿Qué es tcut?

Este skill permite a un agente de IA implementar sistemáticamente tareas definidas en un cambio de OpenSpec. Es útil porque automatiza el flujo de trabajo de implementación: selecciona el cambio, verifica el estado, lee los archivos de contexto necesarios (como propuestas, especificaciones, diseños y tareas) y ejecuta cada tarea paso a paso, marcándolas como completadas. Soporta múltiples almacenes de OpenSpec configurados en la máquina y puede inferir el cambio a partir de la conversación o pedir al usuario que seleccione uno. El skill maneja estados bloqueados, notifica el progreso y se pausa ante ambigüedades o errores, solicitando orientación. Se integra fluidamente con el ecosistema de OpenSpec, permitiendo intercalar implementaciones con actualizaciones de artefactos sin fases rígidas. Funciona en cualquier plataforma que soporte OpenSpec CLI y es ideal para desarrolladores que usan flujos de trabajo especificados por cambios.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AmanVarshney01/tcut/tree/HEAD/.claude/skills/openspec-apply-change

Preguntar en tu IA favorita

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

Documentación

Implementa tareas de un cambio en OpenSpec.

Selección de almacén: Si el usuario nombra un almacén (un almacén es un repositorio independiente de OpenSpec registrado en esta máquina) o el trabajo reside en uno, ejecuta openspec store list --json para descubrir los IDs de los almacenes registrados, luego pasa --store <id> en los comandos que leen o escriben especificaciones y cambios (new change, status, instructions, list, show, validate, archive, doctor, context). Otros comandos no toman la bandera. Las pistas impresas por los comandos ya llevan la bandera; mantenla en seguimientos. Sin un almacén, los comandos actúan sobre la raíz local openspec/ más cercana.

Entrada: Opcionalmente, especifica un nombre de cambio. Si se omite, verifica si se puede inferir del contexto de la conversación. Si es vago o ambiguo, DEBES solicitar al usuario los cambios disponibles.

Pasos

  1. Seleccionar el cambio

    Si se proporciona un nombre, úsalo. De lo contrario:

    • Inferir del contexto de la conversación si el usuario mencionó un cambio
    • Auto-seleccionar si solo existe un cambio activo
    • Si es ambiguo, ejecuta openspec list --json para obtener los cambios disponibles y usa la herramienta AskUserQuestion para permitir que el usuario seleccione

    Siempre anuncia: "Usando el cambio: " y cómo sobrescribir (ej., /opsx:apply <otro>).

  2. Verificar el estado para entender el esquema

    openspec status --change "<nombre>" --json
    

    Analiza el JSON para entender:

    • schemaName: El flujo de trabajo que se está utilizando (ej., "spec-driven")
    • planningHome, changeRoot y actionContext: alcance de planificación y restricciones de edición
    • Qué artefacto contiene las tareas (típicamente "tasks" para spec-driven, verifica el estado para otros)
  3. Obtener las instrucciones de aplicación

    openspec instructions apply --change "<nombre>" --json
    

    Esto devuelve:

    • contextFiles: ID del artefacto -> arreglo de rutas de archivo concretas (varía según el esquema: puede ser propuesta/especificaciones/diseño/tareas o especificación/pruebas/implementación/documentos)
    • Progreso (total, completadas, restantes)
    • Lista de tareas con estado
    • Instrucción dinámica basada en el estado actual

    Manejar estados:

    • Si state: "blocked" (artefactos faltantes): mostrar mensaje, sugerir usar openspec-continue-change
    • Si state: "all_done": felicitar, sugerir archivar
    • De lo contrario: proceder a la implementación
  4. Leer los archivos de contexto

    Lee cada ruta de archivo listada en contextFiles de la salida de las instrucciones de aplicación. Los archivos dependen del esquema que se esté utilizando:

    • spec-driven: propuesta, especificaciones, diseño, tareas
    • Otros esquemas: seguir los contextFiles de la salida del CLI
  5. Mostrar el progreso actual

    Muestra:

    • Esquema que se está utilizando
    • Progreso: "N/M tareas completadas"
    • Resumen de tareas restantes
    • Instrucción dinámica del CLI
  6. Implementar tareas (bucle hasta terminar o bloquearse)

    Para cada tarea pendiente:

    • Mostrar en qué tarea se está trabajando
    • Realizar los cambios de código necesarios
    • Mantener los cambios mínimos y enfocados
    • Marcar la tarea como completada en el archivo de tareas: - [ ] → - [x]
    • Continuar con la siguiente tarea

    Pausar si:

    • La tarea no está clara → pedir aclaración
    • La implementación revela un problema de diseño → sugerir actualizar artefactos
    • Se encuentra un error o bloqueo → informar y esperar instrucciones
    • El usuario interrumpe
  7. Al completar o pausar, mostrar el estado

    Muestra:

    • Tareas completadas en esta sesión
    • Progreso general: "N/M tareas completadas"
    • Si todo está hecho: sugerir archivar
    • Si está en pausa: explicar por qué y esperar instrucciones

Salida durante la implementación

## Implementando: <nombre-del-cambio> (esquema: <nombre-del-esquema>)

Trabajando en la tarea 3/7: <descripción de la tarea>
[...implementación en curso...]
✓ Tarea completada

Trabajando en la tarea 4/7: <descripción de la tarea>
[...implementación en curso...]
✓ Tarea completada

Salida al completar

## Implementación Completa

**Cambio:** <nombre-del-cambio>
**Esquema:** <nombre-del-esquema>
**Progreso:** 7/7 tareas completadas ✓

### Completado en esta sesión
- [x] Tarea 1
- [x] Tarea 2
...

¡Todas las tareas completadas! Listo para archivar este cambio.

Salida al pausar (problema encontrado)

## Implementación Pausada

**Cambio:** <nombre-del-cambio>
**Esquema:** <nombre-del-esquema>
**Progreso:** 4/7 tareas completadas

### Problema encontrado
<descripción del problema>

**Opciones:**
1. <opción 1>
2. <opción 2>
3. Otro enfoque

¿Qué te gustaría hacer?

Guardarraíles

  • Continuar con las tareas hasta terminar o bloquearse
  • Siempre leer los archivos de contexto antes de comenzar (de la salida de las instrucciones de aplicación)
  • Si la tarea es ambigua, pausar y preguntar antes de implementar
  • Si la implementación revela problemas, pausar y sugerir actualizaciones de artefactos
  • Mantener los cambios de código mínimos y limitados a cada tarea
  • Actualizar la casilla de la tarea inmediatamente después de completar cada tarea
  • Pausar ante errores, bloqueos o requisitos poco claros; no adivinar
  • Usar contextFiles de la salida del CLI, no asumir nombres de archivo específicos

Integración de flujo de trabajo fluido

Este skill soporta el modelo de "acciones sobre un cambio":

  • Se puede invocar en cualquier momento: Antes de que todos los artefactos estén listos (si existen tareas), después de una implementación parcial, intercalado con otras acciones
  • Permite actualizaciones de artefactos: Si la implementación revela problemas de diseño, sugiere actualizar artefactos; no está bloqueado por fases, trabaja de forma fluida.

Individual skills in this repo

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

AmanVarshney01/tcut

Archive a completed change in the experimental workflow. Use when the user wants to finalize and archive a change after implementation is complete.

AmanVarshney01/tcut

Enter explore mode - a thinking partner for exploring ideas, investigating problems, and clarifying requirements. Use when the user wants to think through something before or during a change.

AmanVarshney01/tcut

Propose a new change with all artifacts generated in one step. Use when the user wants to quickly describe what they want to build and get a complete proposal with design, specs, and tasks ready for implementation.

AmanVarshney01/tcut

Sync delta specs from a change to main specs. Use when the user wants to update main specs with changes from a delta spec, without archiving the change.

AmanVarshney01/tcut

Update an OpenSpec change by revising its existing planning artifacts and keeping them coherent with one another. Use when the user wants to revise a change's plan, fold new decisions into it, or reconcile its artifacts after an edit. Never edits code.

AmanVarshney01/tcut

Combine tcut terminal recordings with Remotion to produce polished, motion-designed launch/promo videos (title cards, animated captions, layered terminal footage). Use when the user wants a product video, launch video, or social video that features terminal/CLI footage.

AmanVarshney01/tcut

Record reproducible terminal videos (MP4/GIF/SVG/HTML) from TypeScript scripts or live sessions with the tcut CLI. Use when the user wants a terminal demo, CLI screencast, TUI recording, or animated terminal GIF for a README, website, or social post.

Skills relacionados