Codex Goal Writer
Crea un comando /goal para Codex, listo para pegar, que un hilo futuro de Codex pueda ejecutar sin depender de la memoria frágil de la conversación. No inicies la meta ni implementes el trabajo a menos que el usuario lo solicite explícitamente.
Contrato de Salida
Salida predeterminada:
Asuncionescon un máximo de 5 viñetas, solo si las asunciones son relevantes.Listo para copiarcon un bloque de código delimitado que contenga exactamente un comando/goal ....Notascon un máximo de 3 viñetas que expliquen decisiones de diseño clave o riesgos restantes.
Si el usuario solicita solo el comando, genera únicamente el bloque de código delimitado.
El prefijo del comando debe ser /goal. El cuerpo puede usar el idioma del usuario.
Restricciones Oficiales
- Trata el texto de
/goalcomo indicación inicial y criterio de finalización. - Mantén el objetivo no vacío y con menos de 4.000 caracteres.
- Para instrucciones largas, escribe o referencia un archivo markdown y mantén el
/goalcorto. - Si
/goalno está disponible, menciona habilitar[features].goals = trueocodex features enable goals. - No inventes banderas de barra no soportadas como
/goal --tokens. Si un presupuesto es útil, exprésalo como una condición textual de parada o pausa.
Flujo de Decisión
1. Plan Existente o Plan Markdown
Usa esta ruta cuando se mencione o sea obvio un plan, PRD, issue, cambio OpenSpec/OSpec, PLAN.md, GOAL.md, tasks.md o documento de implementación.
Reglas:
- Incluye la ruta exacta en el comando, preferiblemente relativa al repositorio.
- Indica a Codex que lea el plan primero y lo trate como fuente de verdad.
- Agrega una cláusula anti-olvido: vuelve a leer la ruta antes de continuar después de compactación de contexto, reanudación o incertidumbre.
- Incluye la porción solicitada si el usuario solo quiere parte del plan.
- Mantén las listas de tareas detalladas en el archivo, no en el texto de
/goal.
Forma:
/goal Ejecuta el plan de implementación en <ruta> como fuente de verdad. Léelo antes de cambiar archivos y vuelve a leerlo después de cualquier compactación de contexto, reanudación o incertidumbre. Completa <plan completo o porción>, preserva <restricciones>, verifica con <comprobaciones/evidencia>, y detente con un informe de bloqueo si <condiciones bloqueadas>.
2. Contexto de Conversación Útil
Usa esta ruta cuando los turnos anteriores definan la tarea.
Reglas:
- La última instrucción del usuario prevalece sobre el contexto anterior.
- Preserva las restricciones explícitas: solo lectura, sin ediciones, sin commits, archivos específicos, sin nuevas dependencias, pruebas requeridas, solo revisión, idioma o formato de salida.
- Incluye rutas de archivo exactas, comandos, IDs de issues, enlaces a PRs y rutas de artefactos cuando se conozcan.
- Ignora intenciones previas obsoletas que entren en conflicto con la última solicitud.
Forma:
/goal <último resultado previsto>, usando la conversación actual solo como antecedente. Alcance: <archivos/subsistemas>. Restricciones: <debe preservarse>. Hecho cuando: <criterios verificables>. Verifica mediante <comandos/evidencia>. Detente si <condiciones bloqueadas>.
3. Sin Contexto Útil
Usa esta ruta cuando el usuario pida una meta pero no haya proporcionado una tarea concreta.
Reglas:
- Realiza solo un descubrimiento ligero: directorio actual, nombre del repositorio,
README*,AGENTS.md,CONTEXT.md, documentos de plan obvios, manifiestos de paquetes y scripts de prueba. - No inventes dirección de producto.
- Genera un objetivo cerrado, pequeño y que priorice el descubrimiento.
- Prefiere "descubrir -> elegir un issue estrecho de alto valor -> corregir o documentar -> verificar" sobre "optimizar todo el proyecto."
- Si no hay repositorio o destino seguro, haz una pregunta concisa o genera un objetivo de descubrimiento independiente del repositorio.
Forma:
/goal En <ruta>, inspecciona el estado actual del proyecto, identifica el issue accionable u oportunidad de optimización de alto valor más pequeño que pueda verificarse localmente, completa una mejora conservadora de ciclo cerrado, preserva el trabajo no relacionado, verifica con las comprobaciones descubiertas relevantes, e informa evidencia y seguimientos restantes. Detente si no se encuentra un destino verificable seguro o falta el contexto requerido.
Anatomía de una Meta
Toda meta sólida debe contener estas ideas, usando etiquetas compactas:
- Objetivo: estado final concreto, no una actividad.
- Alcance: archivos, carpetas, subsistema, issue, ruta de plan o área de descubrimiento.
- Restricciones: qué no debe cambiar.
- Límites: escrituras permitidas, rutas prohibidas, servicios externos, datos de producción, credenciales u operaciones destructivas.
- Hecho cuando: criterios de aceptación medibles.
- Verificación: comandos, registros, artefactos, capturas de pantalla, umbrales de referencia, comprobaciones de CI o citas respaldadas por código fuente.
- Política de iteración: cómo reaccionar ante fallos, cuántas rondas de mejora enfocadas y cuándo volver a comprobar.
- Detener/Pausar si: bloqueadores concretos, requisitos contradictorios, credenciales faltantes, expansión de alcance insegura, entorno no disponible, verificación fallida repetida o decisiones humanas.
- Evidencia de salida: el resumen final debe incluir qué cambió, evidencia, comandos ejecutados, fallos, riesgo residual y próximos pasos.
Para metas solo de investigación, requiere mapeo de afirmación a evidencia, citas de archivos/URL, etiquetas de incertidumbre y sin ediciones de código a menos que se permita explícitamente.
Puertas de Calidad
Antes de mostrar el comando:
- Asegúrate de que una sesión nueva de Codex podría actuar sin contexto oculto.
- Asegúrate de que la última intención del usuario esté representada.
- Asegúrate de que las rutas de plan/doc estén incluidas cuando estén disponibles.
- Asegúrate de que la meta sea finita y auditable.
- Reemplaza términos vagos como "mejorar", "optimizar", "limpiar", "todo", "彻底", "everything" o "hacerlo bien" con criterios medibles, o indica la asunción.
- Usa comandos exactos cuando se conozcan; de lo contrario, di "descubre y ejecuta las comprobaciones documentadas relevantes del repositorio".
- No dejes marcadores de posición como
<ruta>,[TODO],TBDo待定en la salida final copiable. - No permitas permisos amplios como "editar cualquier cosa" a menos que el usuario lo haya solicitado explícitamente y el riesgo sea bajo.
- No declares éxito por agotamiento del presupuesto, tiempo invertido o ausencia de errores obvios.
Si la meta es débil, haz como máximo 3 preguntas específicas. Si los detalles faltantes son de bajo riesgo, asume y procede.
Referencias y Herramientas
- Lee
references/examples.mdcuando el caso sea ambiguo o el usuario quiera variantes. - Lee
references/source-patterns.mdal explicar la justificación del diseño o comparar prácticas. - Usa
scripts/lint_goal_command.pyal auditar un archivo de meta guardado o cuando puedas validar un comando redactado de forma económica.