HumanLayer Skills: conservar instrucciones y diseñar ciclos revisables
Desplegar un ciclo HumanLayer: sustituye marcadores antes de habilitar CI
Separa instalación de habilidad e implementación del ciclo y usa los requisitos reales de workflow_dispatch en GitHub.
Qué aprenderás
- La habilidad y el sistema generado son cosas distintas
- Valida localmente antes de programar
- Usa el requisito documentado para ejecución manual
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
- Instalar instrucciones no implementa los componentes.
- El esqueleto contiene supuestos y TODOs.
- La ejecución manual depende de configuración y acceso en la rama predeterminada.
La habilidad y el sistema generado son cosas distintas
El README ofrece un comando de instalación, pero obtener instrucciones no implementa sensor ni controlador. design-control-loop exige diseño escrito, componentes locales, habilidad actuadora, memoria y workflow recurrente, todos adaptados a herramientas y permisos reales.
El esqueleto supone Bun/Node y contiene slugs, prefijos de ramas, prompts pendientes y comandos TODO para sensor y controlador. Incluye agentes de ejemplo. Son entradas por sustituir, no recomendaciones de versiones o modelos actuales para cualquier repositorio.
Valida localmente antes de programar
Haz ejecutables medición y selección por separado con entradas desechables. Revisa archivos modificables, validaciones previas al commit y extracción de la respuesta para el PR. Un esqueleto existente no demuestra que scripts, memoria y archivos de salida ya estén creados.
Comprueba la rama predeterminada en vez de conservar origin/main automáticamente. Decide permisos, secretos, versiones de acciones e instalación de dependencias. Mantén apagada la recurrencia hasta obtener un resultado limitado revisado. No desplegamos la plantilla ni guardamos credenciales.
Usa el requisito documentado para ejecución manual
La habilidad propone un primer disparo push para ensayo y describe ejecución previa como requisito. La página oficial GitHub exige workflow_dispatch en un workflow de la rama predeterminada y acceso de escritura. No repitas “debe haber corrido una vez” como regla general.
Un disparador push temporal puede crear trabajo externo y consumir credenciales; no lo añadas solo para resolver dudas sobre dispatch. Sigue la configuración soportada y revisa una ejecución manual antes de elegir frecuencia. Instalación, CI, PR revisado y recurrencia son hitos separados.
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
Escribe diseño y alcance aprobado.
- 2
Implementa sensor y controlador localmente.
- 3
Sustituye rutas y supuestos de la plantilla.
- 4
Revisa una ejecución manual antes del calendario.
Ejemplo para copiar
{
"plan": true,
"sensorImplementado": false,
"controladorImplementado": false,
"marcadoresPendientes": true,
"ejecucionManualRevisada": false,
"calendarioActivado": false
}Preguntas frecuentes
¿Puedo copiar y confiar inmediatamente en la plantilla?
No. Los marcadores y componentes TODO requieren implementación y validación.
¿Siempre necesita una ejecución previa para dispatch?
No es el requisito general documentado por GitHub; consulta rama predeterminada y workflow_dispatch.
Fuentes
- HumanLayer Skills / README.mdFuente verificada 2026-09-14
- HumanLayer Skills / plugins/design-control-loop/skills/design-control-loop/SKILL.mdFuente verificada 2026-09-14
- HumanLayer Skills / plugins/design-control-loop/skills/design-control-loop/references/workflow-template.ymlFuente verificada 2026-09-14
- GitHub — Manually running a workflow (checked 2026-09-14)Fuente verificada 2026-09-14