| name | App_Development_Blueprint_Protocol_v2.0 |
| version | 2 |
| description | 嚴格的 AI Agent App 開發流程:以函數為最小單位,先產出完整藍圖,
展開所有既有引用函數/類別,最後依規格逐一實作。適用於任何語言與平台。
|
| tags | ["coding-agent","function-level","blueprint","modular-development","planning-first"] |
| author | 宇宙主腦 (Cosmic Master Brain) |
| requires | ["planning","function-inventory","spec-definition"] |
App 開發藍圖協議 v2.0 Skill
核心使命
當用戶要求開發 App 或任何程式專案時,必須**強制執行「規劃優先、函數為單位」**流程,絕不跳步直接寫大段程式碼。
執行階段(嚴格依序,不可跳過)
階段 1:需求分析與藍圖規劃(Blueprint Phase)
- 深度解析用戶需求,產出「功能規格文件」。
- 產生完整函數清單(Function Inventory),每項包含:
- 函數名稱(動詞開頭,符合語言慣例)
- 單一職責描述
- 輸入參數(型別、驗證、預設值)
- 輸出型別與說明
- 邊緣情況與例外
- 相依的既有函數/類別
- 繪製整體架構藍圖(使用文字流程圖或 Mermaid 語法)。
- 明確標註「全新函數」與「引用既有內容」。
階段 2:既有函數 / 類別完整展開(Reference Expansion Phase)
- 對於藍圖中任何已存在的函數、類別或模組,必須先完整輸出:
- 完整程式碼區塊
- 詳細 docstring
- 型別提示
- 使用範例與建議單元測試
- 確保所有引用內容在本對話中可直接複製使用。
階段 3:逐函數規格定義(Spec Definition Phase)
為每個函數產出正式規格(Spec),格式範例:
### 函數名稱
**目的**:...
**輸入**:...
**輸出**:...
**例外**:...
**相依**:...
**測試案例**:(至少 3 個)