CommunityPesquisa e Análise de Dadosgithub.com

2716224366/extreme-survival-requirements

Skill do Codex para gerar documentos de requisitos funcionais de Extreme Survival.

O que é extreme-survival-requirements?

Este skill, denominado '2716224366/extreme-survival-requirements', é uma ferramenta especializada para o Codex (ou outros agentes de IA) gerar documentos de requisitos funcionais robustos e detalhados para o jogo 《末日余生:极限生存》 (Extreme Survival: The Last Day). Seu principal objetivo é atender a dois públicos distintos simultaneamente: o desenvolvedor (Codex), que precisa de informações precisas e estruturadas para continuar a implementação em uma nova janela de trabalho, e o proprietário do projeto (humano), que necessita de uma descrição clara e em linguagem natural para revisão e aprovação. O skill impõe um padrão de qualidade não negociável, exigindo que cada funcionalidade central seja expandida com detalhes como IDs estáveis, fluxos principal e de exceção, campos de dados, regras, critérios de aceitação e, crucialmente, uma divisão explícita de implementação em duas versões: uma versão mestre (Game Studio/Phaser) e uma adaptação separada para o WeChat Mini Game. Ele também define uma estratégia de projeto central (manter duas bases de código separadas para iteração rápida no navegador e adaptação para WeChat) e estabelece convenções de nomenclatura de IDs de requisitos para garantir rastreabilidade entre documentos, código e testes. Além disso, o skill fornece um script Python útil para gerar automaticamente os pares de documentos (um para IA e outro para leitura humana), ajudando a manter a consistência e evitar a inclusão de termos de cronograma ou planejamento que são explicitamente proibidos.

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

Installed? Explore more Pesquisa e Análise de Dados skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Requisitos de Extreme Survival

Use este skill para produzir requisitos funcionais duráveis para 《末日余生:极限生存》. O resultado deve ajudar dois leitores:

  1. Leitor Codex / desenvolvedor: detalhes suficientes para continuar a implementação em uma nova janela.
  2. Leitor proprietário do projeto (humano): requisitos claros, em linguagem simples, fáceis de revisar e corrigir.

Este skill produz apenas requisitos funcionais. Não inclua cronogramas, semanas de desenvolvimento, datas, planos de sprint, previsões de lançamento, planos de pessoal ou estimativas de orçamento.

Padrão de qualidade não negociável

Não produza uma lista superficial de funcionalidades. Cada funcionalidade central deve ser expandida o suficiente para suportar implementação e revisão. Para requisitos voltados à IA, cada funcionalidade deve incluir:

  • ID de requisito estável.
  • Nome do módulo e da funcionalidade.
  • Explicação em uma linha voltada ao proprietário.
  • Propósito e história de usuário.
  • Pré-condições.
  • Fluxo principal.
  • Fluxos de ramificação/exceção.
  • Regras e limites.
  • Campos de estado/dados.
  • Campos de configuração.
  • Elementos de UI/feedback.
  • Tratamento de erros.
  • Divisão de implementação em versão dupla:
    • lógica compartilhada,
    • mestre Game Studio / Phaser,
    • adaptação WeChat Mini Game.
  • Critérios de aceitação.
  • Sugestões de teste.
  • Não-objetivos explícitos.
  • Perguntas em aberto.

Para requisitos amigáveis ao leitor, cada funcionalidade deve explicar:

  • O que a funcionalidade faz.
  • Como o jogador a utiliza.
  • Como é a operação normal.
  • O que pode falhar.
  • Quais regras devem ser seguidas.
  • O que o jogador vê.
  • O que conta como concluído.
  • O que está temporariamente excluído.
  • O que o proprietário do projeto deve confirmar.

Se o resultado parecer mais curto ou menos detalhado que o plano de desenvolvimento do projeto, enriqueça-o antes de entregar.

Estratégia central do projeto

Sempre preserve esta estratégia, a menos que o usuário a altere explicitamente:

  • Construa a jogabilidade primeiro em uma versão mestre do Game Studio + Phaser/TypeScript para navegador.
  • Converta ou migre funcionalidades estáveis para uma versão separada de adaptação para WeChat Mini Game.
  • Mantenha ambas as versões de código:
    • Game Studio / Phaser mestre: iteração rápida de jogabilidade, playtest no navegador, depuração, validação de funcionalidades.
    • Adaptação WeChat Mini Game: ponte de runtime WeChat, toque/ciclo de vida/recurso/login/adaptação, verificação em simulador e dispositivo real, publicação.
  • Não permita que o trabalho específico do runtime WeChat polua a lógica de jogabilidade independente de plataforma.

Saídas padrão

Quando o usuário pedir para gerar requisitos para este projeto, crie um ou ambos os seguintes arquivos:

  • ai-functional-requirements.md: voltado à implementação, preciso, estruturado e adequado para transferência ao Codex.
  • reader-functional-requirements.md: legível por humanos, em chinês simples, focado no que o jogador vê e no que o proprietário do projeto pode aprovar.

Se o usuário solicitar documentos Word, crie versões .docx a partir do mesmo conteúdo usando o skill de Documentos.

Fluxo de trabalho

  1. Inspecione primeiro os artefatos do projeto disponíveis:
    • PRD/documentos existentes em deliverables/;
    • código fonte atual do Game Studio/Phaser;
    • código fonte atual do WeChat Mini Game;
    • diários de problemas/soluções, se presentes.
  2. Extraia apenas requisitos funcionais e restrições do projeto. Ignore cronogramas e datas.
  3. Construa um inventário de funcionalidades antes de escrever prosa.
  4. Gere a especificação voltada à IA primeiro.
  5. Gere o documento amigável ao leitor a partir do mesmo inventário de requisitos.
  6. Valide o par:
    • sem linguagem de cronograma/linha do tempo;
    • ambos os documentos descrevem o mesmo conjunto de funcionalidades;
    • a estratégia de versão dupla é explícita;
    • cada funcionalidade central tem regras, fluxos, erros, dados/config, critérios de aceitação e perguntas em aberto;
    • perguntas em aberto são claramente marcadas em vez de adivinhadas.

Convenções de ID de requisito

Use IDs estáveis para que documentos, código, testes e issues posteriores possam referenciar a mesma funcionalidade:

  • ES-FR-META-*: limites do projeto e regras entre versões.
  • ES-FR-CORE-*: loop central, fluxo de partida, liquidação.
  • ES-FR-PLAYER-*: movimento do jogador, controles, interação, status, morte, reviver.
  • ES-FR-MAP-*: mapa, câmera, colisão, área segura, pontos de interesse.
  • ES-FR-ZOMBIE-*: spawn de inimigos/zumbis, IA, combate.
  • ES-FR-SURVIVAL-*: saúde, fome, sede, resistência, infecção.
  • ES-FR-ITEM-*: saque, inventário, pegar, soltar, usar.
  • ES-FR-CRAFT-*: crafting.
  • ES-FR-BUILD-*: construção e colocação.
  • ES-FR-COMBAT-*: armas, ataques, detecção de acerto, dano, feedback.
  • ES-FR-NET-*: matchmaking, salas, sincronização, reconexão.
  • ES-FR-WECHAT-*: login WeChat, ciclo de vida, recurso, anúncios, ranking, conformidade.
  • ES-FR-UI-*: HUD, menus, prompts, resultados.
  • ES-FR-DATA-*: salvamento, configuração, telemetria, registros de backend.
  • ES-NFR-*: requisitos não funcionais como desempenho, compatibilidade, segurança, manutenibilidade.

Script útil

Use scripts/generate_requirements.py para gerar o par detalhado em Markdown. Prefira executar a partir da raiz do projeto e passar --project-root . para que caminhos Windows não-ASCII não sejam distorcidos pela codificação do shell:

python extreme-survival-requirements/scripts/generate_requirements.py --project-root . --out-dir deliverables/requirements

O script inclui um guarda de termos de cronograma e falhará se detectar termos comuns de cronograma.

Não incluir

  • Ciclos de desenvolvimento, planos semanais, datas, previsões de lançamento ou estimativas de pessoal.
  • Garantias de receita ou garantias de aprovação de plataforma.
  • Cadeia de pensamento oculta, credenciais privadas, AppSecret, tokens ou identificadores pessoais.
  • Requisitos que contradizem a estratégia de versão dupla Game Studio → WeChat Mini Game, a menos que o usuário mude explicitamente de direção.

Habilidades Relacionadas