極限生存需求
使用此技能為《末日餘生:極限生存》產出持久可用的功能性需求。輸出內容必須能幫助兩類讀者:
- Codex / 開發者讀者:提供足夠的細節,使其能在全新的視窗中繼續實作。
- 人類專案擁有者讀者:提供清晰、平實語言的需求,便於審查與修正。
此技能僅產生功能性需求。請勿包含時程表、開發週數、日期、衝刺計畫、上線預測、人員配置或預算估算。
不可妥協的品質門檻
請勿產出單薄的功能列表。每個核心功能都必須擴展到足以支援實作與審查。對於面向 AI 的需求,每個功能應包含:
- 穩定的需求 ID。
- 模組與功能名稱。
- 面向業主的一行說明。
- 目的與用戶故事。
- 前置條件。
- 主要流程。
- 分支/例外流程。
- 規則與邊界。
- 狀態/資料欄位。
- 配置欄位。
- UI/反饋元素。
- 錯誤處理。
- 雙版本實作拆分:
- 共用邏輯,
- Game Studio / Phaser 主版本,
- 微信小遊戲適配。
- 驗收標準。
- 測試建議。
- 明確的非目標。
- 待定問題。
對於讀者友善的需求,每個功能應說明:
- 該功能做什麼。
- 玩家如何使用它。
- 正常運作的情形。
- 可能出錯的地方。
- 必須遵守的規則。
- 玩家看到的內容。
- 什麼算是完成。
- 暫時排除的事項。
- 專案擁有者必須確認的事項。
如果輸出內容比專案開發計畫更短或更不詳細,請先充實內容再交付。
核心專案策略
除非用戶明確變更,否則請始終保留此策略:
- 首先在 Game Studio + Phaser/TypeScript 瀏覽器主版本中建構遊戲玩法。
- 將穩定的功能轉換或遷移到獨立的微信小遊戲適配版本中。
- 維護兩個程式碼版本:
Game Studio / Phaser 主版本:快速遊戲玩法疊代、瀏覽器遊玩測試、除錯、功能驗證。微信小遊戲適配:微信運行時橋接、觸控/生命週期/資源/登入/適配、模擬器與真機驗證、發布。
- 不要讓微信特有的運行時工作污染平台無關的遊戲邏輯。
標準輸出
當用戶要求為此專案生成需求時,請建立以下一個或兩個檔案:
ai-functional-requirements.md:面向實作、精確、結構化,適合 Codex 交接。reader-functional-requirements.md:人類可讀、平實中文、聚焦於玩家看到的內容以及專案擁有者可以批准的內容。
如果用戶要求 Word 文件,請使用文件技能從相同內容建立 .docx 版本。
工作流程
- 首先檢視可用的專案成品:
deliverables/中的現有 PRD/文件;- 當前的 Game Studio/Phaser 原始碼;
- 當前的微信小遊戲原始碼;
- 問題/解決方案日誌(若存在)。
- 僅萃取功能性需求與專案限制。忽略時程與日期。
- 在撰寫散文之前,先建立功能清單。
- 首先產生面向 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-*:微信登入、生命週期、資源、廣告、排行榜、合規。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 → 微信小遊戲雙版本策略的需求,除非用戶明確改變方向。