/tc — Seguimiento de Cambios Técnicos
Envía un comando TC (Cambio Técnico). Argumentos: $ARGUMENTS.
Si $ARGUMENTS está vacío, imprime este menú y se detiene:
/tc init Inicia el seguimiento de TC en este proyecto
/tc create <nombre> Crea un nuevo registro de TC
/tc update <id-tc> [...] Actualiza campos, estado, archivos, transferencia
/tc status [id-tc] Muestra un TC o el resumen del registro
/tc resume <id-tc> Reanuda un TC de una sesión anterior
/tc close <id-tc> Transiciona un TC a desplegado
/tc export Vuelve a renderizar artefactos derivados
/tc dashboard Vuelve a renderizar el resumen del registro
De lo contrario, analiza $ARGUMENTS como <subcomando> <resto> y envía al protocolo correspondiente a continuación. Todos los scripts están en engineering/tc-tracker/scripts/.
Subcomandos
init
- Ejecuta:
python3 engineering/skills/tc-tracker/scripts/tc_init.py --root . --json - Si el estado es
already_initialized, informa las estadísticas actuales y se detiene. - De lo contrario, informa qué se creó y sugiere
/tc create <nombre>como siguiente paso.
create <nombre>
- Analiza
<nombre>como un slug en kebab-case. Si falta, pide uno al usuario. - Pregunta al usuario (una pregunta a la vez) por:
- Título (5-120 caracteres)
- Alcance:
feature | bugfix | refactor | infrastructure | documentation | hotfix | enhancement - Prioridad:
critical | high | medium | low(por defectomedium) - Resumen (10+ caracteres)
- Motivación
- Ejecuta:
python3 engineering/skills/tc-tracker/scripts/tc_create.py --root . \ --name "<slug>" --title "<título>" --scope <alcance> --priority <prioridad> \ --summary "<resumen>" --motivation "<motivación>" --json - Informa el nuevo ID de TC y la ruta al registro.
update <id-tc> [intención]
- Si falta
<id-tc>, lista los TC activos (estadoin_progressoblocked) desdetc_status.py --ally pregunta cuál. - Determina la intención del usuario a partir del lenguaje natural:
- Cambio de estado →
--set-status <estado>con--reason "<por qué>" - Agregar archivos → uno o más
--add-file ruta[:acción] - Agregar una prueba →
--add-test "<título>" --test-procedure "<paso>" --test-expected "<resultado>" - Actualizar transferencia → cualquier combinación de
--handoff-progress,--handoff-next,--handoff-blocker,--handoff-context - Agregar una nota →
--note "<texto>" - Agregar una etiqueta →
--tag <etiqueta>
- Cambio de estado →
- Ejecuta:
python3 engineering/skills/tc-tracker/scripts/tc_update.py --root . --tc-id <id-tc> [banderas] --json - Si el código de salida no es cero, muestra el error textualmente. La máquina de estados y el validador rechazarán movimientos no válidos; no reintentes a ciegas.
status [id-tc]
- Si se proporciona
<id-tc>:python3 engineering/skills/tc-tracker/scripts/tc_status.py --root . --tc-id <id-tc> - De lo contrario:
python3 engineering/skills/tc-tracker/scripts/tc_status.py --root . --all
resume <id-tc>
- Ejecuta:
python3 engineering/skills/tc-tracker/scripts/tc_status.py --root . --tc-id <id-tc> --json - Muestra el bloque de transferencia de forma prominente:
progress_summary,next_steps(numerados),blockers,key_context. - Pregunta: "¿Reanudar y continuar con el siguiente paso 1? (s/n)"
- Si la respuesta es sí, ejecuta una actualización para registrar la reanudación:
python3 engineering/skills/tc-tracker/scripts/tc_update.py --root . --tc-id <id-tc> \ --note "Sesión reanudada" --reason "transferencia de sesión" - Comienza a ejecutar el primer elemento de
next_steps. NO vuelvas a derivar el contexto — confía en la transferencia.
close <id-tc>
- Lee el registro mediante
tc_status.py --tc-id <id-tc> --json. - Verifica que el estado actual sea
tested. Si no lo es, rechaza e indica al usuario qué transiciones aún son necesarias. - Revisa
test_cases: advierte si alguno estápending,failoblocked. - Pregunta al usuario:
- "¿Quién aprueba? (tu nombre, o 'self')"
- "Notas de aprobación (opcional):"
- "Estado de cobertura de pruebas: none / partial / full"
- Ejecuta:
Luego edita directamente el bloque depython3 engineering/skills/tc-tracker/scripts/tc_update.py --root . --tc-id <id-tc> \ --set-status deployed --reason "Aprobado por <aprobador>" --note "Aprobación: <aprobador> — <notas>"approvalmediante una actualización de seguimiento si tu versión del script lo soporta; de lo contrario, instruye al usuario para que registre la aprobación ennotes. - Informa: "TC-NNN cerrado y desplegado."
export
No hay exportación automática a HTML en este skill. En su lugar, vuelve a validar todo:
- Lee el registro.
- Para cada registro, ejecuta:
python3 engineering/skills/tc-tracker/scripts/tc_validator.py --record <ruta> --json - Ejecuta:
python3 engineering/skills/tc-tracker/scripts/tc_validator.py --registry docs/TC/tc_registry.json --json - Informa: total de registros validados, errores encontrados, rutas a cualquier registro no válido.
dashboard
Ejecuta el resumen de todos los registros:
python3 engineering/skills/tc-tracker/scripts/tc_status.py --root . --all
Reglas de Hierro
- Nunca edites
tc_record.jsonmanualmente. Usa siempretc_update.pypara que se añada el historial de revisiones y se ejecute la validación. - Nunca te saltes la máquina de estados. Avanza paso a paso a través de los estados aunque parezca redundante.
- Nunca elimines un TC. El historial es de solo añadido — agrega una revisión final y etiquétala como
[CANCELLED]. - Contabilidad en segundo plano. Cuando estés en medio de una tarea, lanza un subagente en segundo plano para actualizar el TC. No pauses la codificación para hacer papeleo.
- Valida antes de informar éxito. Si un script sale con código distinto de cero, muestra el error y detente.
Skills Relacionados
engineering/tc-tracker— SKILL.md completo con referencia del esquema, diagramas del ciclo de vida y el formato de transferencia.engineering/changelog-generator— Combínalo con el rastreador de TC: los TC sirven para el registro de auditoría por cambio, y el changelog para las notas de lanzamiento orientadas al usuario.engineering/tech-debt-tracker— Para rastrear deuda técnica de larga duración en lugar de cambios de código discretos.