Community研究&データ分析github.com

2716224366/extreme-survival-requirements

『末日余生:极限生存』の機能要件ドキュメントを生成するためのCodexスキル

extreme-survival-requirements とは?

このスキルは、『末日余生:极限生存』プロジェクト向けの高品質な機能要件ドキュメントを生成するために設計されています。Codexや開発者が実装を継続できる十分な詳細さと、プロジェクトオーナーがレビュー・修正しやすい平易な中国語の説明の両方を提供します。スケジュールや開発計画は含まず、純粋な機能要件のみに焦点を当てます。各機能要件には安定したID、モジュール名、ユーザーストーリー、事前条件、メインフロー、例外フロー、ルール、データ構成、エラー処理、デュアルバージョン実装戦略(Game Studio/Phaserマスター版とWeChatミニゲーム適応版)などが網羅され、AIと人間の両方の読者に対応します。また、要件の品質バーとして、薄い機能リストではなく、各コア機能を実装とレビューが可能なレベルまで詳細化することを要求します。

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

Installed? Explore more 研究&データ分析 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Extreme Survival Requirements

このスキルを使用して、『末日余生:极限生存』の堅牢な機能要件を作成します。出力は以下の2つの読者を対象とします。

  1. Codex / 開発者向け: 新しいウィンドウで実装を継続できる十分な詳細情報。
  2. 人間のプロジェクトオーナー向け: 明確で平易な言葉で要件を説明し、レビューと修正を容易にします。

このスキルは機能要件のみを作成します。スケジュール、開発週数、日付、スプリント計画、リリース予測、人員計画、予算見積もりは含めないでください。

譲れない品質基準

薄い機能リストを作成しないでください。各コア機能は実装とレビューをサポートできるように詳細化する必要があります。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 バージョンを作成してください。

ワークフロー

  1. まず既存のプロジェクトアーティファクトを確認します:
    • deliverables/ 内の既存の PRD/文書。
    • 現在の Game Studio/Phaser ソース。
    • 現在の WeChat ミニゲームソース。
    • 問題/解決策のジャーナル(存在する場合)。
  2. 機能要件とプロジェクト制約のみを抽出します。スケジュールと日付は無視します。
  3. 文章を作成する前に機能一覧を作成します。
  4. 最初に AI 向け仕様書を生成します。
  5. 同じ要件一覧から読みやすさを重視した文書を生成します。
  6. ペアを検証します:
    • スケジュール/タイムラインの表現がないこと。
    • 両方の文書が同じ機能セットを説明していること。
    • デュアルバージョン戦略が明示されていること。
    • すべてのコア機能にルール、フロー、エラー、データ/設定、受入基準、未解決の質問があること。
    • 未解決の質問は推測ではなく明確にマークされていること。

要件 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 ミニゲーム戦略に矛盾する要件。

関連スキル