產品能力規劃

產品能力規劃 是做什麼的？

這個技能將產品意圖轉化為明確的工程約束。

請在下列情況使用：問題不在於「我們該建什麼？」而在於「開始實作前，究竟必須確定什麼？」

何時使用

• 已有 PRD、路線圖項目、討論或創辦人筆記，但實作約束仍然隱含未明
• 某功能跨越服務、儲存庫或團隊，需要在編寫程式碼前先建立能力合約
• 產品意圖明確，但架構、資料、生命週期或政策影響仍模糊不清
• 資深工程師在審查時持續重複相同的隱含假設
• 你需要一個可重複使用的產出物，能夠跨越不同環境與工作階段

標準產出物

如果儲存庫已有永久的產品背景檔案（如 PRODUCT.md、docs/product/ 或程式規格目錄），請直接更新該處。

如果尚未存在任何能力說明檔案，請使用以下範本建立一份：

• docs/examples/product-capability-template.md

目標不是增加另一層規劃堆疊，而是讓隱含的能力約束變得可持續、可重用。

不可妥協的規則

• 不要發明產品真相。請明確標記未解決的問題。
• 區分使用者可見的承諾與實作細節。
• 明確指出哪些是固定政策、哪些是架構偏好、哪些仍待決定。
• 如果需求與現有儲存庫約束衝突，請清楚說明，而非粉飾太平。
• 偏好一份可重複使用的能力產出物，勝過零散的備忘錄。

輸入資料

僅讀取必要的資訊：

1. 產品意圖
   • 議題、討論、PRD、路線圖筆記、創辦人訊息
2. 當前架構
   • 相關儲存庫文件、合約、結構定義、路由、現有工作流程
3. 現有能力背景
   • PRODUCT.md、設計文件、RFC、遷移筆記、運作模型文件
4. 交付限制
   • 驗證、計費、合規、上線、向後相容、效能、審查政策

核心工作流程

1. 重申能力

將需求壓縮成一句精確的描述：

• 使用者或操作者是誰
• 此功能上線後，什麼新能力會存在
• 因為這個能力，什麼結果會改變

如果這句描述很薄弱，實作就會偏離方向。

2. 解析能力約束

提取在實作前必須成立的約束：

• 業務規則
• 範圍邊界
• 不變量
• 信任邊界
• 資料所有權
• 生命週期轉換
• 上線/遷移需求
• 失敗與復原期望

這些往往是只存在於資深工程師記憶中的東西。

3. 定義實作面向的合約

產出一個 SRS 風格的能力計劃，包含：

• 能力摘要
• 明確的非目標
• 參與者與接觸面
• 必要狀態與轉換
• 介面/輸入/輸出
• 資料模型影響
• 安全性/計費/政策約束
• 可觀測性與運維需求
• 阻擋實作的未決問題

4. 轉化為執行

最後給出精確的交接指示：

• 可直接實作
• 需要先進行架構審查
• 需要先釐清產品需求

若有幫助，可指向下一個 ECC 原生工作流：

• project-flow-ops
• workspace-surface-audit
• api-connector-builder
• dashboard-builder
• tdd-workflow
• verification-loop

輸出格式

請按以下順序回傳結果：

能力
- 一段話的重申

約束
- 固定規則、不變量與邊界

實化合約
- 參與者
- 接觸面
- 狀態與轉換
- 介面/資料影響

非目標
- 此工作流明確不負責的項目

未決問題
- 阻擋實作的障礙或仍需做出的產品決策

交接
- 接下來應發生什麼，以及應由哪個 ECC 工作流接手

理想的成果

• 產品意圖已具體到無需在 PR 進行到一半時重新發現隱含約束即可實作。
• 工程審查擁有可持續使用的產出物，而非依賴記憶或 Slack 背景資訊。
• 產出的計劃可在 Claude Code、Codex、Cursor、OpenCode 與 ECC 2.0 規劃介面中重複使用。