HumanLayer Skills: conservar instrucciones y diseñar ciclos revisables
Leer /iterate en HumanLayer: roles, marcadores de PR y contexto crudo
Sigue la admisión del workflow y el auxiliar Bun sin confundir enrutamiento con autenticación ni comentarios con instrucciones confiables.
Qué aprenderás
- La admisión intenta preceder a la preparación costosa
- El auxiliar organiza contexto, no lo valida todo
- Sigue efectos finales además del prompt
Antes de empezar
- Instrucciones de repositorio y conceptos GitHub Actions
- Comprender alcance de revisión y contexto persistente
Diseñar un flujo acotado e inspeccionable y separar supuestos de plantillas de comportamiento probado.
Conclusiones clave
- El marcador enruta, no aporta confianza criptográfica.
- Contexto crudo y memoria ausente necesitan decisiones explícitas.
- Construir prompts puede conducir a commits y pushes reales.
La admisión intenta preceder a la preparación costosa
Para comentarios, la condición comprueba que sea un PR, un prefijo /iterate y asociación OWNER, MEMBER o COLLABORATOR. Después obtiene el cuerpo y busca el marcador del workflow antes de checkout e instalación.
El marcador decide qué workflow atiende la petición. No es una firma ni autenticación independiente. Revisa por separado el rol y la confianza de la rama elegida: una cadena coincidente no vuelve seguro ejecutar todos sus archivos con secretos.
El auxiliar organiza contexto, no lo valida todo
agent-iteration.ts tiene modos footer y prompt. El primero produce instrucciones visibles y marcador; el segundo lee memoria, obtiene PR y comentarios mediante GitHub CLI y los junta con el feedback. Incluye cuerpo y comentarios sin convertirlos en evidencia verificada.
La lectura de memoria devuelve cadena vacía si falta o no se puede leer, permitiendo continuar con un aviso de memoria vacía. Eso no demuestra carga de exclusiones permanentes. En ciclos importantes decide si una política necesaria ausente debe bloquear y mostrar diagnóstico.
Sigue efectos finales además del prompt
Las instrucciones generadas piden actualizar la rama, conservar feedback duradero y hacer commit y push. El workflow también tiene una ruta de iteración que incorpora todos los cambios al índice. Esa amplitud necesita revisión antes de adaptar el esqueleto a un repositorio con modificaciones ajenas.
Nuestro modelo comprueba una política sintética más estricta de límites de comando y capacidad. No ejecuta el auxiliar Bun, expresiones GitHub, Git ni comentarios reales. Pasarlo no demuestra seguridad de la plantilla ni iteración autenticada exitosa.
Cómo elegir
| Criterio | Opción A | Opción B |
|---|---|---|
| Best when | You need predictable behavior and easy auditing | You need adaptive optimization and have reliable telemetry |
| Main risk | May leave performance on the table | Can become difficult to explain or debug |
Pasos de implementación
- 1
Examina elegibilidad antes del marcador.
- 2
Separa confianza de rama y enrutamiento.
- 3
Decide qué hacer si falta memoria.
- 4
Revisa todas las rutas de staging y push.
Ejemplo para copiar
{
"inspeccion": true,
"propositoMarcador": "enrutamiento",
"marcadorEsFirma": false,
"falloMemoria": "el auxiliar upstream usa cadena vacía",
"comentariosCrudos": true,
"iteracionAutenticadaProbada": false
}Preguntas frecuentes
¿El marcador autentica el PR?
No. Es una convención de enrutamiento, no una firma.
¿Las pruebas ejecutaron iteración en GitHub?
No. Solo un modelo sintético sin red ni cambios Git.
Fuentes
- HumanLayer Skills / plugins/design-control-loop/skills/design-control-loop/references/workflow-template.ymlFuente verificada 2026-09-14
- HumanLayer Skills / plugins/design-control-loop/skills/design-control-loop/references/agent-iteration.tsFuente verificada 2026-09-14