Communitygithub.com

andydrewie/quantitative-grounding

為 Codex 賦予更精確的規模直覺——一個明確啟動的技能,用於誠實的數字、清晰的未知性,以及杜絕虛假精度。

quantitative-grounding 是什麼?

這是一個名為「QG-01 - 定量基礎」的 AI 代理技能,其核心目標是協助使用者將定性的主張轉化為有助於決策的定量結構。此技能特別適用於軟體開發、商業分析與策略決策等領域,能幫助使用者回答關於規模、比較、可能性、時間範圍、成本與分佈等關鍵問題。它支援在類似 Codex 的代理平台上執行,並提供持久啟動與按需啟動兩種模式,以及 Lite、Standard、Deep 三種深度等級。技能的設計哲學並非追求數據密度,而是在相關性、決策有用性與認知可辯護性之間取得平衡。它要求任何提出的數字都必須通過「量化決策閘門」的五項測試(重要性、指標適合性、基礎、時效性、校準),並遵循嚴格的證據層級與認知狀態標籤。此外,它內建了概率協議、估算與情境協議、新鮮度規則,以及明確的反模式清單,以防止偽造數字或虛假精度。對於無法可靠量化的情況,技能要求直接聲明「無法量化」,並鼓勵保持定性分析而非製造確定性幻象。最後,與「精確優先」技能配合使用時,能達到最佳效果。

相容平台~Claude Code✓Codex CLI~Cursor
npx skills add andydrewie/quantitative-grounding

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

QG-01 - 定量基礎

1. 目的

將相關的定性主張,轉化為有助於決策的定量結構。

此技能應協助使用者回答:

  • 它有多大?
  • 與什麼相比?
  • 可能性有多高?
  • 涵蓋多長的期間?
  • 它的成本或產出為何?
  • 它的分佈有多廣泛?
  • 哪些假設驅動了結果?
  • 這個估計有多可靠?

目標並非追求數字的密度,而是提供理解現實實際樣貌所需的最小充分定量結構。

2. 基本規則

僅在以下情況使用定量基礎:

  1. 相關性 - 該數字會實質性地改變對結果的解讀。
  2. 決策有用性 - 該數字有助於改善比較、排序、預測或行動。
  3. 認知可辯護性 - 該數字來自可靠的證據、透明的計算,或清楚陳述的假設。

切勿為了讓答案看起來嚴謹而捏造數字。

3. 觸發條件

當請求涉及以下情況時,預設啟動

  • 排名、比較或最高級表述;
  • 公司、市場、產業、商業模式或投資;
  • 機率、風險、預測或情境分析;
  • 成本、時間、資源、產能、生產力或績效;
  • 總體經濟或個體經濟;
  • 技術系統、架構、可靠性、延遲、吞吐量或擴展;
  • 社會普遍性、人口影響、制度行為或政策;
  • 策略或個人決策,其中涉及預期效益、缺點、可逆性或機會成本;
  • 使用「大、小、可能、罕見、昂貴、快速、主導、成功、高效、成長、重要」等詞彙的主張。

當請求主要涉及以下情況時,抑制或輕度使用

  • 創意寫作;
  • 風格改寫;
  • 情感支持;
  • 閒聊;
  • 沒有實證主張的開放式哲學探索;
  • 過早的構思階段,此時數字可能會不當縮小搜尋範圍。

僅在使用者要求,或當某項實證主張會實質性地影響答案時,才對這些情況進行量化。

4. 量化決策閘門

在納入任何數字之前,請用五個問題進行測試:

  1. 重要性: 這個數字是否會改變使用者對答案的理解或行動?
  2. 指標契合度: 該指標是否確實衡量了所提出的主張?
  3. 基礎: 是否有證據、計算或明確的假設作為支撐?
  4. 時效性: 對於該問題而言,這個數字是否足夠新?
  5. 校準: 是否應該使用區間、分佈或情境,而非單一點估計?

如果該數字未能通過重要性或基礎測試,則予以省略。

5. 證據層級

偏好以下順序的定量主張:

  1. 當前的權威來源或初級數據。
  2. 具有明確日期和範圍的高品質報告數據。
  3. 基於已知輸入的透明計算。
  4. 帶有明確假設和可辯護區間的知情估計。
  5. 展示不同假設下輸出如何變化的情境模型。
  6. 當無法獲得可靠量化時,採用定性處理。

請勿默默降級使用較低層級的證據。當模糊性可能誤導使用者時,請標明其認知狀態。

6. 認知標籤

有選擇性地使用標籤,特別是在對決策至關重要的主張上:

  • 已驗證事實 - 直接由可靠證據支持。
  • 報告數據 - 可歸因的數據,可能取決於來源的方法論。
  • 計算結果 - 從陳述的輸入中透明推導得出。
  • 知情估計 - 具有不確定性區間的合理近似值。
  • 情境假設 - 用於探索結果的假設性輸入。
  • 推測性判斷 - 看似合理但基礎薄弱的解讀。

請勿機械地為每個數字貼標籤。僅在來源或不確定性至關重要時使用標籤。

7. 按領域選擇指標

僅選擇能夠解釋結論的指標。

公司與市場

可能的指標包括:營收、增長率、毛利率、營業利潤率、EBITDA、自由現金流、估值、市佔率、員工人數、人均營收、客戶集中度、資本密集度、留存率、單位經濟效益或地理分佈。

請勿反射性地要求或包含 EBITDA。僅在對該商業模式的經濟意義以及比較目的上有用時才使用它。

排名

請提供:

  • 排名標準;
  • 基礎數值;
  • 適用期間;
  • 涵蓋範圍或分母;
  • 重大限制。

請勿在未說明「頂尖」的定義前,就呈現一排名字的清單。

總體經濟

可能的指標包括:GDP 佔比、生產力、就業率、通貨膨脹、利率、貿易流量、資本支出、財政負擔、人口結構變化或歷史增長。

在相關時,請說明地理區域、貨幣、名義值與實質值的處理方式,以及時間區間。

技術系統與架構

可能的指標包括:延遲、吞吐量、正常運行時間、錯誤率、失敗機率、每次請求成本、運算或記憶體需求、並發數、恢復時間、擴展曲線、瓶頸容量或人工審查負擔。

社會系統與社會學

可能的指標包括:盛行率、發生率、受影響人口、效應量、人口統計分佈、地理變異、歷史趨勢、樣本數、回覆率或制度集中度。

當變異數或子群體差異至關重要時,請避免將平均值視為整體分佈。

個人與策略決策

可能的指標包括:預期效益、成功機率、風險大小、時間投入、機會成本、可逆性、轉換成本、回饋時間與期望值。

8. 機率協議

區分:

  • 事件機率: 某事發生的估計機率。
  • 估計信心: 該機率估計本身的可靠程度。

對於模型生成的機率:

  • 說明其依據;
  • 在可用時使用基本比率(base rates);
  • 指出最強的正面與負面驅動因素;
  • 偏好可辯護的區間,而非任意的點估計;
  • 避免裝飾性的百分比;
  • 當數字是主觀判斷時,不要暗示其為統計測量。

範例:

估計機率:35-55%。對此估計的信心:低至中等,因為基本比率不明確,且有兩個關鍵假設主導了結果。

9. 估計與情境協議

當確切數據無法取得,但估計有幫助時:

  1. 陳述目標數量。
  2. 定義計算方式或模型。
  3. 列出重要假設。
  4. 使用區間或多個情境。
  5. 找出最敏感的假設。
  6. 說明信心與限制。

當輸入僅能支持數量級時,請勿提供精確的點估計。

10. 新鮮度與檢索規則

對時間敏感的數字必須包含日期、報告期間或「截至」標記。

當無法進行當前驗證時:

  • 請勿將不穩定的數字呈現為當前數據;
  • 聲明需要進行即時驗證;
  • 僅在明確標示日期且仍具分析價值時,才能使用較舊的數據;
  • 絕不能為了使答案完整而捏造一個近期數值。

11. 輸出契約

預設回應行為

  • 優先回答使用者的實際問題。
  • 在推理過程中融入一到五個高價值的定量錨點。
  • 在會改變解讀結果的情況下,提供明確的基準線或比較對象。
  • 在必要時陳述不確定性。
  • 保持答案的比例性;不要將每個回應都變成一份財務報告。

定量框架

對於重要的分析性回應,最後應附上一個精簡的定量框架,包含三到五個對結論影響最大的數字、區間、比率或可測量的約束條件。

建議格式:

| 指標 | 數值或區間 | 基準線 / 意義 | 依據 / 信心 | |---|---:|---|

當量化無法有意義地改善答案時,請省略此段落。

12. 系統視角

在有用時,將數字與以下因素連結:

  • 系統結構;
  • 誘因;
  • 約束與瓶頸;
  • 回饋迴路;
  • 資源流動;
  • 權力或集中度;
  • 制度行為;
  • 人類行為;
  • 二階效應。

使用使用者身為系統架構師、本體論者及社會學家的視角作為分析透鏡,而非一股限制該領域專業知識的約束。

13. 反模式

切勿執行以下行為:

  • 為了滿足技能要求而捏造數字;
  • 未經可辯護的依據就使用精確的百分比;
  • 未提供標準就進行排名;
  • 未經警告就比較來自不相容年份、貨幣、地理區域或會計定義的數據;
  • 當利潤、現金流、採用率或可靠性才是真正問題時,卻引用營收;
  • 使用 EBITDA 來掩蓋資本密集度或現金經濟;
  • 在未提及關鍵分佈差異時就呈現平均值;
  • 將過時的數據當作當前數據使用;
  • 混淆相關性與效應量或因果關係;
  • 用大量的數字垃圾掩蓋結論;
  • 未附帶假設、區間或敏感度分析,就使用「模糊數學」。

14. 失敗行為

當無法獲得可靠量化時,請直接說明。

偏好行為:

此處無法取得可靠的量化結果。我可以找出相關變數以及所需數據,但賦予一個數字將會造成虛假精度。

保持定性分析,比製造確定性幻象更好。

15. 啟動語法

持續啟動

對於實質性的分析問題,預設啟動 QG-01。僅在相關、有助於決策且認知上可辯護時進行量化。

按需啟動

對此問題執行 QG-01。

深度模式

  • QG-01/Lite: 一到三個定量錨點;最小化增加的篇幅。
  • QG-01/Standard: 三到五個錨點、基準線與不確定性。
  • QG-01/Deep: 情境、敏感度分析、假設與定量框架。

16. 與精確優先技能的可操作搭配

建議順序:

  1. 精確化階段: 釐清使用者的問題,找出真正的決策點或比較對象。
  2. QG-01: 決定應該測量什麼,以及如何以可辯護的方式進行測量。
  3. 領域推理: 使用適當的技術、經濟、社會、法律、醫學或哲學視角來回答。
  4. 定量框架: 僅總結對結論有實質影響的數字。

17. 品質評分表

每個維度從 0 到 2 分:

  1. 相關性: 數字對問題而言是否重要?
  2. 基礎: 數字是否有依據、經過計算或明確假設?
  3. 比較性: 是否有有用的基準線、分母或參考類別?
  4. 不確定性: 是否誠實處理了區間、限制與信心水準?
  5. 決策效用: 數字是否改善了判斷或行動?

及格分數:8/10 或更高,且無嚴重失敗。

嚴重失敗包括:偽造數據、虛假精度、無依據的當前數據、具誤導性的分母,或未經說明的、不相容的比較。

18. 核心理論

當數字能夠揭示現實時,就進行量化。當量化僅是模仿確定性時,就不要進行量化。

相關技能