Community研究與資料分析github.com

kanatuxya/metrics-advisor

為你的商業模式挑選正確的指標,並解釋任何指標的含義。可建構指標金字塔(商業目標 → 單位經濟學 → 忠誠度 → 價值 → 品質 → 流量來源),包含一個北極星指標及其四個輸入項、31 個行業的基準值、本週應追蹤的三個指標與應跳過的虛榮指標,並能將其轉換為頁面供團隊列印 PDF。

metrics-advisor 是什麼?

這是一個專為 AI 助手設計的技能,幫助使用者為其商業或產品建立一套完整的指標體系。它可以執行兩項核心工作:解釋單一指標的含義與計算方式,或從零開始建構一個涵蓋六個層級的「指標金字塔」。技能的核心知識庫與回覆預設為俄文,貨幣單位預設為哈薩克堅戈(₸),但使用者可以要求以其他語言回覆。此技能支援 Claude Code、Cursor、Codex 等支援技能系統的工具。使用時,助手會先根據使用者提供的產業與商業階段,透過內部腳本查詢 31 個行業的基準資料,然後遵循 16 條金字塔規則,選出 9 到 15 個關鍵指標,包含一個北極星指標及其四個輸入項(覆蓋、深度、頻率、效率),並提供本週優先追蹤的三個指標與應跳過的虛榮指標。最後,它可以將結果渲染為一份可搜尋的 HTML 頁面,內建「下載 PDF」按鈕,方便團隊共享。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/kanatuxya/metrics-advisor/tree/HEAD

Installed? Explore more 研究與資料分析 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

在你喜歡的 AI 中提問

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

說明文件

指標顧問

兩項工作:解釋指標,或為特定商業建構指標體系。知識庫使用俄文;以使用者語言回覆(預設為俄文),所有金額保留為堅戈(₸)。

技能目錄:~/.claude/skills/metrics-advisor(以下簡稱 $S)。

檔案內容何時閱讀
references/pyramid-rules.md層級、釐清問題、16 條金字塔規則、對話輸出格式每次建構金字塔
references/north-star.md北極星指標、三種「遊戲」、檢查清單、輸入項、陷阱每次建構金字塔、回答 NSM 相關問題
references/glossary.md約 50 個按層級分類的指標:含義、公式、快/慢指標問題、命名指標
references/atlas.md深入方法論:金字塔、公式、快/慢、好指標 vs 虛榮指標、建構系統、案例、逐步演算法概念問題、「為什麼」、需要案例時
references/finance-ratios.md現金循環、流動性、債務、ROA/ROE商業涉及庫存、付款條件、貸款或大型資產
references/saas-kpis.mdB2B 訂閱軟體指標僅限 B2B SaaS
references/benchmarks.json31 個行業 × 5 項指標,附基準值與來源透過 scripts/benchmarks.mjs,切勿全文閱讀
assets/atlas.html與 atlas.md 相同,但為可搜尋的網頁形式當使用者想親自閱讀時

atlas.md 和 assets/atlas.html 在某些安裝中可能不存在。其餘部分在沒有它們的情況下也能正常運作;請改為參照 glossary.md 和 pyramid-rules.md。

工作 1:解釋指標或概念

  1. 在 glossary.md 中尋找該指標(以英文名稱、縮寫或俄文名稱搜尋)。對於概念(如 NSM、快 vs 慢、虛榮指標、金字塔 vs 漏斗、假設鏈),請使用 atlas.md。
  2. 簡短回答:指標的含義、公式、所屬金字塔層級、快或慢,以及一個以堅戈(₸)計算的小型工作範例。
  3. 如果提到了某個行業,且該指標在其對應的表格中,請加上基準值(node $S/scripts/benchmarks.mjs <industry>),並遵循下列基準值規則。
  4. 不要貼上整個參考檔案;僅引用回答問題所需的內容。

工作 2:建構指標金字塔

首先閱讀 pyramid-rules.md 和 north-star.md。

  1. 了解商業模式。 行業、階段(點子 / 第一批客戶 / 成長 / 規模)、獲利方式、參與的「遊戲」(attention、transaction 或 productivity,詳見 north-star.md)。對應行業:node $S/scripts/benchmarks.mjs --list,然後 node $S/scripts/benchmarks.mjs <id 或 name> 取得其五項 T 指標(加上 --json 可取得原始欄位)。若無接近匹配 → 行業設定為「другая」,無表格基準值。
  2. 提出 2–3 個釐清問題 — 僅針對描述中缺少的部分,按 pyramid-rules.md 中的優先順序提出,每個問題附上一個範例答案。提議遊戲類型,並附上一行推理,然後請使用者完成這句話:「Я был бы уверен, что дело идёт в правильную сторону, если бы видел рост …」。然後停止並等待。僅在描述已經回答了這些問題,或使用者要求不提問時跳過此步驟;此時請在開頭說明你的假設。
  3. 按 16 條規則建構金字塔: 9–15 個指標,橫跨六個層級,所有五項 T 指標均已包含並標記,一個北極星指標及其四個輸入項(охват、глубина、частота、эффективность)、7 點 NSM 檢查、本週要開始追蹤的三個指標、三個應跳過的虛榮指標、一兩句總結。從 glossary.md 提取指標名稱,並使其具體適用於此商業模式。僅在規則 15–16 下加入財務比率或 SaaS 指標。
  4. 以 pyramid-rules.md 中指定的格式在對話中回答。
  5. 提供頁面。 如果使用者想要(供團隊使用、列印、PDF):將金字塔以 JSON 格式寫入使用者的工作目錄(JSON 的結構定義在 scripts/render_pyramid.mjs 開頭),然後執行 node $S/scripts/render_pyramid.mjs pyramid.json --out "Пирамида метрик — <бизнес>.html" 並開啟該檔案(macOS 上使用 open <file>)。該頁面有一個「Скачать PDF」按鈕。修復腳本回報的任何問題;腳本關於缺少 T 指標的警告表示違反了規則 2。如果使用者想要的是可分享的連結,而非檔案,且環境可以發佈 HTML 頁面,則改為提供連結。

基準值規則

  • 僅引用表格中的基準值。切勿發明常態或「良好數值」。關於商業的數字僅來自使用者。
  • 始終提供市場(period,包含年份(若已知),否則說明「год не указан」)和可靠性(rel);若有行業 caveat 則提及。來源連結位於表格中 — 在使用者詢問時提供。
  • 百分比和比率在不同市場間可轉移。來自國外研究的美元金額則不可:應說明「денежный ориентир из зарубежного исследования не переносим — сравнивайте с собой в динамике」。請勿換算貨幣。

風格

  • 使用淺白俄文,簡短句子。縮寫如 LTV、NSM、C1 可以接受;每次首次使用時,為非專業人士解釋其含義。
  • 使用具體名稱:例如「Доля гостей, вернувшихся в течение 30 дней」,而非「Retention」。
  • 切勿將營收、利潤、DAU、MAU、註冊數、追蹤者數或下載量作為北極星指標。
  • 當某項指標下降時,沿著金字塔逐層排查:找出所屬層級,不要用行銷手段處理忠誠度問題,應在底層的價值和品質中尋找原因,並防止上層指標下滑。

相關技能