Communitygithub.com

AmanVarshney01/tcut

Archivar un cambio completado en el flujo de trabajo experimental. Úsalo cuando el usuario quiera finalizar y archivar un cambio después de que la implementación esté completa.

¿Qué es tcut?

Esta habilidad permite archivar un cambio completado dentro del flujo de trabajo experimental de OpenSpec. Es útil para desarrolladores que usan agentes como Claude Code, Cursor o Codex y quieren finalizar un cambio, asegurándose de que los artefactos estén completos, las tareas terminadas y los specs delta sincronizados antes del archivado. La habilidad admite cualquier plataforma que ejecute comandos `openspec` desde la línea de comandos. Funciona guiando al agente a través de pasos secuenciales: primero, si no se proporciona un nombre de cambio, solicita al usuario que seleccione uno de los cambios activos; luego verifica el estado de los artefactos y tareas, mostrando advertencias si hay elementos incompletos pero permitiendo continuar con confirmación. También evalúa si hay specs delta y ofrece sincronizarlos o archivarlos sin sincronización. Finalmente, mueve el directorio del cambio a una carpeta de archivo con una marca de tiempo y muestra un resumen claro. La habilidad preserva el archivo `.openspec.yaml` y utiliza `openspec status --json` para la verificación del estado.

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

Preguntar en tu IA favorita

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

Documentación

Archivar un cambio completado en el flujo de trabajo experimental.

Selección de almacén: Si el usuario nombra un almacén (un almacén es un repositorio OpenSpec independiente registrado en esta máquina) o el trabajo reside en uno, ejecuta openspec store list --json para descubrir los ids de almacén registrados, luego pasa --store <id> en los comandos que leen o escriben specs y cambios (new change, status, instructions, list, show, validate, archive, doctor, context). Otros comandos no toman la bandera. Las sugerencias 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 los cambios disponibles.

Pasos

  1. Si no se proporciona un nombre de cambio, solicita una selección

    Ejecuta openspec list --json para obtener los cambios disponibles. Usa la herramienta AskUserQuestion para permitir que el usuario seleccione.

    Muestra solo los cambios activos (no archivados). Incluye el esquema utilizado para cada cambio si está disponible.

    IMPORTANTE: No adivines ni selecciones automáticamente un cambio. Siempre deja que el usuario elija.

  2. Verificar el estado de finalización de los artefactos

    Ejecuta openspec status --change "<nombre>" --json para verificar la finalización de los artefactos.

    Analiza el JSON para entender:

    • schemaName: El flujo de trabajo que se está utilizando
    • planningHome, changeRoot, artifactPaths y actionContext: contexto de ruta y alcance
    • artifacts: Lista de artefactos con su estado (done u otro)

    Si algún artefacto no está done:

    • Muestra una advertencia enumerando los artefactos incompletos
    • Usa la herramienta AskUserQuestion para confirmar que el usuario quiere continuar
    • Continúa si el usuario confirma
  3. Verificar el estado de finalización de las tareas

    Lee el archivo de tareas (típicamente tasks.md) para verificar si hay tareas incompletas.

    Cuenta las tareas marcadas con - [ ] (incompleta) vs - [x] (completa).

    Si se encuentran tareas incompletas:

    • Muestra una advertencia indicando el número de tareas incompletas
    • Usa la herramienta AskUserQuestion para confirmar que el usuario quiere continuar
    • Continúa si el usuario confirma

    Si no existe el archivo de tareas: Continúa sin advertencia relacionada con tareas.

  4. Evaluar el estado de sincronización de los specs delta

    Usa artifactPaths.specs.existingOutputPaths del JSON de estado para verificar si hay specs delta. Si no existen, continúa sin solicitud de sincronización.

    Si existen specs delta:

    • Compara cada spec delta con su spec principal correspondiente en openspec/specs/<capacidad>/spec.md
    • Determina qué cambios se aplicarían (adiciones, modificaciones, eliminaciones, renombres)
    • Muestra un resumen combinado antes de solicitar

    Opciones de solicitud:

    • Si se necesitan cambios: "Sincronizar ahora (recomendado)", "Archivar sin sincronizar"
    • Si ya están sincronizados: "Archivar ahora", "Sincronizar de todos modos", "Cancelar"

    Si el usuario elige sincronizar, usa la herramienta Task (subagent_type: "general-purpose", prompt: "Usa la herramienta Skill para invocar openspec-sync-specs para el cambio ''. Análisis de specs delta: <incluye el resumen del análisis de specs delta>"). Continúa para archivar independientemente de la elección.

  5. Realizar el archivado

    Crea un directorio archive bajo planningHome.changesDir si no existe:

    mkdir -p "<planningHome.changesDir>/archive"
    

    Genera el nombre de destino usando la fecha actual: YYYY-MM-DD-<nombre-del-cambio>

    Verificar si el destino ya existe:

    • Si sí: Fallar con error, sugerir renombrar el archivo existente o usar una fecha diferente
    • Si no: Mover changeRoot al directorio de archivo
    mv "<changeRoot>" "<planningHome.changesDir>/archive/YYYY-MM-DD-<nombre>"
    
  6. Mostrar resumen

    Muestra un resumen de finalización del archivado que incluya:

    • Nombre del cambio
    • Esquema que se utilizó
    • Ubicación del archivo
    • Si los specs se sincronizaron (si corresponde)
    • Nota sobre cualquier advertencia (artefactos/tareas incompletos)

Salida en caso de éxito

## Archivo Completado

**Cambio:** <nombre-del-cambio>
**Esquema:** <nombre-del-esquema>
**Archivado en:** la ruta de archivo derivada de `planningHome.changesDir`/YYYY-MM-DD-<nombre>/
**Specs:** ✓ Sincronizados con los specs principales (o "Sin specs delta" o "Sincronización omitida")

Todos los artefactos completos. Todas las tareas completas.

Guardarraíles

  • Siempre solicita la selección del cambio si no se proporciona
  • Usa el gráfico de artefactos (openspec status --json) para verificar la finalización
  • No bloquees el archivado por advertencias, solo informa y confirma
  • Preserva .openspec.yaml al mover al archivo (se mueve con el directorio)
  • Muestra un resumen claro de lo que sucedió
  • Si se solicita sincronización, usa el enfoque openspec-sync-specs (impulsado por el agente)
  • Si existen specs delta, siempre ejecuta la evaluación de sincronización y muestra el resumen combinado antes de solicitar

Individual skills in this repo

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

AmanVarshney01/tcut

Implement tasks from an OpenSpec change. Use when the user wants to start implementing, continue implementation, or work through tasks.

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