product

product

熱門

建立或精煉 PRODUCT.md,同時區分證據、願景、使用者、價值與非目標。觸發詞:「product」、「create PRODUCT.md」、「product boundary」。

430星標
40分支
更新於 2026/8/28
SKILL.md
唯讀
名稱
product
描述

建立或精煉 PRODUCT.md,同時區分證據、願景、使用者、價值與非目標。觸發詞:「product」、「create PRODUCT.md」、「product boundary」。

Product

以使用者的授權建立或精煉產品契約。

此契約之所以有效,是因為它迫使每一項宣稱都歸入證據或標示為願景;如果讀者無法分辨兩者,文件即失敗。

  1. 檢查現有的 product、README、goals、release 與證據來源。
  2. 僅詢問那些無法從這些來源安全推斷的決策。
  3. 陳述使命、使用者、痛點、價值、差異化與非目標。對於此儲存庫自身的產品表面,從 docs/contracts/ubiquitous-language.md 中的標準類別開始(AgentOps 是代理工程的營運層),並保持狹小的所有權邊界——絕不將 AgentOps 重新定義為執行編排器、工廠或迴圈。
  4. 在兩個必要標題下區分證據與期望。將每一項有根據的宣稱置於 ## Proven 之下,每一項都帶有可解析的引用(README、release、測試或證據來源)。將未經證實的期望、證據缺口與尚未衡量的成功信號置於 ## Assumptions 之下。無法引用來源的宣稱屬於 ## Assumptions,絕不屬於 ## Proven
  5. 除非使用者授權替換,否則保留現有的 PRODUCT.md
  6. 將文件回傳給呼叫者;Plan 可能將其用作意圖上下文。

具名的失敗模式——願景洗白:未經證實的期望被寫入 ## Proven 區段;一旦被洗白,每個下游計畫都會繼承錯誤的前提。偵測器:任何沒有可解析引用的 ## Proven 宣稱都是被洗白的願景——將其移至 ## Assumptions 或加上引用。

反模式:因為工作階段有新的意見,就將健康的 PRODUCT.md 整份重寫。修正方式:僅精煉使用者要求變更的區段,其餘部分逐位元組保留。

Product 不選擇工作、不呼叫迴圈、不自我修復、不自我驗證,也不選擇交付方式。