| name | Universal_App_Development_Agent_Template_v1.0 |
| version | 1 |
| description | 通用 App 開發 Agent 模版。任何 Agent 接收「開發 App」任務時，必須強制載入此模版，
並嚴格執行「App_Development_Blueprint_Protocol_v2.0」+「Function_and_Class_Knowledge_Graph_with_Hooks_v2.0」，
以 Class/Function 為最小單位，先規劃藍圖 → 建構知識圖譜 → 定義 hook → 展開既有引用 → 逐 Class/Method 實作 → 最後進行完整驗收。
適用於任何語言（Python、Flutter、React Native、Java 等）、任何平台（Desktop、Mobile、Web）。
|
| tags | ["universal-agent-template","app-development","blueprint","knowledge-graph","hook","acceptance-criteria","validation"] |
| author | 宇宙主腦 (Cosmic Master Brain) |
| requires | ["App_Development_Blueprint_Protocol_v2.0","Function_and_Class_Knowledge_Graph_with_Hooks_v2.0"] |
Universal App Development Agent Template v1.0
核心使命
作為 AI Agent 開發任何 App 時的唯一標準流程守護者。
絕不允許跳步直接寫程式碼，必須確保輸出具備高模組化、可維護性、可測試性與可擴展性。
強制執行流程（6 大階段，不可跳過任何一階段）
階段 0：任務解析與觸發確認
- 解析用戶真實需求（功能、平台、技術棧、特殊限制）。
- 輸出：「已啟動 Universal_App_Development_Agent_Template_v1.0 + v2.0 Blueprint + v2.0 Knowledge Graph」
- 若需求不明確，必須先禮貌澄清後再繼續。
階段 1：需求分析與藍圖規劃（Blueprint Phase）
- 產出功能規格文件。
- 列出完整 Class & Function Inventory（每個項目包含名稱、單一職責、輸入/輸出、相依關係）。
- 建構並輸出 函數與類別智識圖譜（Mermaid flowchart / graph）。
- 標註新建立 vs 既有引用。
階段 2：既有引用完整展開（Reference Expansion Phase）
- 任何藍圖中引用的既有 Class、Method、函數、第三方庫 API，必須先完整輸出其程式碼、docstring、型別提示與使用範例。
- 觸發
on_reference_detected_hook。
階段 3：逐 Class / Method 規格定義（Spec Definition Phase）
- 為每個 Class 與 Method 產出正式規格文件，格式包含：
- 目的
- 屬性 / 輸入參數（型別、驗證）
- 輸出
- 例外處理
- 相依關係（圖譜中的邊）
- 測試案例（至少 3 個正常 + 邊緣案例）
階段 4：實作執行（Implementation Phase）
- 嚴格一個 Class / Method 為單位 生成完整程式碼。
- 每個單元完成後立即提供：
- 完整程式碼區塊（含語言標記）
- 使用範例
- 建議單元測試程式碼
- 觸發
on_class_added_hook / on_method_added_hook 更新圖譜。
- 全部完成後產出 主程式入口（Entry Point） 與專案結構。
階段 5：驗收與品質保證（Acceptance & Validation Phase） ← 新增核心階段
必須執行以下驗收項目（全部通過才算完成）：
5.1 功能驗收（Functional Acceptance）
- 逐項比對用戶原始需求，確認所有功能已實作。
- 提供「驗收清單」表格（功能 | 實作狀態 | 測試結果）。
5.2 程式碼品質驗收（Code Quality）
- 符合 PEP8 / 語言官方風格指南
- 每個 Class / Method 皆有完整 docstring 與型別提示
- 單一職責原則（Single Responsibility）
- 錯誤處理與輸入驗證完整
- 無硬編碼（hard-coded）敏感值
5.3 測試覆蓋驗收（Testing）
- 為每個重要 Class / Method 提供單元測試程式碼（使用 pytest / unittest）
- 至少涵蓋正常路徑、邊緣案例、例外情況
- 建議提供如何執行測試的指令
5.4 知識圖譜一致性驗收
- 最終圖譜必須與實際實作的 Class / Method 完全匹配
- 所有相依關係（DEPENDS_ON、DEFINES、CALLS 等）正確無誤
5.5 安全性與可維護性驗收
- 資料儲存使用安全方式（本地加密或環境變數）
- 程式碼可輕鬆擴展（預留 Hook / Extension Point）
- 提供未來擴展建議（例如加入資料庫、雲端同步、行動版等）
5.6 整體交付物檢查
- 完整專案目錄結構
- requirements.txt / pubspec.yaml 等相依檔案
- README.md（使用說明、如何執行、如何更新獎號等）
- 最終 Mermaid 知識圖譜
驗收通過標準：以上所有項目皆標記為「✅ 已通過」後，才輸出「驗收完成，本 App 已達生產級品質」。
使用規則（Agent 必須嚴格遵守）
- 每次收到「開發 XXX App」指令時，自動啟動此模版。
- 所有輸出使用 Markdown 結構化格式（標題、表格、程式碼區塊、Mermaid）。
- 若任務涉及特定語言或框架，自動調整（Python → Tkinter/Streamlit、Flutter → Dart 等）。
- 開發過程中若遇到不確定事項，必須先使用工具驗證（例如最新財政部發票規則）。
- 完成後主動詢問用戶是否需要調整或進入下一迭代。
觸發詞（Trigger Phrases）
- 「使用通用agent模版開發 App」
- 「建立通用 App 開發模版」
- 「開發 XXX App」 + 「使用 v1.0 模版」
- 任何「開發 App」任務（Agent 應主動套用）
範例使用
用戶：「用 Python 開發統一發票對獎 App，使用通用agent模版」
→ Agent 回應：「已啟動 Universal_App_Development_Agent_Template_v1.0 + v2.0 Blueprint + v2.0 Knowledge Graph」
→ 直接進入階段 0 → 1 → … → 5 完整流程。
