功能規格摘要 (brief) 是做什麼的?
功能:$ARGUMENTS
先奠基(靜默執行)
- 讀取此儲存庫的 CLAUDE.md 及此專案的記憶條目。瀏覽該功能涉及的 routes、schema 及 email 模板。規格中會引用真實的檔案路徑與現有欄位。
- 僅當某項決定會改變範圍時才進行提問。使用 AskUserQuestion 一次問一個問題,並附上建議選項,最多問 3 個問題。其餘事項皆視為假設,列在「未解決問題」中。
範圍的基本規則
- MVP 指的是使用現有欄位和元件建構的傳統最小可行產品。「像任何電子商務平台」代表標準流程,而非特定平台。
- 絕不新增未要求的功能、元件、設定、管理後台或分析工具。將它們列在「非目標」中。
- 合作夥伴或 API 功能:通常「API 金鑰」代表環境變數中的租戶 ID,而不是開發者入口網站。
- 尊重 CLAUDE.md/記憶中的專案限制(例如「不修改 schema」)。標記任何會違反限制的事項。
模板
# <功能名稱>:功能規格摘要
**問題:** 一到兩句話,描述使用者的痛點,而非解決方案。
**目標受眾:** 誰,以及數量(如果已知,請引用查詢或來源)。
**MVP:** 3-6 個要點,每個都可交付並可觀察。
**非目標:** 我們明確不在此次實作的事項。
**驗收標準**
1. Given <狀態>, When <動作>, Then <可觀察結果>。
2. ...(每個都可透過 flow-check、smoke 或 unit test 測試)
**影響範圍:** 路由 · 資料表/欄位(優先使用現有的) · 電子郵件 · 環境變數/機密 · 第三方
**風險:** 金錢、法律/GDPR、送達率、SEO(noindex/canonical)、i18n
**未解決問題:** 編號問題;每個問題附上我的預設答案(若無回應)
輸出
- 預設輸出於對話中。僅在要求時才寫入
docs/briefs/<slug>.md。 - 以一句話開頭(「簡要說明如下:N 個驗收標準,M 個未解決問題」),接著是規格內容。之後不應有其他內容。
退出條件
- 每個驗收標準都可觀察,並對應到一種檢查方式(flow-check 步驟、smoke 預期結果或測試)。
- MVP 中未包含未要求或非嚴格必要的事項。
- 每個未解決問題都有預設答案,以便在等待回覆時即可開始開發。