AgentSkillsCN

contextor-implement

按照批准的计划执行当前轨道的任务

SKILL.md
--- frontmatter
name: contextor-implement
description: Implementa las tareas del track actual siguiendo el plan aprobado
user-invocable: true
argument-hint: "[nombre-track]"

Contextor Implement

Ejecuta las tareas del track activo siguiendo el plan.

Argumento opcional: $ARGUMENTS (nombre específico del track, si no se proporciona usa el más reciente)

Prerequisitos

  1. Verifica que exista al menos un track en contextor/tracks/
  2. Verifica que el track tenga spec.md y plan.md
  3. Verifica que el plan tenga tareas pendientes [ ]

Si no hay tracks o todos están completados, indica al usuario que ejecute /contextor-newtrack.

Proceso

Fase 1: Identificar Track Activo

Si se proporcionó nombre:

  • Usa contextor/tracks/{nombre}/

Si no se proporcionó:

  • Busca el track más reciente con tareas pendientes
  • Un track está "pendiente" si tiene [ ] en su plan.md

Fase 2: Cargar Contexto

Lee en orden:

  1. contextor/product.md - Entender el producto
  2. contextor/tech-stack.md - Tecnologías permitidas
  3. contextor/workflow.md - Proceso a seguir
  4. contextor/guidelines.md - Estándares de código
  5. contextor/tracks/{track}/spec.md - Requisitos
  6. contextor/tracks/{track}/plan.md - Tareas a ejecutar

Fase 3: Ejecutar Tareas

Para cada fase en el plan:

  1. Anunciar fase: "Iniciando Fase X: {nombre}"

  2. Por cada tarea pendiente [ ]:

    • Lee la descripción de la tarea
    • Implementa según spec y guidelines
    • Si workflow indica TDD: escribe test primero, luego código
    • Verifica que funciona
    • Actualiza plan.md: cambia [ ] a [x]
    • Haz commit con mensaje semántico
  3. Reportar progreso: "Fase X completada (Y/Z tareas)"

Fase 4: Commits Atómicos

Formato de commits según workflow.md:

code
{tipo}({track}): {descripción}

- {detalle 1}
- {detalle 2}

Track: {nombre-track}
Tarea: {número}

Tipos comunes:

  • feat: nueva funcionalidad
  • fix: corrección de bug
  • refactor: mejora sin cambio funcional
  • test: añadir o modificar tests
  • docs: documentación

Fase 5: Verificación Final

Cuando todas las tareas estén completadas:

  1. Verifica que todos los tests pasen
  2. Actualiza el estado del track a "Completado"
  3. Muestra resumen:
    • Tareas completadas
    • Archivos creados/modificados
    • Commits realizados

Fase 6: Post-Implementación

Marca las tareas de post-implementación en plan.md:

  • Tests pasan → [x] Tests pasan
  • Documentación actualizada → [x] Documentación actualizada

Sugiere al usuario:

  • Revisar los cambios
  • Ejecutar tests adicionales si es necesario
  • Crear PR si corresponde

Manejo de Errores

Si una tarea falla:

  1. NO marques como completada
  2. Documenta el error en plan.md bajo la tarea
  3. Pregunta al usuario cómo proceder:
    • Reintentar
    • Saltar temporalmente
    • Abortar implementación

Notas

  • Nunca escribas código sin leer el contexto completo
  • Respeta estrictamente el tech-stack definido
  • Sigue los guidelines de código
  • Cada tarea = un commit (atómico)
  • Si el workflow indica TDD, escribe tests ANTES del código
  • Actualiza plan.md después de cada tarea completada