shwndi/workbuddy-habilidades-tipo-codex

¿Qué hace workbuddy-habilidades-tipo-codex?

Habilidades ligeras para agentes de IA con autonomía tipo Codex y puertas de etapa de desarrollo de producto: preguntar en puntos de decisión reales, actuar de forma autónoma en trabajo de bajo riesgo y evitar saltarse los pasos de planificación, prototipo y aceptación.

Visión General

Esta habilidad define un conjunto de reglas para que los agentes de IA operen con un equilibrio entre autonomía y supervisión humana. El objetivo es permitir que el agente realice tareas de forma autónoma en áreas de bajo riesgo, mientras que solicita confirmación explícita en puntos de decisión clave del desarrollo de producto.

Puertas de Etapa

La habilidad organiza el flujo de trabajo en las siguientes etapas:

1. Planificación: El agente debe analizar los requisitos y proponer un plan antes de comenzar a implementar. Si el riesgo es bajo, puede proceder autónomamente; de lo contrario, debe preguntar.
2. Prototipo: El agente puede crear prototipos o borradores iniciales de forma autónoma, pero debe notificar al usuario para revisión antes de continuar.
3. Revisión: En esta etapa, el agente debe esperar confirmación humana antes de integrar cambios significativos o finalizar la implementación.
4. Aceptación: El agente debe solicitar aprobación del usuario antes de marcar una tarea como completada o desplegarla en producción.

Reglas de Comportamiento

• Preguntar en puntos de decisión: El agente debe detenerse y preguntar al usuario cuando encuentre decisiones que afecten la arquitectura, la interfaz de usuario, la seguridad o los costos.
• Actuar autónomamente en bajo riesgo: Tareas como refactorización de código menor, corrección de errores tipográficos, generación de documentación o pruebas unitarias pueden realizarse sin intervención humana.
• Evitar saltar etapas: El agente no debe avanzar a la siguiente etapa sin completar o obtener aprobación de la etapa actual.

Plataformas Soportadas

Esta habilidad está diseñada para funcionar con agentes de IA como:

• Claude Code
• Cursor
• Codex
• Otros agentes compatibles con SKILL.md

Cómo Usar

1. Agrega este archivo SKILL.md a la configuración de tu agente.
2. Define las tareas de alto y bajo riesgo según tu contexto.
3. El agente seguirá las reglas de puertas de etapa automáticamente.
4. Revisa los puntos de decisión y proporciona retroalimentación cuando el agente pregunte.

Notas Adicionales

• Esta habilidad no reemplaza la supervisión humana, sino que la complementa para mejorar la eficiencia.
• Los límites de riesgo se pueden ajustar según las preferencias del equipo.
• Se recomienda usar junto con habilidades de gestión de tareas y control de versiones.

Licencia

MIT