Communitygithub.com

2023Anita/harness-interview-workflow

Una habilidad de Codex que convierte tareas vagas en escaneos de puntos ciegos, preguntas de entrevista, opciones de ruta y ejecución controlada por aprobación.

¿Qué es harness-interview-workflow?

Esta habilidad para Codex está diseñada para ralentizar el agente antes de realizar trabajo costoso, transformando solicitudes vagas o complejas en un proceso estructurado de entrevista. Su utilidad principal es descubrir incógnitas, hacer solo las preguntas de mayor impacto, proponer múltiples rutas de acción y esperar aprobación explícita antes de ejecutar cualquier paso. Soporta plataformas como Claude Code, Cursor y Codex, y su funcionamiento se basa en un contrato operativo claro que incluye un escaneo de puntos ciegos (clasificando incógnitas conocidas, desconocidas conocidas, etc.), un modo de entrevista que prioriza preguntas que cambian la arquitectura o el riesgo, manejo de referencias (repos, código, capturas) con clasificación explícita, propuesta de rutas (mínimo viable, completo, extendido) y ejecución solo tras confirmación del usuario. También mantiene notas de implementación para desviaciones y casos límite, y genera artefactos de workflow reutilizables cuando es necesario. Es ideal para proyectos donde se necesita claridad, gestión de riesgos y control de calidad antes de invertir recursos.

Compatible con~Claude Code✓Codex CLI~Cursor
npx skills add 2023Anita/harness-interview-workflow

Preguntar en tu IA favorita

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

Documentación

Harness Interview Workflow

Resumen

Usa esta habilidad para ralentizar a Codex antes de trabajo costoso. La habilidad convierte una solicitud vaga o compleja en una entrevista estructurada: descubre incógnitas, pregunta solo las preguntas de mayor apalancamiento, propone rutas y espera aprobación explícita antes de ejecutar.

Contrato Operativo

  1. Reexpresar el objetivo del usuario y el entregable probable.
  2. Hacer un escaneo de puntos ciegos antes de proponer ejecución.
  3. Hacer como máximo 1-3 preguntas por ronda.
  4. Priorizar preguntas cuyas respuestas cambien la arquitectura, el riesgo, la forma del entregable o la verificación.
  5. Dar 2-3 opciones de ruta cuando haya suficiente contexto.
  6. Detenerse después del plan si el usuario pidió un plan o no ha aprobado la ejecución.
  7. Si el usuario confirma la ejecución, crear un plan de implementación normal y usar compuertas de aprobación para acciones riesgosas.
  8. Mantener notas de implementación cuando la ejecución descubra casos límite o desviaciones.

Escaneo de Puntos Ciegos

Clasificar la solicitud en cuatro tipos de incógnitas:

Conocidos conocidos:
Conocidos desconocidos:
Desconocidos conocidos:
Desconocidos desconocidos:
El mayor riesgo de malentendido:
El siguiente movimiento más pequeño:

Usar chino sencillo por defecto al trabajar con Anita a menos que el usuario pida otro idioma.

Modo de Entrevista

Hacer solo las siguientes 1-3 preguntas. Preferir este orden:

  1. ¿Qué respuesta cambiaría la arquitectura o la ruta principal?
  2. ¿Qué respuesta cambiaría los límites de riesgo o los requisitos de aprobación?
  3. ¿Qué respuesta cambiaría el formato del artefacto final?
  4. ¿Qué respuesta cambiaría los criterios de verificación o aceptación?
  5. ¿Qué respuesta solo afecta el estilo?

Evitar formularios largos. Si una pregunta es opcional, continuar con una suposición conservadora y etiquetarla.

Manejo de Referencias

Cuando el usuario proporcione un artículo, repositorio, captura de pantalla, código, proyecto antiguo, plantilla o ejemplo, clasificar la referencia antes de usarla:

  • debe reutilizar: preservar estructura, semántica, nombres o contenido.
  • referencia de estilo: tomar inspiración o patrón, no copiar.
  • no imitar: usar solo para entender restricciones.
  • fuente de hechos: citar o preservar la procedencia factual donde sea necesario.

Si la clasificación no es clara, hacer una pregunta breve de aclaración.

Propuesta de Rutas

Después de suficiente contexto, proporcionar opciones como:

Plan A: Versión Mínima Viable
Adecuado para:
Hará:
No hará:
Riesgo:
Verificación:

Plan B: Versión Completa y Estable
Adecuado para:
Hará:
No hará:
Riesgo:
Verificación:

Plan C: Versión Extendida de Alta Calidad (opcional)
Adecuado para:
Hará:
No hará:
Riesgo:
Verificación:

Recomendación:
Esperando confirmación del usuario:

No ejecutar hasta que el usuario elija una ruta o diga una confirmación clara como confirmar ejecución, continuar, o ejecutar según recomendación.

Ejecución Tras Aprobación

Cuando el usuario confirme la ejecución, usar esta forma de plan:

Objetivo:
Criterios de éxito:
Contexto actual:
Restricciones:
Riesgos:
Aprobación requerida:
Ruta del artefacto del flujo de trabajo:
Paquetes de trabajo:
Política de integración:
Verificación:
Artefactos reutilizables:

Para trabajo complejo o reutilizable, crear un artefacto de flujo de trabajo:

.workflow/<slug>/
|-- plan.md
|-- state.json
|-- orchestration.md
|-- packets/
|-- results/
`-- final-report.md

Si codex-dynamic-workflows está disponible y el trabajo es amplio, usarlo junto con esta habilidad.

Notas de Implementación

Para tareas de ejecución, mantener notas en la ubicación natural de la tarea, usualmente implementation-notes.md o .workflow/<slug>/results/implementation-notes.md:

# Notas de Implementación

## Plan Original
## Decisiones
## Desviaciones
## Casos Límite
## Confirmaciones del Usuario
## Verificación
## Seguimiento

Cuando un caso límite fuerce una desviación, elegir un camino conservador, registrar por qué, y continuar solo si permanece dentro del límite de aprobación del usuario.

Respuesta Final

Para trabajo solo de plan, devolver:

  • resumen del escaneo de puntos ciegos
  • preguntas realizadas o suposiciones hechas
  • opciones de ruta
  • ruta recomendada
  • pregunta clara de aprobación

Para trabajo ejecutado, devolver:

  • artefactos completados y rutas
  • evidencia de verificación
  • comprobaciones omitidas
  • riesgos restantes
  • cómo reutilizar el flujo de trabajo

Para cambios complejos, agregar un pequeño cuestionario posterior a la acción para que el usuario pueda confirmar que entiende lo que cambió.

Skills relacionados