Extreme Survival Requirements
このスキルを使用して、『末日余生:极限生存』の堅牢な機能要件を作成します。出力は以下の2つの読者を対象とします。
- Codex / 開発者向け: 新しいウィンドウで実装を継続できる十分な詳細情報。
- 人間のプロジェクトオーナー向け: 明確で平易な言葉で要件を説明し、レビューと修正を容易にします。
このスキルは機能要件のみを作成します。スケジュール、開発週数、日付、スプリント計画、リリース予測、人員計画、予算見積もりは含めないでください。
譲れない品質基準
薄い機能リストを作成しないでください。各コア機能は実装とレビューをサポートできるように詳細化する必要があります。AI向け要件には、各機能に以下を含めてください。
- 安定した要件ID。
- モジュール名と機能名。
- オーナー向けの一行説明。
- 目的とユーザーストーリー。
- 事前条件。
- メインフロー。
- 分岐/例外フロー。
- ルールと境界。
- 状態/データフィールド。
- 設定フィールド。
- UI/フィードバック要素。
- エラーハンドリング。
- デュアルバージョン実装分割:
- 共通ロジック、
- Game Studio / Phaser マスター版、
- WeChat ミニゲーム適応版。
- 受入基準。
- テスト提案。
- 明示的な非目標。
- 未解決の質問。
読みやすさを重視した要件には、各機能で以下を説明してください。
- 機能の動作内容。
- プレイヤーの使用方法。
- 通常動作の様子。
- 失敗する可能性があること。
- 従わなければならないルール。
- プレイヤーに表示されるもの。
- 完了とみなされる条件。
- 一時的に除外されるもの。
- プロジェクトオーナーが確認する必要があること。
出力がプロジェクト開発計画より短い、または詳細でないと感じた場合は、納品前に充実させてください。
コアプロジェクト戦略
ユーザーが明示的に変更しない限り、この戦略を常に維持してください。
- 最初に Game Studio + Phaser/TypeScript ブラウザマスター版でゲームプレイを構築します。
- 安定した機能を別の WeChat ミニゲーム適応版に変換または移行します。
- 両方のコードバージョンを維持します:
Game Studio / Phaser マスター版: 高速なゲームプレイのイテレーション、ブラウザプレイテスト、デバッグ、機能検証。WeChat ミニゲーム適応版: WeChat ランタイムブリッジ、タッチ/ライフサイクル/リソース/ログイン/適応、シミュレータと実機検証、公開。
- WeChat 固有のランタイム作業でプラットフォーム非依存のゲームプレイロジックを汚染しないでください。
標準出力
ユーザーがこのプロジェクトの要件生成を依頼した場合、以下のファイルの一方または両方を作成してください。
ai-functional-requirements.md: 実装向け、正確、構造化され、Codex への引き継ぎに適しています。reader-functional-requirements.md: 人間向け、平易な中国語、プレイヤーが何を見るか、プロジェクトオーナーが何を承認できるかに焦点を当てます。
ユーザーが Word 文書を要求した場合は、Documents スキルを使用して同じ内容から .docx バージョンを作成してください。
ワークフロー
- まず既存のプロジェクトアーティファクトを確認します:
deliverables/内の既存の PRD/文書。- 現在の Game Studio/Phaser ソース。
- 現在の WeChat ミニゲームソース。
- 問題/解決策のジャーナル(存在する場合)。
- 機能要件とプロジェクト制約のみを抽出します。スケジュールと日付は無視します。
- 文章を作成する前に機能一覧を作成します。
- 最初に AI 向け仕様書を生成します。
- 同じ要件一覧から読みやすさを重視した文書を生成します。
- ペアを検証します:
- スケジュール/タイムラインの表現がないこと。
- 両方の文書が同じ機能セットを説明していること。
- デュアルバージョン戦略が明示されていること。
- すべてのコア機能にルール、フロー、エラー、データ/設定、受入基準、未解決の質問があること。
- 未解決の質問は推測ではなく明確にマークされていること。
要件 ID 規則
後続の文書、コード、テスト、課題が同じ機能を参照できるように、安定した ID を使用します。
ES-FR-META-*: プロジェクト境界とバージョン間のルール。ES-FR-CORE-*: コアループ、マッチフロー、決済。ES-FR-PLAYER-*: プレイヤーの移動、操作、インタラクション、状態、死亡、復活。ES-FR-MAP-*: マップ、カメラ、衝突、安全エリア、注目地点。ES-FR-ZOMBIE-*: 敵/ゾンビの出現、AI、戦闘。ES-FR-SURVIVAL-*: 体力、空腹、喉の渇き、スタミナ、感染。ES-FR-ITEM-*: 戦利品、インベントリ、拾得、ドロップ、使用。ES-FR-CRAFT-*: クラフト。ES-FR-BUILD-*: 建築と配置。ES-FR-COMBAT-*: 武器、攻撃、ヒット検出、ダメージ、フィードバック。ES-FR-NET-*: マッチメイキング、ルーム、同期、再接続。ES-FR-WECHAT-*: WeChat ログイン、ライフサイクル、リソース、広告、ランキング、コンプライアンス。ES-FR-UI-*: HUD、メニュー、プロンプト、結果。ES-FR-DATA-*: 保存、設定、テレメトリ、バックエンドレコード。ES-NFR-*: パフォーマンス、互換性、セキュリティ、保守性などの非機能要件。
便利なスクリプト
詳細な Markdown ペアを生成するには scripts/generate_requirements.py を使用します。プロジェクトルートから実行し、--project-root . を渡すことを推奨します。これにより、非 ASCII の Windows パスがシェルエンコーディングで壊れるのを防ぎます。
python extreme-survival-requirements/scripts/generate_requirements.py --project-root . --out-dir deliverables/requirements
このスクリプトにはスケジュール用語ガードが含まれており、一般的なスケジュール用語を検出すると失敗します。
含めないもの
- 開発サイクル、週次計画、日付、リリース予測、人員見積もり。
- 収益保証やプラットフォーム承認保証。
- 隠された思考連鎖、秘密の認証情報、AppSecret、トークン、個人識別子。
- ユーザーが明示的に方向を変更しない限り、デュアルバージョンの Game Studio → WeChat ミニゲーム戦略に矛盾する要件。