Triaje de Proyectos de GitHub
Usa siempre esta habilidad cuando el usuario escriba triage, a menos que la solicitud se dirija explícitamente a un dominio que no sea GitHub. Desde dentro de un repositorio, usa el proyecto actual de GitHub por defecto. Triaje significa tarjetas de elementos orientadas al mantenedor: URL, de qué trata cada issue/PR, por qué es importante, confianza del autor, idoneidad, riesgo, estado de prueba/verificación, bloqueadores y próxima acción. Nunca devuelvas solo números de cola o referencias opacas.
La salida es primero la URL: cada elemento (issue/PR/repo) debe incluir su URL de GitHub en la primera línea o primera oración. Si se da una lista corta, imprime una URL por elemento.
Usa RepoBar como primer paso solo para el descubrimiento amplio de colas entre propietarios/orgs relevantes. RepoBar es más rápido y consciente del perfil que hacer bucles gh repo list manuales, y ya entiende la actividad del repositorio, recuentos de issues, recuentos de PRs, proyectos locales, autenticación, caché y filtros.
Configuración
Preferir un binario repobar real cuando esté instalado. En este espacio de trabajo puede que solo exista como un producto SwiftPM en ~/Projects/RepoBar.
repobar_cmd() {
if command -v repobar >/dev/null 2>&1; then
repobar "$@"
elif [ -x "$HOME/Projects/RepoBar/.build/debug/repobarcli" ]; then
"$HOME/Projects/RepoBar/.build/debug/repobarcli" "$@"
else
swift run --package-path "$HOME/Projects/RepoBar" repobarcli "$@"
fi
}
repobar_cmd status --json
Propietarios predeterminados para triaje amplio: steipete, openclaw. Para el triaje de cola amplio/predeterminado, incluye un pase detallado para openclaw/openclaw incluso si no es el primer repositorio por recuento, porque es la cola principal de ClawdBot/OpenClaw. No incluyas amantus-ai u otros propietarios a menos que el usuario los nombre, el repositorio actual ya esté bajo ese propietario, o la tarea solicite explícitamente todo/todo. Para una tarea específica de un propietario, no amplíes más allá del propietario nombrado.
Puerta del Repositorio Local
Antes de comenzar a trabajar dentro de cualquier proyecto local, verifica que el checkout esté listo:
git status --short --branch
git branch --show-current
git pull --ff-only
git status --short --branch
Procede solo cuando la rama sea main, el pull tenga éxito y el árbol de trabajo esté limpio. Si la rama no es main, el pull falla, o git status --short muestra cambios, detente y pregunta a Peter qué hacer. No cambies de rama, hagas stash, commits, resets, restores o limpiezas sin una dirección explícita.
Regla de Ámbito
Si el usuario dice triage y el directorio de trabajo actual es un repositorio Git con un remoto de GitHub, haz el triaje solo de ese proyecto. No amplíes a todas las colas de Peter/org a menos que el usuario diga broad, all, everything, nombre múltiples propietarios/orgs, o solicite triaje entre repositorios.
Si el repositorio tiene VISION.md, léelo antes de juzgar qué se puede manejar autónomamente. Úsalo como la fuente de verdad de la idoneidad del producto, luego aplica las reglas de riesgo/testabilidad de esta habilidad. Si no hay VISION.md, usa las reglas de idoneidad autónoma a continuación.
Encuentra el proyecto actual:
repo=$(gh repo view --json nameWithOwner --jq .nameWithOwner 2>/dev/null || true)
if [ -z "$repo" ]; then
url=$(git remote get-url origin 2>/dev/null || true)
repo=$(printf '%s\n' "$url" |
sed -E 's#^[email protected]:##; s#^https://github.com/##; s#\.git$##')
fi
printf '%s\n' "$repo"
El triaje del proyecto actual comienza con:
gh issue list --repo "$repo" --state open --limit 50 \
--json number,title,author,labels,createdAt,updatedAt,url
gh pr list --repo "$repo" --state open --limit 50 \
--json number,title,author,isDraft,reviewDecision,mergeStateStatus,createdAt,updatedAt,url
Antes de actuar sobre cualquier issue o PR, lee todos los comentarios y trata los comentarios de Peter/propietario como instrucciones de enrutamiento autoritativas. Si Peter dice que se ve bien, necesita cambios, está reemplazado, está aprobado por el producto, o no es deseado, eso anula las etiquetas del bot y el juicio ordinario del triaje. Si no hay comentario de Peter/propietario, usa el juicio del mantenedor y di que la decisión es tuya.
Luego inspecciona suficientes detalles para explicar cada elemento mostrado. Para colas pequeñas (alrededor de 10 elementos abiertos o menos), inspecciona todos los elementos. Para colas más grandes, inspecciona el segmento de máxima prioridad y di lo que no se expandió.
gh issue view <n> --repo "$repo" \
--json number,title,author,body,comments,labels,createdAt,updatedAt,url
gh pr view <n> --repo "$repo" \
--json number,title,author,body,comments,files,commits,isDraft,reviewDecision,mergeStateStatus,statusCheckRollup,createdAt,updatedAt,url
gh pr diff <n> --repo "$repo" --patch
Solo comenta, cierra, fusiona, reejecuta o parchea con evidencia sólida.
Salida de Triaje
Cuando el usuario dice triage, siempre escanea los issues abiertos y los PRs abiertos para el repositorio actual. Devuelve:
Candidatos autónomos: elementos que parecen corregibles/fusionables sin más aporte del producto, con URL, por qué califica, verificación requerida y confianza. Esta es una selección para revisión, no permiso para comenzar a trabajar a menos que el usuario también solicite ejecución autónoma.Necesita a Peter: elementos bloqueados por la decisión de Peter/propietario, dirección del producto, credenciales/acceso faltantes, prueba de proveedor en vivo que no se puede obtener, juicio de seguridad/privacidad, o un comentario autoritativo de Peter solicitando cambios.Aplazar/cerrar/sustituir: elementos obsoletos, duplicados, de menor calidad o superpuestos donde la acción probable no es código nuevo.
Para cada candidato autónomo plausible, usa subagentes de alto razonamiento disponibles, oráculo o revisión independiente del agente para verificar la viabilidad antes de presentarlo cuando exista soporte de herramientas. Dale al subagente solo evidencia local de la tarea y pregúntale si el elemento se puede completar autónomamente, qué verificación se requiere y qué podría hacerlo inseguro. Si los subagentes no están disponibles, haz la misma profundidad tú mismo y dilo.
Modo de Trabajo Autónomo
Cuando el usuario dice do work autonomously, work you can do autonomously, keep going o similar, no te detengas después de un resumen de cola o un parche local único. Trátalo como permiso para procesar la cola de issues/PRs elegibles secuencialmente hasta que no quede ningún elemento autónomo seguro, cada elemento esté fusionado/cerrado/aplazado con prueba, o un bloqueador requiera a Peter.
Nunca trabajes en múltiples tickets a la vez. Para cada elemento:
- Lee el issue/PR, código relacionado, docs, CI y
VISION.mdsi está presente; usa Google/documentos oficiales cuando los hechos puedan estar desactualizados o no claros. - Decide si es autónomo:
- Adelante: mejoras de rendimiento a menos que la complejidad aumente demasiado; correcciones de errores con reproducción/causa raíz y ruta de verificación; pequeños ajustes de UI/UX; correcciones de documentación; correcciones de pruebas/internas estrechas; limpieza de CI/dependencias de bajo riesgo con prueba verde.
- Pregunta primero: nuevas características, elecciones de producto/visión, cambios amplios de comportamiento, dependencias riesgosas, cambios sensibles a la seguridad sin pruebas sólidas, trabajo con proveedor en vivo sin credenciales utilizables, cualquier cosa que no pueda ser probada de extremo a extremo.
- Preferencia de refactorización: elige una refactorización limpia y acotada cuando sea la mejor corrección para un elemento autónomo; no uses "pequeño parche" como predeterminado si deja un diseño peor.
- Implementa o corrige el PR de la mejor manera mantenible. Prefiere actualizar el PR del colaborador cuando sea escribible; de lo contrario, recrea localmente con crédito.
- Verifica localmente y en vivo de extremo a extremo cuando sea posible. Para comportamiento de UI, usa la ruta de prueba de UI en vivo esperada del repositorio, como Peekaboo, browser-use, capturas de pantalla o prueba de VM. Para comportamiento de API/proveedor, usa una clave/cuenta real utilizable a través del flujo de trabajo secreto esperado cuando esté disponible. Si falta acceso, detente antes de pretender que el elemento está terminado y pide ayuda a Peter.
- Ejecuta Codex Auto Review antes de commit/merge a menos que sea trivial/solo docs o se haya omitido explícitamente; aborda los hallazgos aceptados/accionables.
- Asegura que CI esté verde, la descripción del PR/changelog estén bien, fusiona/cierra/comenta con evidencia, luego regresa a
main, hazpull --ff-only, y verifica un árbol de trabajo limpio antes de seleccionar el próximo elemento autónomo. - Después de cada PR fusionado, publica un comentario en el PR con exactamente cómo fue probado: comandos locales, prueba en vivo/UI/API, ejecución/estado de CI, commit fusionado y cualquier advertencia. Si se aplican imágenes de verificación, súbelas/publícalas con
gh imagecuando esté disponible; si el cargador no está disponible, dilo e incluye la ruta de la captura de pantalla o prueba de adjunto alternativo de GitHub en lugar de omitir imágenes silenciosamente.
No termines el modo autónomo con archivos sucios o una corrección local no enviada a menos que estés bloqueado. Si estás bloqueado, indica el bloqueador exacto, la rama/estado actual, la prueba ya recopilada y la próxima decisión necesaria.
El trabajo autónomo sigue estando limitado por el ámbito: repositorio actual por defecto; colas amplias/todas solo cuando el usuario solicitó amplio/todo/todo o nombró propietarios/orgs.
Señales de Confianza
Incluye confianza del autor/abridor para cada elemento que no sea de mantenedor que recomiendes actuar. Para elementos internos/de Dependabot de bajo riesgo, una línea breve de confianza bot/interno es suficiente.
Prefiere el ayudante incluido:
skills/github-project-triage/scripts/github-activity.sh --repo <owner/repo> --global <login>
Alternativa si este checkout de habilidad carece del ayudante:
~/Projects/clawdbot/.agents/skills/openclaw-pr-maintainer/scripts/github-activity.sh --repo <owner/repo> --global <login>
También usa github-author-context cuando un PR necesite un juicio de confianza más profundo, especialmente para OpenClaw, cambios sensibles a la seguridad, PRs amplios, cuentas nuevas o comportamiento de autor inusual. Prefiere primero las notas de colaboradores existentes:
~/Projects/maintainers/scripts/clawtributors find github <login>
La salida de confianza debe mantenerse factual:
Confianza: @login; cuenta 2021-04-03; repositorio 2 PRs/1 issue/0 commits en 12 meses; GitHub 9 PRs/3 issues/12 revisiones; señal: colaborador conocido / nuevo visitante / bot / desconocido.
No trates la confianza como prueba. Cambia la profundidad de la revisión, no la corrección.
Evaluación de Elementos
Clasifica cada elemento:
bug: requiere reproducción/log/prueba fallida/prueba de main actual cuando sea factible; identifica la causa raíz antes de recomendar corrección/fusión.feature: requiere plan de prueba de extremo a extremo. Si la validación en vivo necesita una clave de proveedor, cuenta, dispositivo, servicio, acceso a modelo o API paga, di exactamente qué credencial/acceso falta antes de que el trabajo pueda considerarse completo.dependencia: explica el grupo de paquetes, riesgo mayor/menor, comprobaciones fallidas, cambios de tiempo de ejecución/engine, y si dividir.seguridad: aumenta la prioridad, requiere prueba cuidadosa de la ruta del código, pruebas y confianza/contexto; no fusiones solo por razonamiento.docs/interno: menor riesgo, pero aún explica la relevancia visible para el usuario y el riesgo de rotación de contenido obsoleto/generado.
Juzga:
Idoneidad: buena / mixta / pobre, con una razón.Riesgo: bajo / medio / alto, con radio de explosión.Prueba: CI actual, reproducción local, prueba fallida, E2E en vivo, o prueba faltante.Bloqueador: aprobación de CI para colaborador primerizo, comprobación fallida, clave faltante, dirección de producto poco clara, rama obsoleta, diff no confiable/amplio, sin reproducción, conflictos.Siguiente: aprobar CI, ejecutar prueba, solicitar reproducción, dividir PR, parchear localmente, fusionar después de verde, cerrar con prueba, o aplazar.
Mapa Rápido de Colas
Usa esto solo cuando el ámbito sea amplio. Comienza con mapas de cola a nivel de repositorio. Esto encuentra repositorios con issues y/o PRs abiertos y da recuentos.
Cola de PRs, orden de triaje principal:
repobar_cmd repos \
--scope all \
--only-with work \
--owner steipete \
--owner openclaw \
--sort prs \
--json
Presión de issues, segundo pase cuando los issues importan:
repobar_cmd repos \
--scope all \
--only-with work \
--owner steipete \
--owner openclaw \
--sort issues \
--json
Usa --forks y --archived solo cuando el usuario diga "all", "everything" o solicite arqueología. El triaje predeterminado debe omitir forks y repositorios archivados a menos que sus colas sean específicamente relevantes.
Para una vista de terminal compacta:
repobar_cmd repos --scope all --only-with work --owner steipete --owner openclaw --sort prs --plain
Resumen útil con jq:
repobar_cmd repos --scope all --only-with work --owner steipete --owner openclaw --sort prs --json |
jq -r '.[] | [.fullName, .openIssues, .openPulls, .activityTitle, .activityActor] | @tsv'
Al resumir una cola ordenada por PRs, conserva el orden de recuento de PRs de RepoBar. No incluyas un repositorio con menos PRs mientras omites un repositorio con más PRs del mismo ámbito de propietario. Los repositorios con cero issues pero PRs abiertos, por ejemplo openclaw/crabbox, siguen siendo relevantes para el triaje.
Pase Detallado
Después de un mapa de cola amplio, inspecciona solo los repositorios principales a menos que el usuario quiera explícitamente detalle exhaustivo.
repobar_cmd issues <owner/name> --limit 50 --json
repobar_cmd pulls <owner/name> --limit 50 --json
repobar_cmd ci <owner/name> --limit 20 --json
repobar_cmd activity <owner/name> --limit 20 --json
Para PRs que parecen fusionables o sospechosos, cambia a gh para estado de nivel de mantenedor:
gh pr view <n> --repo <owner/name> --json number,title,state,author,isDraft,mergeStateStatus,reviewDecision,statusCheckRollup,updatedAt,url
gh pr diff <n> --repo <owner/name> --patch
gh run list --repo <owner/name> --branch <branch> --limit 10
Para issues que ya podrían estar corregidos, cambia a gh issue view, luego inspecciona la fuente actual antes de comentar o cerrar.
Para colas de OpenClaw/ClawdBot, usa el pase de mantenedor de OpenClaw cuando sea útil:
- busca duplicados/hilos relacionados con
gitcrawlsi está disponible; - usa el ayudante de actividad para la identidad del abridor/autor;
- suprime el ruido del mantenedor principal a menos que el usuario solicite trabajo propiedad del mantenedor;
- prefiere bugs reportados por usuarios externos y PRs con prueba clara.
Verificación Cruzada Local
Usa esto cuando la tarea mencione el estado del proyecto local, repositorios sucios o "¿qué tengo aquí".
repobar_cmd local --root "$HOME/Projects" --depth 1 --limit 200 --plain
repobar_cmd local --root "$HOME/Projects" --depth 1 --sync --limit 200 --json
No ejecutes acciones locales destructivas (local reset, eliminaciones de ramas, movimientos de checkout) a menos que el usuario lo solicite explícitamente.
Heurísticas de Triaje
Prioriza:
- PRs con CI verde o casi verde, actividad reciente del mantenedor, o cambios de bajo riesgo en dependencias/docs/pruebas.
- Repositorios con recuentos altos de PRs abiertos pero actividad reciente, porque a menudo ocultan limpieza obvia.
- Issues que son reproducibles, reportados recientemente, o bloquean lanzamientos.
- Reportes de seguridad, lanzamientos, autenticación, instalación, CI y pérdida de datos.
...
[truncado para traducción]