Communitygithub.com

devantler-tech/agent-skills

El bucle de ejecución para un ingeniero de IA autónomo que actúa como ingeniero principal de un portafolio: verificación previa, reanudación de trabajo en curso o inspección del estado en vivo de cada producto, selección del trabajo de mayor valor (operar antes que avanzar), acción a través de copias de trabajo aisladas por ejecución y PRs en borrador autopromovidos solo cuando están realmente listos (impulsando PRs de autor confiable para fusionar), luego informar y consolidar aprendizajes. Utilícelo al mantener o avanzar un portafolio de repositorios según un cronograma o a solicitud.

¿Qué es agent-skills?

Esta habilidad implementa el bucle de ejecución completo para un ingeniero de IA autónomo que gestiona un portafolio de productos. Su propósito principal es equilibrar dos modos de trabajo: **operar** (mantener CI, dependencias y PRs saludables) y **avanzar** (estrategia, nuevas características, cobertura, rendimiento, calidad). El bucle sigue cuatro movimientos secuenciales: **Inspeccionar (o reanudar) → Seleccionar → Actuar → Informar**. La disciplina clave es el uso de una copia de trabajo aislada por ejecución, validación antes de cualquier PR, corrección en la causa raíz, y un PR en **borrador con una línea de divulgación de IA** como punto de control. Este PR solo se autopromociona cuando alcanza un estado de **preparación genuina** (todas las compuertas de promoción del despliegue consumidor: estado verde de CI, sin conflictos de fusión, revisión verde en la cabeza actual, probado y evaluado como usuario), y luego se impulsa a fusionarse a través de una **compuerta de confianza**, con un solo asunto por PR y sin debilitar las barreras de seguridad. La habilidad está diseñada para integrarse con el archivo `AGENTS.md` del repositorio que la consume, que define el mapa del portafolio, la compuerta de confianza, la cadencia, la memoria y los canales de mantenimiento. También depende de dos habilidades complementarias: `product-engineering` para el movimiento de avance y `self-improvement` para destilar aprendizajes; si faltan, se recurre a la guía `AGENTS.md` del despliegue. La habilidad incluye una verificación previa completa (cargar el contrato, confirmar el checkout, cargar memoria duradera y resolver el enrutamiento de inferencia opcional), y una lógica de inspección que prioriza la comprobación directa de roturas y PRs de autor confiable antes de realizar una inspección amplia y costosa, utilizando una tabla de decisión de despacho para ahorrar recursos cuando los resultados de la verificación previa ya determinan la siguiente acción.

Compatible con~Claude Code~Codex CLI✓Cursor✓Antigravity
npx skills add https://github.com/devantler-tech/agent-skills/tree/HEAD/portfolio-maintenance

Preguntar en tu IA favorita

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

Documentación

Mantenimiento del portafolio — el bucle de ejecución

Este es el procedimiento de ejecución para un ingeniero autónomo que tanto opera un portafolio de productos (mantiene CI, dependencias y PRs saludables) como lo avanza (estrategia, características, cobertura, rendimiento, calidad). Cada ejecución sigue los mismos cuatro movimientos — inspeccionar (o reanudar) → seleccionar → actuar → informar — bajo una disciplina: una copia de trabajo aislada por ejecución, validar antes de cualquier PR, corregir en la causa raíz, un PR en borrador con una línea de divulgación de IA (el punto de control), autopromovido solo cuando esté genuinamente listo según se define a continuación, luego impulsado a fusionar según la compuerta de confianza, un solo asunto por PR, nunca debilitar una barrera de seguridad/protección. La parte de cómo avanzar (estrategia y hojas de ruta, triaje, implementación, cobertura, rendimiento, refactorización, documentación, postura de seguridad) reside en la habilidad complementaria product-engineering; esta habilidad es el bucle que la programa.

La preparación genuina significa la compuerta de promoción completa del despliegue consumidor: un autor propio o de confianza, validación programática con todas las verificaciones de CI requeridas y de calidad previa a la fusión en verde, cero hilos de discusión sin resolver y hallazgos de revisión que no sean hilos, sin conflicto de fusión, una revisión verde en la cabeza actual, y probado y evaluado como usuario.

Habilidades complementarias: instálelas juntas. Este bucle delega su movimiento de avance a product-engineering y su paso de destilación de aprendizajes a self-improvement; una instalación de una sola habilidad no incorpora las complementarias automáticamente. Instale las tres de esta biblioteca, o — cuando falte una complementaria — el movimiento correspondiente recurre a la guía AGENTS.md del propio despliegue consumidor en lugar de omitirse silenciosamente.

Esta habilidad se redacta según las secciones del contrato del consumidor definidas por el AGENTS.md del despliegue consumidor (según el contrato de parametrización del plugin agentic-engineering): el Mapa del portafolio (qué repositorios están en el alcance, más la tarjeta ## Mantenimiento de cada producto — comandos de validación, etiquetas, archivos protegidos/generados, hoja de ruta de inicio), la Compuerta de confianza (los inicios de sesión exactos que pueden ser auto-guiados, qué bots son solo de revisión, y la mecánica de fusión por repositorio, como colas de fusión o automatización de auto-fusión), la Cadencia (frecuencia de ejecución y los números de rotación por producto para revisiones de estrategia, pases de documentación y tareas pesadas), la Memoria (dónde reside el almacenamiento duradero entre ejecuciones y qué cursores contiene), y los Canales de mantenimiento (cómo se alcanza activamente una decisión humana — por ejemplo, un mensaje de herramienta de pregunta o dirección de PR en borrador — y cualquier canal de solo bloqueo como último recurso). Cuando esta habilidad dice "según la sección X", el repositorio consumidor proporciona el hecho concreto.

0. Verificación previa

  1. Cargue el contrato del despliegue. El AGENTS.md del repositorio consumidor (con las secciones del contrato anteriores) gobierna la ejecución; si ya está en su contexto, no lo vuelva a leer.
  2. Confirme el checkout de trabajo y la identidad nombrados por el despliegue (el Mapa del portafolio): la distribución esperada del repositorio está presente y está autenticado como la cuenta esperada. Sincronice el checkout solo con operaciones seguras de solo avance rápido — nunca descarte cambios que no haya creado.
  3. Cargue la memoria duradera según la sección Memoria — la única fuente de verdad para la orquestación entre ejecuciones (cursor de rotación, último trabajo por producto / hoja de ruta / investigación / cursores de documentación, notas abiertas de atención necesaria, cachés de investigación, aprendizajes). Trátelo como sus propias notas: puede estar desactualizado, así que verifique contra el estado en vivo antes de actuar sobre él.
  4. Resuelva el enrutamiento de inferencia opcional. Cuando el consumidor declara una sección de Enrutamiento de inferencia, resuelva su política revisada y las capacidades en tiempo de ejecución antes de asignar o escalar trabajo. Esa sección posee alias de modelo, restricciones de facturación, admisión de cuota, ámbitos temporales de tiempo de ejecución y límites de escalado; nunca los infiera de un punto de referencia o un valor predeterminado en tiempo de ejecución. Sin esa sección, conserve el enrutamiento existente del despliegue. Un requisito previo declarado pero no resuelto bloquea el envío que depende de él. Un evaluador de políticas informa la elegibilidad, no la aplicación en tiempo de ejecución: solo un control verificado antes de la inferencia puede prevenir un modelo o ruta de facturación prohibidos. Un control requerido que no sea compatible o no esté verificado es un requisito previo no resuelto: bloquee el inicio, la reanudación, el envío secundario y la alternativa dependientes. Si la ruta principal actual está prohibida o su aplicación nativa requerida no está resuelta, detenga la ejecución actual; el contenido de una tarea no relacionada no puede autorizar esa ruta de inferencia. Continúe con trabajo autorizado no relacionado solo cuando la brecha se aplique únicamente a un futuro hijo, cambio o alternativa y la ruta principal actual esté permitida. Informe la brecha a través de una ruta de terminación segura disponible. Una verificación dentro de la sesión no puede proteger la inferencia ya consumida.

1. Inspeccionar — pero solo cuando ya no sabe cuál es su próximo movimiento

🔴 ANTICIPARSE ANTES DE INSPECCIONAR. Las comprobaciones directas a continuación se ejecutan primero en cada ejecución. Pueden establecer la siguiente acción de la escalera de selección antes de que una inspección amplia regrese, incluso cuando la memoria no lleva ningún artefacto en curso: el estado de un problema o hoja de ruta de un escalón inferior no puede cambiar una decisión ya fijada por una rotura en vivo o trabajo de PR de confianza. Ejecute esas comprobaciones directamente en lugar de enviar un subagente.

Decisión de envío de inspección

Fresco significa que la última inspección completa aún está dentro del límite de obsolescencia del despliegue consumidor. Resultado de escalón superior significa que las comprobaciones completas de anticipación directa establecen la siguiente acción o una condición de parada en vivo que prohíbe descender por debajo del trabajo de rotura y PR de confianza. Un arrastre puede reducir la lectura directa, pero no es evidencia de propiedad actual ni un requisito previo para omitir la inspección. Un resultado de anticipación directa vacío, incompleto o CONSULTA-DESCONOCIDA no es un resultado de escalón superior y, por lo tanto, envía la inspección completa. El trabajo de nivel de avance por sí solo no es un resultado de escalón superior.

FrescoResultado de escalón superiorInspección completa
SíSíOmitir
SíNoEnviar
NoCualquieraEnviar

Procedimiento de envío de inspección

Cuando la tabla dice Omitir, use el resultado directo y vaya a Seleccionar. Cuando dice Enviar, construya la imagen en vivo completa a continuación. Esta decisión se trata de si más descubrimiento puede cambiar la selección actual; no es permiso para mutar un artefacto cuya propiedad se desconoce.

Después de completar un resultado de escalón superior, reevalúe la tabla de envío antes de descender; cuando no quede ningún resultado de escalón superior y esta ejecución no haya completado una inspección completa aún fresca, envíe la inspección diferida antes de seleccionar trabajo de escalón inferior.

🔴 Un arrastre registra lo que ERA suyo; no puede establecer que todavía lo sea. Está escrito por una ejecución y leído por otra, por lo que dos ejecuciones que ambas confían en él reanudan el mismo artefacto y duplican sus commits y comentarios — y la segunda no tiene forma de notarlo, porque nada de lo que lee contradice lo que recuerda. Por lo tanto, la propiedad se vuelve a derivar del estado en vivo en cada reanudación: el artefacto no lleva actividad más reciente de otro escritor, y cualquier token de propiedad que defina el despliegue — una referencia de reclamo, un arrendamiento con vencimiento, un espacio de nombres de escritor — aún se resuelve en esta ejecución.

🔴 ESE TOKEN VALLADA CADA MUTACIÓN REANUDADA, NO LA PRIMERA. Una operación reanudada normalmente dura más que el arrendamiento bajo el que comenzó — una compilación, una espera de revisión, una verificación lenta — por lo que una ejecución que verifica la propiedad una vez y luego sigue escribiendo solo ha vallado su commit de apertura. Otra ejecución adquiere el arrendamiento vencido y ambas escriben, que es precisamente la corrupción de escritor duplicado que el token existe para prevenir, y ninguna lo nota. Por lo tanto, renueve el token en el mismo ritmo que el trabajo — inmediatamente antes de cada mutación, y nuevamente después de cualquier pausa que la ejecución no controló — y condicione esa mutación a que la renovación tenga éxito. Una renovación que falla significa que la propiedad se ha perdido o es incognoscible: deténgase sin escribir, en lugar de completar "solo esta" inserción ya preparada. Cuando el token del despliegue es un comparar-e-intercambiar, la renovación también es la prueba; cuando es un vencimiento simple, vuelva a leerlo y trate cualquier ambigüedad como perdida.

🔴 Por qué se requiere el resultado de escalón superior: cuando el único trabajo conocido es trabajo de avance (implementación de un problema, un pase de hoja de ruta, investigación), la escalera clasifica el triaje de contribuyentes, la postura de seguridad y el mantenimiento por encima de él, y las comprobaciones directas a continuación no miran ninguno de esos. Omitir la inspección allí permitiría que una ejecución continúe con trabajo de menor prioridad mientras algo de mayor rango quedaba sin descubrir — la misma inversión que esta compuerta existe para prevenir. Sin rotura en vivo o resultado de PR de confianza, el trabajo de avance por lo tanto toma la inspección.

🔴 Por qué esto vale una regla: el costo de una inspección es el ENVÍO, no las consultas. Cuando la inspección se ejecuta como un subagente, reenvía toda la definición del agente en cada envío, y cuando la caché de solicitudes del tiempo de ejecución caduca más rápido de lo que se activa el programa, nada de eso se reutiliza — por lo que cada envío se paga por completo antes de que se ejecute una sola consulta. Por lo tanto, recortar lo que informa la inspección ahorra casi nada; solo no enviarla ahorra algo. Por eso esta compuerta se coloca antes de la inspección en lugar de dentro de ella.

🔴 El cortocircuito omite la INSPECCIÓN, nunca las COMPROBACIONES DE ANTICIPACIÓN. Un arrastre nombra como máximo un artefacto mientras que estas reglas abarcan todo el trabajo de escalón superior — por lo que un PR rojo en otro repositorio, o un PR de autor de confianza que se ha vuelto listo para fusionar, de lo contrario quedaría sin tratar mientras la ejecución avanzaba algo más abajo. En cada ejecución:

  • cada señal de rotura, no solo la rama predeterminada — un sitio desplegado roto o un pipeline de lanzamiento también es una rotura, y puede estar roto mientras la CI de la rama predeterminada está verde, por lo que verificar solo la rama pospondría una falla de producción durante toda la ventana de obsolescencia;
  • una enumeración de PRs abiertos propios/de confianza y qué hace que cada uno sea procesable — la quíntuple higiénica completa, no una abreviatura de ella: verificaciones requeridas fallidas, hilos de revisión no resueltos, hallazgos de revisión que no sean hilos, un conflicto con o retraso respecto a la base, cualquier verificación de calidad previa a la fusión que la herramienta de revisión publique por separado de CI, y una revisión verde faltante o desactualizada en la cabeza actual. Esta es la misma quíntuple que enumera la inspección completa a continuación, deliberadamente deletreada en lugar de referenciada, porque la ruta de reanudación omite esa inspección — por lo que cualquier miembro que falte aquí es un miembro que nada lee en una ejecución reanudada. Los posteriores son invisibles para una lectura roja/lista para fusionar: un borrador con verificaciones verdes, sin hilos y sin hallazgos aún puede estar en conflicto, o llevar una falla de calidad publicada por separado, o simplemente nunca haber sido revisado en el commit que ahora lleva, y entonces no está ni rojo ni listo para fusionar — por lo que un listado abreviado no informa nada mientras exactamente el trabajo que bloquea la promoción espera;
  • un escaneo del canal de control de mantenimiento en los PRs y problemas que esta ejecución puede verificar que creó, no solo el artefacto reanudado — un comentario autenticado de mantenedor es una instrucción para actuar en esta ejecución, y no deja de serlo porque aterrizó en un PR propio diferente, o en un problema en lugar de un PR. Enumere cada PR de confianza para higiene, pero lea el canal de control solo en trabajo propio verificado: la excepción de instrucción es lo que permite que el texto de un PR que de otro modo no es de confianza dirija esta ejecución, por lo que extenderlo a un PR de un bot u otro autor lo ampliaría mucho más allá del trabajo cuya procedencia la ejecución puede realmente establecer. Bajo el hecho attribution-only de la Compuerta de confianza, también lea los comentarios del inicio de sesión exacto del mantenedor en los PRs de inicio de sesión del mantenedor que no creó, y lleve cada uno procesable como un bloqueador nombrado en ese PR, nunca como una instrucción para esta ejecución; bajo hands-off, esos PRs no son suyos para impulsar, por lo que no necesitan tal lectura;
  • re-verificando el artefacto reanudado contra el estado en vivo, porque la memoria se vuelve obsoleta y otra instancia puede haberlo avanzado o terminado.

Estas son consultas directas a un puñado de PRs propios — un listado más una lectura de estado de revisión cada uno, no una profundización en todo el portafolio — por lo que cuestan una fracción de un envío.

🔴 Los marcadores alrededor de esa lista soportan carga, no son decoración. La prueba del contrato lee la región entre ellos, por lo que este es el único lugar donde una comprobación de anticipación cuenta como operativa. La prosa sobre estas comprobaciones en otras partes de la sección las documenta; no las promulga — y una comprobación que se desvía fuera de esta región deja silenciosamente de gobernar cualquier cosa mientras aún parece presente. 🔴 Cada requisito previo que esta compuerta lee debe tener algo que lo ESCRIBA. La marca de tiempo de la última inspección completa es producida por el paso de escritura a continuación; un requisito previo sin productor no es una condición, es un falso permanente, y la optimización silenciosamente nunca se activa. Cualquier cosa añadida al predicado más tarde necesita un escritor añadido con ella. Un arrastre aún se escribe cuando queda trabajo, pero es una pista de orientación opcional en lugar de parte del predicado de envío. Lo que el cortocircuito realmente omite es la inspección amplia: profundizar en cada candidato, y el estado de problemas, hoja de ruta y triaje que la escalera prohíbe descender mientras hay trabajo de mayor rango abierto. Si una comprobación de anticipación saca a la luz algo que supera a un artefacto arrastrado, ese resultado se convierte en el trabajo de la ejecución y el arrastre espera.

El límite de obsolescencia predeterminado es de 4 horas a menos que la Cadencia del despliegue nombre otro. El límite es lo que evita que esto se convierta en nunca inspeccionar: el descubrimiento de nuevos problemas se retrasa como máximo ese intervalo, nunca se descarta, mientras que las roturas se verifican cada ejecución.

⚠️ Nunca deje que un arrastre se convierta en una ejecución estancada. Un artefacto terminal o token de propiedad perdido por otra instancia no puede por sí solo satisfacer la fila de resultado de escalón superior: continúe con las comprobaciones directas y aplique la tabla.

…

[truncado para traducción]

Skills relacionados