Saltar al contenido principal

Integración con Visual Studio Code

Guía técnica para gobernar entornos de desarrollo en Visual Studio Code y GitHub Copilot con RAPID OS v3.

1. Qué es y cómo encaja con RAPID OS​

Visual Studio Code es el editor de código estándar ampliamente extendido que ofrece terminales integradas, paneles de depuración y extensiones de IA como GitHub Copilot Chat.

Encaje con RAPID OS: El desarrollador trabaja en VS Code utilizando su terminal integrada para ejecutar comandos de rapid y Copilot Chat para asistir la escritura de código. RAPID OS garantiza que cada cambio tenga un contrato trazable y evidencia de pruebas verificable.

2. Configuración en RAPID OS​

RAPID OS incluye el perfil integrado vscode:

rapid harness show vscode

Salida canónica:

  • context.consume: supported
  • repository.read: supported
  • workspace.current: supported
  • Capacidades de ejecución y escritura: configurables según las extensiones locales instaladas.

3. Configuración en VS Code​

  1. Abre el repositorio en VS Code.
  2. Abre la terminal integrada (Ctrl+\`` o Cmd+``).
  3. Asegura que el entorno virtual de Python esté seleccionado en la barra de estado.

Flujo principal: shortcuts​

La forma recomendada de trabajar con VS Code y Copilot es con los shortcuts /rapid-<modo>. Los 9 shortcuts, el bucle que siguen, la aprobación humana y los errores frecuentes están en la guía de shortcuts.

Instalación​

rapid init --shortcuts                                # al inicializar el proyecto
rapid shortcuts install --harness vscode              # en un proyecto ya inicializado

Genera .github/prompts/rapid-*.prompt.md (los 9 shortcuts como prompt files; documentación). Tras actualizar Rapid OS, vuelve a ejecutar rapid shortcuts install.

Primer paso: /rapid-init (onboarding)​

El punto de entrada de un proyecto es /rapid-init: conduce el onboarding (rapid setup next), te pregunta el stack de cada componente, la arquitectura, los servicios y los documentos, y revisa contigo los borradores antes de cerrar. Después usas /rapid-feature y los demás modos. Ver Primer proyecto.

--global no existe para VS Code: no hay una carpeta de usuario documentada para los prompt files de este uso, así que rapid shortcuts install --global --harness vscode falla con RAPID1413 y no escribe nada. Instala /rapid-init en cada proyecto con rapid shortcuts install --harness vscode.

Los shortcuts y los hooks ejecutan rapid desde el shell del agente: si no está en el PATH, rapid init y rapid doctor avisan con RAPID1414 (aviso, no error). Ver la guía de shortcuts.

Invocación​

En la vista de Chat escribe / seguido del nombre (o usa el comando Chat: Run Prompt):

/rapid-feature añadir exportación CSV al informe mensual
  • /rapid-approve no aprueba: te da el comando para ejecutar en la terminal integrada. rapid approve exige una terminal interactiva tuya y falla con RAPID1310 si lo lanza un agente.
  • VS Code lee además skills de .claude/skills/ y .agents/skills/. Si usas VS Code junto con Claude Code, Codex o Antigravity, consulta cómo combinar harnesses antes de añadir vscode a la instalación.

Modo avanzado (comandos v3)​

Los comandos v3 (rapid spec, rapid run, rapid evidence, rapid eval…) siguen disponibles para CI, depuración y auditoría, y tampoco hace falta usarlos a mano en el día a día. La sección 4 conservan el flujo manual completo.

4. Flujo de Trabajo en VS Code​

  1. Creación del Run: En la terminal integrada:
rapid run create --spec <spec-id> --harness vscode
  1. Verificar Baseline: Ejecuta las pruebas iniciales guardando el log auténtico como artefacto (base.log), registra la evidencia de baseline (conforme a evidence_baseline.json) y reconoce gate.baseline antes de activar el run:
python -m unittest discover -s tests -t . > base.log 2>&1
rapid evidence add --run <run-id> --input evidence_baseline.json
rapid run gate <run-id> gate.baseline acknowledged
rapid run status <run-id> active
rapid run task <run-id> T001 in_progress

  1. Asistencia con Copilot Chat: En Copilot Chat, usa #file:.rapid-os/runs/<run-id>/contract.json para enfocar al modelo en los objetivos y restricciones de la tarea.

  2. Ejecución de Pruebas: Ejecuta la suite de pruebas desde la terminal o mediante el panel de testing de VS Code.

  3. Registro de Evidencias: Usa el CLI de RAPID OS en la terminal para registrar el progreso (ver detalles y esquemas en el laboratorio Bajo el capó):

rapid evidence add --run <run-id> --input evidence_files.json
rapid evidence add --run <run-id> --input evidence_test_result.json
rapid evidence add --run <run-id> --input evidence_workspace.json
rapid evidence add --run <run-id> --input evidence_review.json
rapid run gate <run-id> gate.tests acknowledged
rapid run gate <run-id> gate.final-verification acknowledged
rapid run task <run-id> T001 done
rapid run status <run-id> finished
  1. Evaluación Final:
rapid eval run --run <run-id> --write --require-pass