Flujo de trabajo de GitHub
Selecciona la operación solicitada y sigue su referencia de tarea. Cada operación trabaja sobre un issue o PR ordinario sin tareas previas de ghflow. Carga solo la tarea y las reglas compartidas necesarias en ese momento. Aplica Contexto de trabajo y salida de herramientas para la carga de referencias, búsquedas y traspasos.
Antes de elegir cómo ejecutar la operación, aplica Modo de ejecución. El trabajo en modelo local permanece en la sesión actual sin subagentes. Este modo anula las instrucciones de la tarea para enviar trabajadores o iniciar sesiones de revisión nuevas.
Localiza la fuente y las herramientas
Resuelve esta ruta SKILL.md a través de cualquier enlace simbólico. Su directorio padre es GHFLOW_SKILL_DIR. Usa rutas absolutas debajo de ese directorio para referencias y traspasos de subagentes. Establece GHFLOW_CLI a la ruta absoluta de cli/ghflow.py debajo de él antes de ejecutar los comandos de ejemplo. Pon entre comillas la ruta. Una herramienta de comandos puede iniciar un nuevo shell para cada llamada, así que exporta la variable en cada comando que la use, o escribe la ruta completa:
export GHFLOW_CLI="DIRECTORIO_ABSOLUTO_DEL_SKILL/cli/ghflow.py"
python3 "$GHFLOW_CLI" --help
Reemplaza DIRECTORIO_ABSOLUTO_DEL_SKILL con el directorio resuelto. El directorio resuelto del skill es la raíz del checkout fuente. Usa su cli/ghflow.py directamente. Mantén el directorio actual en el proyecto objetivo para que la configuración de Git, GitHub e identidad use ese proyecto. Resuelve la guía de escritura a través de los enlaces de cada referencia, no a través del directorio actual. Si las lecturas de fuente necesitan permiso de directorio externo, informa la ruta de checkout resuelta y usa las instrucciones de configuración en Permisos de acceso a la fuente. No cambies silenciosamente los permisos del agente.
La referencia de tarea seleccionada indica las reglas compartidas que necesita. Abre una referencia compartida cuando se cumpla su condición, y lee la sección que toma la decisión; no leas cada referencia compartida antes de la primera acción. Las condiciones: Autorización cuando surja una pregunta de permiso o alcance; Evidencia antes de informar un resultado o pasar un identificador; Decisiones cuando falte un hecho o una elección; Identidad del agente antes de que un agente ejecute comandos de Git o GitHub; Escrituras en GitHub antes de cambiar registros de GitHub. Las lecturas del CLI no otorgan permiso para escribir.
Selecciona la operación solicitada
Haz coincidir la solicitud explícita del usuario con la operación a continuación. Identifica el repositorio sujeto a partir de la solicitud del usuario o del checkout objetivo. python3 "$GHFLOW_CLI" facts informa el checkout, repositorio, herramientas, preparación de identidad y el archivo de hechos del proyecto; con --issue URL_DEL_ISSUE añade las ramas, worktrees, PRs y elementos del tablero del issue. Úsalo en lugar de lecturas separadas de git y gh para ese estado, y lee .ghflow/project.md cuando lo informe. Para el inicio de una sesión de modelo local, preamble URL_DEL_ISSUE imprime estos hechos como un bloque compacto que cabe en el primer prompt. El checkout fuente proporciona instrucciones y herramientas; su remoto y la cuenta configurada no identifican el sujeto. Si el repositorio, issue o PR seleccionado falta, devuelve la entrada necesaria antes de búsquedas en GitHub o envíos. Para una solicitud solo de evaluación, explica la operación y sus límites sin realizar la entrega. Si un punto final material no está claro, pregunta solo por esa decisión. No elijas trabajo pendiente ni añadas una secuencia fija. Una solicitud de entrega por defecto implica seguimiento de revisión con su PR dejado abierto. Lee su referencia de coordinador y aplica el modo de ejecución seleccionado a los requisitos de envío y revisión.
| Solicitud | Referencia de tarea |
|---|---|
| Re-evaluar un issue existente | reconsider-issue |
| Definir una idea o issue, incluyendo trabajo solo en borrador | define-issue |
| Resolver decisiones del issue con el usuario | interview-issue |
| Dividir un padre amplio en hijos | decompose-parent-issue |
| Publicar un borrador de issue revisado | file-issue |
| Implementar un issue mediante commits locales | implement-issue |
| Revisar cambios de código de forma independiente | review-changes |
| Publicar cambios commiteados como un PR | submit-pr |
| Abordar comentarios de PR y reparar CI | address-pr-review |
| Fusionar un PR explícitamente autorizado | merge-pr |
| Entregar o abordar un issue seleccionado | express-issue |
| Entregar un issue padre acordado | deliver-parent-issue |
| Agrupar issues relacionados bajo temas | bundle-issues |
| Evaluar un conjunto solicitado de issues abiertos | triage-issues |
| Resolver issues que necesitan información | sweep-needs-input |
| Definir issues aceptados | sweep-needs-definition |
| Devolver issues desbloqueados a definición | sweep-blocked |
| Auditar issues cerrados | sweep-audit-closed |
| Priorizar un alcance de tablero solicitado | sweep-prioritize |
| Preparar issues en la cola Lista | curate-ready-queue |
| Entregar una cola Lista solicitada explícitamente | burndown-ready-queue |
| Escribir o actualizar el archivo de hechos del proyecto | prepare-project-facts |
Ejecuta y traspasa
Para trabajo sostenido o hallazgos que serían costosos de reconstruir, aplica Notas de tarea. Al reanudar o después de la compactación de contexto, lee las notas existentes de la tarea antes de repetir investigación o reabrir decisiones.
Sigue el alcance y punto de parada de la referencia seleccionada. Lleva la autorización existente a través de las tareas incluidas. Los límites de solo borrador y solo lectura siguen aplicándose; la implementación o el envío nunca implican permiso de fusión.
En modo delegado, aplica Coordinación. Dale al subagente la operación seleccionada y las entradas requeridas. Si la delegación o el modelo de revisor requerido no están disponibles, sigue las reglas compartidas e informa el límite.
Devuelve el resultado real de la operación, fuentes, comprobaciones y decisiones restantes. Informa explícitamente las capacidades faltantes y la evidencia incompleta.