Requisitos de Extreme Survival
Usa esta habilidad para producir requisitos funcionales duraderos para «末日余生:极限生存». La salida debe ayudar a dos lectores:
- Lector Codex / desarrollador: suficiente detalle para continuar la implementación en una ventana nueva.
- Lector dueño del proyecto humano: requisitos claros y en lenguaje sencillo, fáciles de revisar y corregir.
Esta habilidad produce únicamente requisitos funcionales. No incluyas cronogramas, semanas de desarrollo, fechas, planes de sprint, pronósticos de lanzamiento, planes de personal o estimaciones presupuestarias.
Estándar de calidad no negociable
No generes una lista superficial de funcionalidades. Cada funcionalidad principal debe expandirse lo suficiente para soportar la implementación y la revisión. Para requisitos orientados a IA, cada funcionalidad debe incluir:
- Identificador de requisito estable.
- Nombre del módulo y funcionalidad.
- Explicación en una línea para el dueño.
- Propósito e historia de usuario.
- Precondiciones.
- Flujo principal.
- Flujos alternativos / de excepción.
- Reglas y límites.
- Campos de estado/datos.
- Campos de configuración.
- Elementos de UI/feedback.
- Manejo de errores.
- División de implementación en versión dual:
- lógica compartida,
- maestro de Game Studio / Phaser,
- adaptación para WeChat Mini Game.
- Criterios de aceptación.
- Sugerencias de prueba.
- No-objetivos explícitos.
- Preguntas abiertas.
Para requisitos legibles por humanos, cada funcionalidad debe explicar:
- Qué hace la funcionalidad.
- Cómo la usa el jugador.
- Cómo se ve el funcionamiento normal.
- Qué puede fallar.
- Qué reglas deben seguirse.
- Qué ve el jugador.
- Qué cuenta como terminado.
- Qué se excluye temporalmente.
- Qué debe confirmar el dueño del proyecto.
Si la salida parece más corta o menos detallada que el plan de desarrollo del proyecto, enriquécelo antes de entregarlo.
Estrategia central del proyecto
Siempre preserva esta estrategia a menos que el usuario la cambie explícitamente:
- Primero construye la jugabilidad en una versión maestra de navegador con Game Studio + Phaser/TypeScript.
- Convierte o migra las funcionalidades estables a una versión adaptada separada para WeChat Mini Game.
- Mantén ambas versiones de código:
Game Studio / Phaser master: iteración rápida de jugabilidad, pruebas en navegador, depuración, validación de funcionalidades.WeChat Mini Game adaptation: puente de tiempo de ejecución de WeChat, toque/ciclo de vida/recursos/inicio de sesión/adaptación, verificación en simulador y dispositivo real, publicación.
- No permitas que el trabajo específico de runtime de WeChat contamine la lógica de jugabilidad independiente de la plataforma.
Salidas estándar
Cuando el usuario pida generar requisitos para este proyecto, crea uno o ambos de estos archivos:
ai-functional-requirements.md: orientado a la implementación, preciso, estructurado y adecuado para la transferencia a Codex.reader-functional-requirements.md: legible por humanos, en chino sencillo, centrado en lo que ve el jugador y lo que el dueño del proyecto puede aprobar.
Si el usuario solicita documentos de Word, crea versiones .docx a partir del mismo contenido usando la habilidad de Documentos.
Flujo de trabajo
- Primero inspecciona los artefactos del proyecto disponibles:
- PRD/documentos existentes en
deliverables/; - código fuente actual de Game Studio/Phaser;
- código fuente actual de WeChat Mini Game;
- diarios de problemas/soluciones si están presentes.
- PRD/documentos existentes en
- Extrae únicamente requisitos funcionales y restricciones del proyecto. Ignora cronogramas y fechas.
- Construye un inventario de funcionalidades antes de escribir prosa.
- Genera primero la especificación orientada a IA.
- Genera el documento legible por humanos a partir del mismo inventario de requisitos.
- Valida el par:
- sin lenguaje de cronograma/plazos;
- ambos documentos describen el mismo conjunto de funcionalidades;
- la estrategia de versión dual es explícita;
- cada funcionalidad principal tiene reglas, flujos, errores, datos/configuración, criterios de aceptación y preguntas abiertas;
- las preguntas abiertas están claramente marcadas en lugar de adivinadas.
Convenciones de identificadores de requisitos
Usa identificadores estables para que documentos, código, pruebas y problemas posteriores puedan referenciar la misma funcionalidad:
ES-FR-META-*: límites del proyecto y reglas entre versiones.ES-FR-CORE-*: bucle principal, flujo de partida, liquidación.ES-FR-PLAYER-*: movimiento del jugador, controles, interacción, estado, muerte, reaparición.ES-FR-MAP-*: mapa, cámara, colisión, zona segura, puntos de interés.ES-FR-ZOMBIE-*: generación de enemigos/zombis, IA, combate.ES-FR-SURVIVAL-*: salud, hambre, sed, resistencia, infección.ES-FR-ITEM-*: botín, inventario, recogida, soltar, usar.ES-FR-CRAFT-*: artesanía.ES-FR-BUILD-*: construcción y colocación.ES-FR-COMBAT-*: armas, ataques, detección de impacto, daño, retroalimentación.ES-FR-NET-*: emparejamiento, salas, sincronización, reconexión.ES-FR-WECHAT-*: inicio de sesión de WeChat, ciclo de vida, recursos, anuncios, clasificaciones, cumplimiento.ES-FR-UI-*: HUD, menús, avisos, resultados.ES-FR-DATA-*: guardado, configuración, telemetría, registros de backend.ES-NFR-*: requisitos no funcionales como rendimiento, compatibilidad, seguridad, mantenibilidad.
Script útil
Usa scripts/generate_requirements.py para generar el par detallado en Markdown. Prefiere ejecutarlo desde la raíz del proyecto y pasar --project-root . para que las rutas de Windows no ASCII no se dañen por la codificación del shell:
python extreme-survival-requirements/scripts/generate_requirements.py --project-root . --out-dir deliverables/requirements
El script incluye un guardia de términos de cronograma y fallará si detecta términos comunes similares a cronogramas.
No incluir
- Ciclos de desarrollo, planes semanales, fechas, pronósticos de lanzamiento o estimaciones de personal.
- Garantías de ingresos o garantías de aprobación de plataforma.
- Cadena de pensamiento oculta, credenciales privadas, AppSecret, tokens o identificadores personales.
- Requisitos que contradigan la estrategia de versión dual Game Studio → WeChat Mini Game a menos que el usuario cambie explícitamente de dirección.