Revisa los cambios antes de hacer push

SourceAnt puede revisar el trabajo de tu copia de trabajo antes de que hagas commit o abras una pull request. Lee el diff, compruébalo con las skills aplicables y el conocimiento registrado, corrige los problemas detectados y ejecuta otra revisión desde el terminal, el navegador local o tu asistente de programación.

Abre tu copia de trabajo

Sigue Configuración local para instalar SourceAnt. Después inicia el agente y registra tu repositorio:

sourceant ui
sourceant repo add /path/to/checkout --name acme/app
sourceant repos

También puedes añadir un repositorio desde el navegador. Abre Revisiones y selecciona ese repositorio. No necesitas una instalación de la GitHub App ni una pull request para una revisión local.

Revisa desde el terminal

Ejecuta una revisión desde tu copia de trabajo o pasa su ruta:

sourceant review /path/to/checkout
sourceant review /path/to/checkout --against main
sourceant review /path/to/checkout --no-model

El comando muestra un enlace para el navegador, espera a que termine la revisión y muestra el resultado. Usa --no-wait para obtener el enlace de inmediato, o --json para obtener una salida estructurada. Un código de salida de 2 significa que la revisión determinó que el cambio no estaba listo. --no-model inspecciona el cambio sin pedir a un modelo que lo evalúe.

Establece un nombre para la revisión con --title y selecciona una skill con --skill. Repite --skill para seleccionar varias skills. Configura el modelo en el navegador local antes de solicitar una revisión con modelo.

Consulta los cambios

Haz clic en Consulta los cambios para inspeccionar los archivos modificados, los commits, las skills aplicables y el conocimiento registrado. Esto no realiza ninguna llamada a un modelo ni evalúa el cambio. Funciona antes de que configures un modelo.

La comparación incluye los cambios de la rama, las modificaciones preparadas y sin preparar, y los archivos sin seguimiento que Git no ignora. SourceAnt elige como rama de comparación la rama remota predeterminada de la copia de trabajo cuando está disponible y después busca el ancestro común con tu rama. Comprueba la rama y la comparación que aparecen en la revisión antes de confiar en su alcance.

Ejecuta una revisión

1. Abrir Configuración → Modelo, elige un modelo e introduce la clave de su proveedor. Guarda y comprueba el resultado de la conexión.
2. Vuelve a Revisiones, selecciona tu repositorio y comprueba las skills seleccionadas para el cambio. Añade o elimina skills según lo necesites.
3. Haz clic en Revisar. La revisión se ejecuta en segundo plano y abre una página a la que puedes volver.
4. Lee Resumen, inspecciona Archivosy examina los hallazgos y los resultados de las skills junto al código modificado.
5. Haz tus cambios, ejecuta las comprobaciones de tu proyecto y solicita otra revisión de la copia de trabajo actualizada.

Las revisiones locales usan el mismo revisor de código que las pull requests, con el contexto disponible en esa instancia local. Consulta Habilidades para obtener instrucciones reutilizables y controles de revisión para las exclusiones y las observaciones menores. Las revisiones completadas siguen disponibles en el historial local de revisiones.

Pide a tu asistente de programación

Conecta tu cliente MCP a http://127.0.0.1:8930/mcp, o configura sourceant mcp como su comando de entrada y salida estándar. Mantén el agente local en ejecución. MCP permite al asistente llamar a las herramientas de SourceAnt en tu equipo.

Pide al asistente:

Revisa el árbol de trabajo de acme/app con SourceAnt y dame el enlace de la revisión.

La review_working_tree acepta como herramienta el nombre del repositorio registrado o la ruta de una copia de trabajo:

{
  "repository": "acme/app",
  "title": "Check the checkout before opening a PR"
}

La herramienta devuelve un ID de revisión, un estado y un enlace para el navegador mientras la revisión continúa en segundo plano. Abre ese enlace para leer el resultado. Un estado en ejecución no significa que la revisión haya terminado. Esta herramienta requiere una instancia que pueda acceder a tu copia de trabajo; la interfaz MCP alojada no puede leer archivos de tu portátil.

Usa las revisiones junto con las comprobaciones de tu proyecto

Ejecuta las pruebas, el análisis de lint, las comprobaciones de tipos y la compilación de tu proyecto como parte de la verificación local. Un hallazgo puede identificar un problema probable, pero una lista vacía de hallazgos no demuestra que las pruebas pasen ni que se hayan examinado todas las rutas modificadas. La cobertura de la revisión indica qué se ha leído y qué se ha excluido o no estaba disponible.

Consulta los cambios es una inspección, no una ejecución de pruebas ni una aprobación. Revisar añade la revisión con modelo y las herramientas de análisis disponibles en la instancia; no sustituye el conjunto de pruebas de tu proyecto ni la CI.

Adónde va tu trabajo

El agente local lee tu copia de trabajo y conserva la revisión para su navegador local. Iniciar una revisión local no la publica como comentario de una pull request. Cuando solicitas una revisión con modelo, el código y el contexto pertinente se envían al proveedor de modelos que hayas configurado. Una instalación local no significa que un modelo remoto funcione sin conexión. El uso del proveedor se factura según tu cuenta con ese proveedor.

El conocimiento local pertenece a esa instancia. SourceAnt Cloud proporciona el espacio de trabajo de equipo gestionado y el flujo alojado de pull requests; una revisión local no pone automáticamente su conocimiento a disposición de una revisión en la nube.

Cuando una revisión no puede ejecutarse

• No aparece ningún repositorio: registra la copia de trabajo y comprueba sourceant status y sourceant repos.
• «Revisar» no está disponible: elige un repositorio y después configura el modelo y la clave del proveedor en Configuración.
• No hay ninguna skill aplicable: inspecciona la página Skills y las skills seleccionadas para este cambio. Un mensaje que indica que no se ha evaluado nada no equivale a una evaluación favorable.
• No se encuentra la rama de comparación: comprueba el historial de Git y la rama predeterminada de la copia de trabajo. Usa sourceant review --against main para elegir la rama de comparación.
• Falta la herramienta MCP: conéctate al agente local, comprueba que el revisor de código esté cargado y actualiza las herramientas disponibles del cliente.