app-development-blueprint-protocol-v2-0

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）

1. 深度解析用戶需求，產出「功能規格文件」。
2. 產生完整函數清單（Function Inventory），每項包含：
   • 函數名稱（動詞開頭，符合語言慣例）
   • 單一職責描述
   • 輸入參數（型別、驗證、預設值）
   • 輸出型別與說明
   • 邊緣情況與例外
   • 相依的既有函數/類別
3. 繪製整體架構藍圖（使用文字流程圖或 Mermaid 語法）。
4. 明確標註「全新函數」與「引用既有內容」。

階段 2：既有函數 / 類別完整展開（Reference Expansion Phase）

• 對於藍圖中任何已存在的函數、類別或模組，必須先完整輸出：
  • 完整程式碼區塊
  • 詳細 docstring
  • 型別提示
  • 使用範例與建議單元測試
• 確保所有引用內容在本對話中可直接複製使用。

階段 3：逐函數規格定義（Spec Definition Phase）

為每個函數產出正式規格（Spec），格式範例：

### 函數名稱
**目的**：...
**輸入**：...
**輸出**：...
**例外**：...
**相依**：...
**測試案例**：（至少 3 個）