Community研究與資料分析github.com

2716224366/extreme-survival-requirements

為《末日餘生:極限生存》生成功能性需求文件的 Codex 技能。

extreme-survival-requirements 是什麼?

此 AI 技能旨在協助開發者為《末日餘生:極限生存》這款遊戲生成高品質的功能性需求文件。它明確區分了兩類讀者:代碼執行端(Codex/開發者)需要精確、結構化的規格說明,以便在全新的視窗中直接繼續實作;而人類專案擁有者則需要清晰、平實的語言來審查和確認需求。技能的核心策略是「雙版本開發」,首先在 Game Studio 搭配 Phaser/TypeScript 的主版本中疊代遊戲玩法,再將穩定的功能移植到獨立的微信小遊戲適配版本中,並嚴格禁止微信運行時邏輯污染平台無關的遊戲邏輯。技能支援在 Codex(如 Claude Code、Cursor)等平台使用,透過產出 `ai-functional-requirements.md` 和 `reader-functional-requirements.md` 兩份文件,以及內建的 Python 腳本自動化生成流程,確保需求涵蓋規則、流程、錯誤處理、驗收標準等所有關鍵要素。

相容平台~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 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

極限生存需求

使用此技能為《末日餘生:極限生存》產出持久可用的功能性需求。輸出內容必須能幫助兩類讀者:

  1. Codex / 開發者讀者:提供足夠的細節,使其能在全新的視窗中繼續實作。
  2. 人類專案擁有者讀者:提供清晰、平實語言的需求,便於審查與修正。

此技能僅產生功能性需求。請勿包含時程表、開發週數、日期、衝刺計畫、上線預測、人員配置或預算估算。

不可妥協的品質門檻

請勿產出單薄的功能列表。每個核心功能都必須擴展到足以支援實作與審查。對於面向 AI 的需求,每個功能應包含:

  • 穩定的需求 ID。
  • 模組與功能名稱。
  • 面向業主的一行說明。
  • 目的與用戶故事。
  • 前置條件。
  • 主要流程。
  • 分支/例外流程。
  • 規則與邊界。
  • 狀態/資料欄位。
  • 配置欄位。
  • UI/反饋元素。
  • 錯誤處理。
  • 雙版本實作拆分:
    • 共用邏輯,
    • Game Studio / Phaser 主版本,
    • 微信小遊戲適配。
  • 驗收標準。
  • 測試建議。
  • 明確的非目標。
  • 待定問題。

對於讀者友善的需求,每個功能應說明:

  • 該功能做什麼。
  • 玩家如何使用它。
  • 正常運作的情形。
  • 可能出錯的地方。
  • 必須遵守的規則。
  • 玩家看到的內容。
  • 什麼算是完成。
  • 暫時排除的事項。
  • 專案擁有者必須確認的事項。

如果輸出內容比專案開發計畫更短或更不詳細,請先充實內容再交付。

核心專案策略

除非用戶明確變更,否則請始終保留此策略:

  • 首先在 Game Studio + Phaser/TypeScript 瀏覽器主版本中建構遊戲玩法。
  • 將穩定的功能轉換或遷移到獨立的微信小遊戲適配版本中。
  • 維護兩個程式碼版本:
    • Game Studio / Phaser 主版本:快速遊戲玩法疊代、瀏覽器遊玩測試、除錯、功能驗證。
    • 微信小遊戲適配:微信運行時橋接、觸控/生命週期/資源/登入/適配、模擬器與真機驗證、發布。
  • 不要讓微信特有的運行時工作污染平台無關的遊戲邏輯。

標準輸出

當用戶要求為此專案生成需求時,請建立以下一個或兩個檔案:

  • ai-functional-requirements.md:面向實作、精確、結構化,適合 Codex 交接。
  • reader-functional-requirements.md:人類可讀、平實中文、聚焦於玩家看到的內容以及專案擁有者可以批准的內容。

如果用戶要求 Word 文件,請使用文件技能從相同內容建立 .docx 版本。

工作流程

  1. 首先檢視可用的專案成品:
    • deliverables/ 中的現有 PRD/文件;
    • 當前的 Game Studio/Phaser 原始碼;
    • 當前的微信小遊戲原始碼;
    • 問題/解決方案日誌(若存在)。
  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-*:微信登入、生命週期、資源、廣告、排行榜、合規。
  • ES-FR-UI-*:HUD、選單、提示、結果。
  • ES-FR-DATA-*:存檔、配置、遙測、後端記錄。
  • ES-NFR-*:非功能性需求,如效能、相容性、安全性、可維護性。

有用的腳本

使用 scripts/generate_requirements.py 腳本生成詳細的 Markdown 文件對。建議從專案根目錄執行,並傳入 --project-root . 參數,以避免非 ASCII 的 Windows 路徑因 shell 編碼而損毀:

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

該腳本包含時程用語防護機制,若偵測到常見的時程用語將會失敗。

請勿包含

  • 開發週期、週計畫、日期、上線預測或人員配置估算。
  • 營收保證或平台審核保證。
  • 隱藏的思考鏈、私人憑證、AppSecret、令牌或個人識別資訊。
  • 違反 Game Studio → 微信小遊戲雙版本策略的需求,除非用戶明確改變方向。

相關技能