2716224366/extreme-survival-requirements

Habilidad de Codex para generar documentos de requisitos funcionales de Extreme Survival.

¿Qué es extreme-survival-requirements?

Esta habilidad está diseñada para generar documentos de requisitos funcionales completos y duraderos para el juego «末日余生:极限生存» (Extreme Survival). Su propósito principal es servir a dos tipos de lectores: desarrolladores (Codex) que necesitan suficiente detalle para continuar la implementación en una sesión limpia, y dueños del proyecto humanos que requieren requisitos claros en lenguaje sencillo para revisión y corrección. La habilidad impone un estándar de calidad no negociable: cada funcionalidad principal debe expandirse con identificador estable, módulo, flujo principal, casos excepcionales, reglas, datos de configuración, UI/feedback, manejo de errores, y una estrategia explícita de implementación dual (Game Studio/Phaser para iteración rápida y WeChat Mini Game para adaptación). También genera pares de documentos: uno técnico para Codex (`ai-functional-requirements.md`) y otro legible para humanos (`reader-functional-requirements.md`). Incluye convenciones de nomenclatura de requisitos (como `ES-FR-*`) y un script de generación (`generate_requirements.py`) que produce los documentos en Markdown o DOCX. Está pensada para entornos de desarrollo de juegos multiplataforma donde la claridad, la trazabilidad y la separación entre lógica de juego y adaptación a plataforma son críticas.

Compatible con~Claude Code✓Codex CLI~Cursor
npx skills add 2716224366/extreme-survival-requirements

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

Requisitos de Extreme Survival

Usa esta habilidad para producir requisitos funcionales duraderos para «末日余生:极限生存». La salida debe ayudar a dos lectores:

  1. Lector Codex / desarrollador: suficiente detalle para continuar la implementación en una ventana nueva.
  2. 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

  1. 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.
  2. Extrae únicamente requisitos funcionales y restricciones del proyecto. Ignora cronogramas y fechas.
  3. Construye un inventario de funcionalidades antes de escribir prosa.
  4. Genera primero la especificación orientada a IA.
  5. Genera el documento legible por humanos a partir del mismo inventario de requisitos.
  6. 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.

Skills relacionados