performance-reporter

performance-reporter 技能總覽

performance-reporter 是用來做什麼的

performance-reporter 技能可協助你把 SEO 與 GEO 成效數據整理成能直接對利害關係人呈現的報告、儀表板與月報摘要。它是為了團隊實際面對的工作情境而設計：在每次報告時，不必再手動重想 KPI 定義、報告結構與摘要措辭，就能清楚向高層、客戶或內部利害關係人說明成果。

哪些人適合使用 performance-reporter 技能

最適合的使用者包括 SEO 負責人、成長行銷人員、代理商客戶經理，以及已經有 analytics、Search Console、排名追蹤工具、backlink 工具或 AI 可見度工具資料的營運人員。如果你經常要處理「產出每月 SEO 報告」或「向主管報告 SEO 成效」這類任務，這個技能會很適合。

performance-reporter 與一般報表提示詞有何不同

performance-reporter 相較於單純的 prompt，最大優勢在於「有架構」。這個 repo 內含：

• KPI 定義，包含公式、資料來源與警戒區間
• executive summary 與各種報告區塊的輸出模板
• 依受眾區分的報告模板

也就是說，這個技能不只是「幫我寫一份報告」。它提供的是一套報告框架，可降低摘要過於空泛、指標對不上、或格式不符合利害關係人閱讀需求的問題。

安裝前多數使用者最在意什麼

多數人在評估 performance-reporter 時，最想快速知道這四件事：

1. 能不能用我現有的指標直接產出報告？
2. 適不適合做高層或客戶報告？
3. 需不需要額外的特殊工具？
4. 它能不能幫我解讀指標，而不只是重述數字？

根據 repo 內容，如果你已經有數字，答案大致上是可以。不需要安裝任何 system packages；只有在你想接入即時 SEO 工具整合時，optional MCP/network access 才會有差別。

什麼情況下 performance-reporter 特別適合

當你需要以下工作時，performance-reporter 很適合：

• 每月或每季的 SEO 報告
• 給主管或客戶看的 KPI 儀表板
• 對排名、流量、backlinks 與 AI 可見度的敘事型摘要
• 能跨帳戶或跨期間重複使用的標準報告格式

特別是在你重視一致性，勝過每次都從零做客製分析時，它會很有幫助。

哪些情況下這個技能本身還不夠

performance-reporter 本身不是資料蒐集管線。如果你的資料不完整、不一致，或散落在多個工具裡，輸出品質就會明顯下降。當真正任務是診斷排名下滑、歸因問題，或技術 SEO 故障時，它也不能取代深入的鑑識式分析。

如何使用 performance-reporter 技能

performance-reporter 的安裝方式

請在你支援的 skills 環境中安裝 performance-reporter。常見做法如下：

npx skills add aaron-he-zhu/seo-geo-claude-skills --skill performance-reporter

根據 repo 說明，它可搭配 Claude Code、skills.sh marketplace、ClawHub marketplace，以及 Vercel Labs skills ecosystem 使用。

第一次使用前要準備什麼

想讓 performance-reporter workflow 真正有用，建議先準備：

• 網站或網域名稱
• 報告期間與比較期間
• 目標受眾：executive、client、marketing 或 technical
• 核心指標：traffic、rankings、conversions、backlinks、AI citations、visibility、CTR
• 重要亮點、風險與後續行動

只說「幫我摘要 SEO 成效」也能用，但如果你提供實際數值與脈絡，這個技能的表現會好很多。

最低限度要提供哪些資訊，才能產出可用內容

一個可行的起始輸入大致如下：

• domain: example.com
• period: Jan 1-31, 2025
• comparison: Dec 1-31, 2024
• audience: executive
• metrics: organic sessions, conversions, top-10 keywords, backlinks, AI citations
• goal: one-page summary with wins, watchouts, and next actions

這樣的資訊量，已足以讓技能產出結構化報告，而不是泛泛而談的評論。

如何把模糊需求轉成有力的 prompt

較弱的 prompt：

• “Create an SEO report.”

較強的 prompt：

• “Use the performance-reporter skill to create an executive monthly SEO report for example.com covering Jan 2025 vs Dec 2024. Include an executive summary, KPI table, top wins, watch areas, and 3 recommended actions. Metrics: organic sessions 285k vs 261k, conversions 7,980 vs 7,410, top-10 keywords 187 vs 172, domain rating 52 vs 51, AI citations 34 vs 28. Keep it concise and leadership-friendly.”

較強版本之所以效果更好，是因為它把期間框架、受眾、指標變化與必備段落都先講清楚了。

報告團隊最實際的 performance-reporter 工作流程

一套實用的 performance-reporter usage 流程如下：

1. 從 analytics 與 SEO 工具蒐集來源指標。
2. 統一報告期間與比較區間。
3. 選擇對應受眾的模板。
4. 請技能先產出報告初稿。
5. 檢查的是「解讀是否成立」，不只是格式是否漂亮。
6. 補上帳戶特有的限制條件或商業背景。
7. 匯出或貼進你的簡報／文件流程中。

這是一個加速報告產出的技能，不是用來取代 source-of-truth 驗證的工具。

在 repository 中應該先看哪些檔案

如果你想判斷是否適合導入，或想自訂輸出格式，建議先看：

• SKILL.md
• references/kpi-definitions.md
• references/report-output-templates.md
• references/report-templates.md

照這個順序閱讀，可以最快掌握觸發語句、KPI 解讀方式與輸出格式。

為什麼這些 reference 檔案重要

references/kpi-definitions.md 是導入前最值得先讀的檔案，因為它直接展示這個技能如何定義與解讀 SEO/GEO 指標，包含公式、資料來源、benchmark 區間與警訊。

如果你想把交付內容標準化，references/report-output-templates.md 很重要。

如果你需要依受眾調整呈現方式，尤其是 executive 與 technical 讀者之間的差異，references/report-templates.md 就特別關鍵。

如何選對受眾格式

當利害關係人最在意商業影響、趨勢方向與後續行動時，應使用 executive 格式。若讀者需要看到分群、可能原因，或各 channel 的細節，則應選擇較 technical 的格式。

performance-reporter for Reporting 的常見錯誤之一，就是直接把 technical metrics 丟給高層，卻沒有做解讀。repo 內的模板就是用來避免這種情況。

每月固定使用時，建議採用的 prompt 模式

如果是固定每月使用，建議建立一份 house prompt，例如：

“Use performance-reporter to generate our monthly SEO report. Audience: executive. Format: 1-page summary plus KPI table. Always include wins, risks, and next actions. Flag any KPI with >10% decline unless a seasonality note is provided.”

這樣可以提高跨月份的一致性，也能減少後續手動修稿。

什麼因素最影響輸出品質

最影響品質的關鍵因素包括：

• 乾淨且可比的 period-over-period 資料
• 清楚的指標標籤
• 明確的受眾定義
• 明確的輸出目標，例如 memo、dashboard summary 或 board update
• 對異常變化提供明確的商業背景

如果缺少這些，技能仍可能把格式排得很好，但解讀就容易偏弱。

performance-reporter 技能 FAQ

performance-reporter 適合做高層報告嗎？

適合。這正是 performance-reporter skill 最明確的強項之一。它內建的 executive 與 stakeholder 導向模板，讓它比一般「分析我的 SEO」prompt 更適合拿來做主管摘要。

performance-reporter 對新手友善嗎？

算是中等友善。你不需要很進階的設定，但至少要對 SEO 指標有基本概念。如果你無法說清楚 sessions、CTR、rankings 與 conversions 的差異，仍然可能拿到表面很完整、但其實建立在薄弱輸入上的輸出結果。

performance-reporter 會幫我抓即時資料嗎？

預設不會。repo 有提到可選的 MCP network access 來做整合，但這個技能的核心價值仍然是報告框架與指標解讀。除非你的環境本來就已接好工具，否則可先假設資料需要自行提供。

這和直接叫 AI 寫一份報告有什麼差別？

performance-reporter guide 的價值在於它內嵌了報告邏輯：KPI 定義、benchmark 提示，以及可直接使用的輸出模板。一般 prompt 也能寫出一段文字，但這個技能更有助於產出一致、可決策的報告。

什麼情況下不該使用 performance-reporter？

如果你的主要需求是以下任一種，就不建議直接用 performance-reporter：

• 深度 technical diagnosis
• 自動化 ETL 或 dashboard 同步
• 從工具擷取原始資料
• 在流量大幅下滑後進行調查式 SEO 分析

這些情況下，你會先需要分析能力或資料管線支援，再來才是報告。

代理商可以跨客戶使用嗎？

可以，而且這正是很強的導入理由之一。這些模板能支援跨帳戶重複使用的一致格式。不過代理商仍應依客戶情境調整 KPI 選擇、benchmark 與建議內容，避免每份報告都過度通用。

如何改善 performance-reporter 技能的使用效果

給 performance-reporter 更好的輸入，不是塞更多雜訊

好的輸入應該具體、可比較，而且符合受眾需求。與其直接貼上未整理的匯出資料，不如提供：

• metric name
• current value
• previous value
• percent 或 absolute change
• 已知原因
• 期望的報告風格

這樣 performance-reporter 才能把力氣放在解讀，而不是先替你清資料。

在指標變化旁補上商業背景

一份好的報告不只說明數字變了，也會說明為什麼變。可補充如下註記：

• campaign launched mid-month
• tracking changed on Jan 12
• seasonal decline expected after holiday peak
• branded traffic spiked due to PR coverage

否則技能可能會高估風險，或錯過真正重要的故事線。

先定義哪些 KPI 最重要

不要一次丟 30 個指標給技能，卻期待它產出一份很聚焦的報告。應直接告訴它哪些 KPI 會影響利害關係人的判斷，例如：

• organic sessions
• non-brand clicks
• top-10 rankings
• conversions 或 revenue
• backlinks 或 authority
• AI citations / GEO visibility

聚焦的 KPI 選擇，會讓最後的建議更有說服力。

先把解讀規則講清楚

若想改善 performance-reporter usage，可以在一開始就指定判斷規則：

• 任何下滑超過 10% 都要標記
• 盡可能區分 brand 與 non-brand
• 優先看 revenue 與 conversions，而不是 vanity metrics
• summary 最多 5 個 bullet
• 對 executive 避免 technical jargon

這能有效減少來回修訂次數。

用 repo 內的模板當作輸出約束

提升 performance-reporter 效果最有槓桿的方式，就是直接把 prompt 錨定在 repo 現有的報告模板上。你可以要求輸出包含：

• executive summary
• KPI table
• wins
• watch areas
• action required

這些段落本來就有 reference material 支援，因此通常比臨時指定的格式更穩定。

常見的失敗模式有哪些

常見的弱輸出通常發生在以下情況：

• comparison periods 不一致
• 指標同時混用 traffic 與 rankings，卻沒有優先順序
• 沒有指定受眾
• 模型被迫自行推測缺失的定義
• 一次貼了太多原始資料，卻沒有先摘要

這些問題多半都可以避免，而且比模型措辭本身更影響結果。

第一版出來後，應該怎麼迭代

拿到第一版報告後，不要只說「再改好一點」。請給具體的修訂指令，例如：

• “Shorten for a VP audience.”
• “Explain the CTR drop in one sentence.”
• “Separate wins from concerns.”
• “Turn this into a client-facing monthly summary.”
• “Add 3 actions tied to the weakest KPIs.”

這種做法通常比籠統要求重寫，更能得到強化過的第二版。

用來源透明度提升信任感

如果這份報告要送交主管或客戶，建議要求技能在文中標示指標來源，例如 analytics、Search Console、rank tracking 或 backlink tools。就算只是簡單標註來源，也能提升信任感，並減少後續追問。

為 performance-reporter 建立可重複使用的 house style

如果團隊每月都會使用 performance-reporter，建議保存一份標準 prompt，內容包含：

• 固定 KPI 順序
• 偏好的受眾語氣
• 必備段落
• 警示門檻
• recommendations 的措辭規則

這樣就能把這個技能從一次性的助手，變成可持續運作的報告系統。