steipete/github-project-triage

Triaje de issues/PRs de GitHub: colas, CI, bloqueadores, riesgo, prueba, próximas acciones.

¿Qué es github-project-triage?

Esta habilidad está diseñada para mantener la calidad del proyecto a través del triaje automatizado de issues y pull requests (PRs) en GitHub. Permite a un agente de IA (como Claude Code, Cursor o Codex) analizar colas de issues/PRs, evaluar riesgos, verificar el estado de CI y determinar las próximas acciones. Es ideal para gestores de proyectos, mantenedores y desarrolladores que manejan multiples repositorios y necesitan priorizar el trabajo. La herramienta utiliza `repobar` para un descubrimiento rápido de colas y `gh` para un análisis detallado. Evalúa cada elemento basándose en su idoneidad, riesgo, estado de verificación, bloqueadores y nivel de confianza del autor. Además, ofrece un modo de trabajo autónomo para procesar secuencialmente issues/PRs elegibles con verificación local y de CI, comentarios y documentación de pruebas. La habilidad se activa con el comando `triage` y opera sobre el repositorio actual por defecto, con reglas claras para evitar acciones destructivas o cambios no autorizados.

Compatible con~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/github-project-triage

Installed? Explore more Investigación y análisis de datos skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

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:

  1. Lee el issue/PR, código relacionado, docs, CI y VISION.md si está presente; usa Google/documentos oficiales cuando los hechos puedan estar desactualizados o no claros.
  2. 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.
  3. 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.
  4. 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.
  5. 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.
  6. Asegura que CI esté verde, la descripción del PR/changelog estén bien, fusiona/cierra/comenta con evidencia, luego regresa a main, haz pull --ff-only, y verifica un árbol de trabajo limpio antes de seleccionar el próximo elemento autónomo.
  7. 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 image cuando 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 gitcrawl si 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]

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

steipete/nano-banana-pro

Nano Banana/Gemini image gen/edit: text/image input, 512-4K workflows.

Skills relacionados