product-capability

product-capability 技能總覽

product-capability 是一個從規劃走向規格的技能，適合把模糊的產品意圖轉成可直接落地實作的能力方案。當你已經知道功能目標，但團隊在開發前仍需要釐清限制、介面、生命週期規則、資料影響，以及尚未決定的事項時，它最有價值。

最適合的情境：PRD هنوز 太模糊

當 PRD、roadmap 項目、創辦人備忘錄，或產品討論串已經存在，但工程形狀仍然是隱性的，就很適合用 product-capability。它特別適合多服務協作、跨團隊依賴，或是審查者一直追問「在開始做之前，究竟要先滿足哪些條件？」這類功能。

它比一般提示詞多給你的價值

不同於泛用的「寫一份 spec」提示詞，product-capability 會把重點放在可長期維護的能力契約上。它能幫你把產品承諾和實作限制分開，先把未解問題攤開，而不是靠猜測補齊，並產出一個可以跨對話重複使用、而不是只留在聊天紀錄裡的成果物。

什麼時候值得安裝

如果你的團隊經常在 review 時，才反覆重新挖出那些藏在底下的假設，product-capability install 多半值得安裝。若你的工作大多是單檔、小風險，或已經有很完整的架構文件定義，那它的價值可能不如一個輕量提示詞來得高。

如何使用 product-capability 技能

在工作區安裝並載入

用以下指令安裝這個技能：

npx skills add affaan-m/everything-claude-code --skill product-capability

接著先打開 SKILL.md。若要使用 product-capability usage，也請一併查看 repo 預期承載的任何長效產品脈絡檔，尤其是 PRODUCT.md、docs/product/，或某個 program-spec 目錄。若這些都不存在，就使用技能參照的模板路徑。

把模糊需求轉成高品質輸入

這個技能在你提供的是「產品目標 + 背景脈絡」時效果最好，而不只是丟一個功能名稱。像「新增團隊共享」這種弱 brief，會留下太多空白；更強的寫法會是：「設計一份跨 web 與 API 的團隊共享能力方案，包含權限、稽核事件、邀請生命週期，以及工作區降級時會發生什麼事。」

用於需求規劃的建議工作流程

先寫出產品陳述，再要求能力邊界、不變條件、假設、未決問題，以及實作上的影響。最好的 product-capability guide 輸出，通常會描述在開始工作前必須成立的條件，而不只是列功能清單。若需求橫跨多個服務或團隊，請技能明確指出 ownership 與契約邊界。

先讀再延伸

這個 repo 刻意保持精簡，所以最值得先讀的是 SKILL.md。先用它理解規則集與目標產物，再依照你自己的 repo 調整結構，不要原封不動照抄範例。如果你的環境已經有標準的產品文件位置，就把輸出對齊那個路徑，避免另開一套平行的規劃文件。

product-capability 技能 FAQ

product-capability 只適用於 PRD 嗎？

不是。當真正的問題是要把意圖轉成可實作的契約時，product-capability 也很適合 roadmap 項目、討論紀錄，以及創辦人方向說明。關鍵條件是：你必須有足夠的產品訊號，能定義限制，而不是憑空補假設。

它和一般提示詞撰寫有什麼不同？

一般提示詞可能產出摘要或草案計畫；product-capability 的範圍更窄，它的目標是保留與工程相關的真實資訊，把未知項目明確標示出來，並產出可重複使用的成果物。當漏掉某個限制的代價很高時，這種方式通常更合適。

對初學者友善嗎？

可以，只要你說得出功能本身和它的背景脈絡。使用 product-capability 不需要架構專家程度，但你需要提供你手上最好的事實。如果關鍵輸入省略了，輸出還是需要人工審查。

什麼情況下不該用？

不要把 product-capability 用在瑣碎任務、單獨的 UI 微調，或已經有詳細 spec 管理的工作上。如果你要的是精緻的行銷文案或實作程式碼，而不是 Requirements Planning 材料，它也不是好選擇。

如何提升 product-capability 技能效果

先給它最重要的事實

品質提升最大的一步，是一開始就明確寫出使用者可見行為、系統邊界，以及已知限制。把資料流、存取規則、回滾預期、相依系統，以及任何會影響實作的政策或合規考量都寫進去。

把未知項目明講出來，不要只暗示

高品質的 product-capability 輸入，會把已確認需求和未決問題分開。如果團隊還沒決定某個動作是否同步、是否需要 audit logs，或哪個服務是 source of truth，就直接寫出來。這樣可以避免技能把不確定性抹平。

要求一份可直接做決策的成果物

如果第一版太寬泛，就請技能收斂範圍、列出不可妥協項，並標出會阻礙設計決策的取捨。這樣反覆迭代，通常比到處要求更多細節，更能改善 product-capability usage 的輸出品質。

重複使用同一套能力框架

如果是反覆出現的產品工作，請在每次對話中沿用相同的能力結構，讓審查者能一致比較各版方案。你的輸入越貼近團隊實際的運作模式，product-capability 技能產出的內容就越不是空泛的規劃文，而是有用的指引。