jaemk/cached

¿Qué hace cached?

Ciclo de revisión y actualización de PR — el orquestador que lleva un PR desde la revisión hasta su resolución. Ejecuta una revisión local (delegando en la habilidad pr-review), obtiene comentarios de revisión abiertos de GitHub, evalúa todos los hallazgos, aplica correcciones válidas, ejecuta CI, confirma (commits), sube (pushes), resuelve hilos y vuelve a solicitar la revisión de Copilot. Soporta tres modos — full (por defecto, todo), local (solo el bucle de revisión y corrección local; sin lecturas ni mutaciones de la conversación del PR en GitHub) y remote (solo el bucle de retroalimentación del PR en GitHub).

Características

• Modo completo (full): Ejecuta el ciclo completo: revisión local, obtención de comentarios de GitHub, evaluación, corrección, CI, commit, push, resolución de hilos y re-solicitud de revisión.
• Modo local (local): Solo realiza la revisión y corrección local del código. No interactúa con la conversación del PR en GitHub.
• Modo remoto (remote): Solo maneja la retroalimentación remota de GitHub: obtiene comentarios, aplica correcciones, ejecuta CI, confirma, sube, resuelve hilos y re-solicita revisión.

Requisitos

• Acceso a GitHub API (token de acceso personal con permisos repo y pull_request).
• Habilidad pr-review instalada y configurada.
• Entorno con git, gh (GitHub CLI) y acceso a CI configurado.

Uso

# Modo completo (por defecto)
cached full

# Solo revisión local
cached local

# Solo interacción remota con GitHub
cached remote

Variables de Entorno

• GITHUB_TOKEN: Token de acceso personal de GitHub con permisos para leer y escribir PRs.
• PR_NUMBER: Número del Pull Request a procesar (opcional, se detecta automáticamente si no se proporciona).

Flujo de Trabajo

1. Revisión local: Delega en pr-review para analizar el código local.
2. Obtener comentarios: Recupera comentarios de revisión abiertos de GitHub.
3. Evaluar hallazgos: Cruza los hallazgos locales con los comentarios de GitHub.
4. Aplicar correcciones: Aplica las correcciones validadas al código.
5. Ejecutar CI: Lanza la ejecución de CI para verificar la corrección.
6. Commit y push: Realiza commit de los cambios y los sube al repositorio.
7. Resolver hilos: Marca como resueltos los hilos de discusión correspondientes.
8. Re-solicitar revisión: Solicita una nueva revisión a Copilot.

Notas

• El modo local es útil para entornos sin conexión o cuando solo se quiere validar el código localmente.
• El modo remote es útil cuando ya se ha realizado una revisión local manual y solo se necesita gestionar la retroalimentación de GitHub.
• Asegúrate de que el repositorio esté limpio antes de ejecutar cualquier modo.

Licencia

MIT