Jeremy-01/intake-first-planner

Skill de Codex para la captura de requisitos basada en esquemas antes de la planificación e implementación del solucionador.

¿Qué es intake-first-planner?

Este skill de Codex está diseñado para proyectos que no deben proceder a partir de parámetros adivinados, como planificadores de diseño físico, disposición de estaciones de trabajo o muebles, colocación de equipos, enrutamiento de cables, optimización de horarios/recursos, configuración de simulaciones y sistemas similares de resolución de restricciones. Asume que el usuario puede ser un completo principiante: explica qué información se necesita en lenguaje sencillo, proporciona YAML editable y evita que el usuario tenga que entender detalles de implementación. La regla central es no resolver, optimizar, recomendar o construir lógica de dominio hasta que los hechos y escenarios requeridos sean lo suficientemente explícitos como para evitar suposiciones. Si faltan datos críticos, genera una respuesta de captura de "Parámetros Faltantes" y se detiene antes de la implementación. El flujo de trabajo clasifica la solicitud (solo captura, construir después de captura, o creación del skill), lee las referencias correspondientes, produce una fuente de hechos estructurada (YAML/JSON), y solo ejecuta la implementación si todos los hechos requeridos están completos. Para proyectos Python, prefiere comandos `uv` e incluye comandos de recuperación `venv + pip`. El skill genera proyectos con estructura estándar (`pyproject.toml`, `src/`, `tests/`, etc.), informes visuales (SVG/HTML y visor 3D Three.js), y pruebas deterministas. Incluye assets reutilizables como plantillas de esquemas YAML, guías de referencia y ejemplos de dominio.

Compatible con✓Claude Code✓Codex CLI~Cursor
npx skills add Jeremy-01/intake-first-planner

Installed? Explore more Investigación y análisis de datos skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

Preguntar en tu IA favorita

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

Documentación

Planificador de Captura-Primero

Usa este skill para proyectos que no deben proceder a partir de parámetros adivinados: planificadores de diseño físico, herramientas de disposición de estaciones de trabajo o muebles, colocación de equipos, enrutamiento de cables, optimización de horarios/recursos, configuración de simulaciones y sistemas similares de resolución de restricciones. Asume que el usuario puede ser un completo principiante: explica qué información se necesita en lenguaje sencillo, proporciona YAML editable y evita que el usuario tenga que entender detalles de implementación.

Regla Central

No resuelvas, optimices, recomiendes ni construyas lógica específica del dominio hasta que los hechos y escenarios requeridos sean lo suficientemente explícitos como para que las suposiciones sean innecesarias. Si faltan datos críticos, genera una respuesta de captura de "Parámetros Faltantes" y detente antes de la implementación.

Flujo de Trabajo

  1. Clasifica la solicitud:
    • Solo captura: el usuario quiere requisitos, esquema o limpieza del prompt.
    • Construir después de captura: el usuario quiere código, pruebas, informes o un proyecto reutilizable.
    • Creación del skill: el usuario quiere un skill o paquete de prompt reutilizable/de código abierto.
  2. Selecciona la referencia relevante:
    • Flujo de trabajo general reutilizable: lee references/intake-workflow.md.
    • Planificadores espaciales/de diseño: lee references/spatial-layout-domain.md.
    • Informes Three.js o salida 3D/visual: lee references/threejs-visualization.md.
    • Convertir un prompt único en un skill reutilizable: lee references/prompt-to-skill.md.
    • Empaquetado del skill/conversión a código abierto: lee references/skill-packaging.md.
  3. Produce o actualiza una fuente de hechos estructurada, generalmente YAML o JSON.
  4. Controla la ejecución:
    • Si faltan hechos requeridos, devuelve solo la lista de verificación de parámetros faltantes, un fragmento de esquema sugerido, los escenarios requeridos y las no-suposiciones explícitas.
    • Si los hechos están completos, implementa el proyecto usando la fuente de hechos como entrada autorizada.
  5. Para proyectos Python, prefiere comandos uv. Incluye siempre comandos de recuperación venv + pip en los documentos de entrega/recuperación.
  6. No leas JSONL de sesiones antiguas, registros de chat o conversaciones previas a menos que el usuario solicite explícitamente la recuperación del historial.

Patrones de Salida

Para entrada faltante, usa esta forma:

Necesito algunas medidas concretas antes de poder resolver esto de forma segura. Puedes responder completando el YAML a continuación; los valores desconocidos pueden permanecer como `null`.

**Parámetros Faltantes**
- ...

**YAML Sugerido**
```yaml
...
```

**Escenarios a Confirmar**
- ...

**No Asumido**
- ...

Para la implementación, crea un proyecto con:

  • pyproject.toml, src/, tests/, examples/, reports/, outputs/
  • Un ejemplo de configuración estructurada como la única fuente de hechos
  • Informes visuales con SVG/HTML de vista superior y un visor HTML Three.js 3D cuando haya geometría o diseño involucrado
  • Pruebas deterministas para análisis, transformaciones, restricciones, puntuación y al menos una regresión de escenario
  • HANDOFF.md, RECOVERY_README.md y PROJECT_CONTEXT.md con comandos tanto de uv como de venv + pip

Assets Reutilizables

  • schemas/intake_project.schema.yaml: plantilla de esquema genérica.
  • schemas/spatial_layout.schema.yaml: plantilla de esquema espacial/de diseño.
  • references/threejs-visualization.md: guía de visualización 3D predeterminada.
  • examples/workstation_layout_request.yaml: ejemplo de solicitud de dominio.
  • examples/furniture_layout_request.yaml: ejemplo de planificación de habitaciones/muebles.
  • examples/equipment_cable_routing_request.yaml: ejemplo de colocación de equipos y enrutamiento de cables.
  • scripts/check_skill_package.py: verificador ligero de paquetes.

Skills relacionados