frontend-to-backend-requirements

前端到後端需求 (frontend-to-backend-requirements) 技能作為前端實作與後端 API 設計之間的結構化橋樑。它專為需要溝通數據需求、UI 狀態和業務邏輯的前端開發人員所設計，無需過度干涉後端架構決策或實作細節。透過遵循引導式工作流程，開發者可以清楚表達特定畫面所需的數據、啟用的使用者操作，以及必須處理的邊緣案例，讓後端開發人員負責「如何實作」，而前端負責「需要什麼」。此技能有助於防止模糊不清，減少溝通摩擦，並建立一份需求文檔，供後端團隊用來提出穩健且高效的解決方案。

• 自動產生標準化的 Markdown 文檔，儲存於 .claude/docs/ai/<feature-name>/backend-requirements.md。

• 鼓勵職責分離，將 UI 狀態、使用者操作和數據需求與 API 端點設計或欄位結構分開。

• 包含專門的討論日誌 (Discussion Log) 部分，用於追蹤後端反饋、協商內容及後續決策。

• 強制執行「上下文優先」的文檔編寫方式，要求在請求數據之前先描述螢幕目標、使用者類型和預期工作流程。

• 提供用於提出不確定性和邊緣案例的模板，以邀請後端進行反饋並共同解決問題。

• 每當您需要釐清 API 需求、請求 UI 元件的新數據，或描述影響數據擷取的業務規則時，請使用此技能。

• 始終保持「請求」模式而非「要求」模式；樂於接受後端關於數據結構、效能或快取策略的建議。

• 輸出內容嚴格格式化以供文檔使用——不提供對話式輸出，確保專案倉庫中有清晰的技術產出物。

• 非常適合需要減少技術設計討論開銷，同時為前後端整合需求維護清晰真相來源的敏捷團隊。

• 透過分析當前功能上下文來確保需求具體、可執行，且不包含過早的實作假設，從而實現無縫運作。