performance-reporter

performance-reporter 技能概览

performance-reporter 是做什么用的

performance-reporter 技能可帮助你把 SEO 和 GEO 绩效数据整理成适合向利益相关方展示的报告、仪表盘摘要和月度总结。它针对的是团队真实会反复遇到的工作场景：面向高管、客户或内部团队清晰解释结果，而不是每次都手动重新定义 KPI、搭报告结构、再斟酌总结话术。

谁适合使用 performance-reporter 技能

最适合的用户包括 SEO 负责人、增长营销人员、代理商客户经理，以及已经从 analytics、Search Console、排名追踪工具、backlink 工具或 AI visibility 工具中拿到数据的运营人员。如果你的常见任务是“生成月度 SEO 报告”或“向老板汇报 SEO 结果”，这个技能会非常契合。

performance-reporter 与通用 reporting prompt 的区别

performance-reporter 相比普通 prompt 的核心优势在于结构化。仓库里提供了：

• 带公式、数据来源和预警区间的 KPI 定义
• 用于 executive summary 和各类报告模块的输出模板
• 按受众区分的报告模板

也就是说，这个技能不只是“写一份报告”。它为模型提供了一套 reporting framework，能减少空泛总结、指标错配，以及不适合利益相关方阅读的输出格式。

安装前用户最关心什么

大多数在评估 performance-reporter 的用户，通常想快速确认四件事：

1. 它能不能基于我现有的指标直接生成报告？
2. 它是否适合 executive 或 client reporting？
3. 我需不需要额外的特殊工具？
4. 它能不能帮助解释指标，而不只是把数字复述一遍？

从仓库内容来看，如果你已经有现成数据，答案大多是可以。不需要安装系统级依赖；只有当你想接入实时 SEO 工具集成时，optional MCP/network access 才会变得重要。

什么时候 performance-reporter 特别适合

当你需要以下场景时，可以优先使用 performance-reporter：

• 月度或季度 SEO reporting
• 面向管理层或客户的 KPI dashboard
• 对排名、流量、backlinks 和 AI visibility 的叙述型总结
• 在不同账户或不同周期之间复用统一报告格式

当“一致性”比“从零做高度定制化分析”更重要时，它尤其有价值。

什么时候单靠这个技能还不够

performance-reporter 本身不是一个 data collection pipeline。如果你的数据不完整、不一致，或者分散在多个工具里，输出质量就会明显下降。它也不能替代深入的 forensic analysis——如果你的真实任务是诊断排名下滑、归因异常，或 technical SEO 故障，仍然需要更深层的分析能力。

如何使用 performance-reporter 技能

performance-reporter 的安装方式

通过你所支持的 skills 环境安装 performance-reporter 技能。常见方式如下：

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

根据仓库说明，它兼容 Claude Code、skills.sh marketplace、ClawHub marketplace，以及 Vercel Labs skills ecosystem。

首次使用前需要准备什么

想让 performance-reporter 工作流真正产出有用结果，建议先准备好：

• 站点或域名
• 报告周期和对比周期
• 目标受众：executive、client、marketing 或 technical
• 关键指标：traffic、rankings、conversions、backlinks、AI citations、visibility、CTR
• 重要亮点、风险点和后续行动

和只写一句“总结一下 SEO 表现”相比，提供真实数值和背景信息，performance-reporter 的效果会好很多。

拿到可用输出所需的最小输入

一个可工作的起步输入可以是：

• 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.”

更强版本之所以输出更好，是因为它明确给了模型周期框架、目标受众、指标变化值，以及必须包含的版块。

reporting 团队最适合的 performance-reporter 工作流

一个实用的 performance-reporter usage 流程通常是：

1. 从 analytics 和 SEO 工具中收集源数据。
2. 统一报告周期和对比窗口。
3. 选择对应的受众模板。
4. 让技能先生成一版草稿报告。
5. 重点审核解释是否成立，而不只是看排版。
6. 补充账户特有的限制条件或业务背景。
7. 导出，或粘贴进你的 presentation/doc 工作流中。

这是一个帮助提速的 reporting skill，不是用来替代 source-of-truth 验证的工具。

仓库里建议优先阅读的文件

如果你想判断是否适合接入，或者想自定义输出，建议先看：

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

按这个顺序阅读，可以最快掌握触发方式、KPI 解读逻辑和输出格式。

为什么这些 reference 文件很重要

在正式采用前，references/kpi-definitions.md 是最有决策参考价值的文件，因为它展示了这个技能如何定义和解释 SEO/GEO 指标，包括公式、数据源、基准区间和预警信号。

如果你想要标准化交付物，references/report-output-templates.md 很关键。

如果你需要按受众切换呈现风格，尤其是区分高管读者和技术读者，references/report-templates.md 就非常重要。

如何选择合适的受众格式

当利益相关方更关注业务影响、趋势方向和后续动作时，应使用 executive 格式。若读者更需要分层拆解、根因线索或渠道级细节，则更适合 technical 格式。

performance-reporter for Reporting 的一个常见错误用法，是把技术指标直接丢给高管，却没有做好解释。仓库里的模板正是用来避免这个问题的。

适合每月重复使用的实用 prompt 模式

如果要长期重复使用，可以先做一个内部固定 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 数据
• 清晰的指标标签
• 明确的 audience 定义
• 明确的目标输出类型，比如 memo、dashboard summary 或 board update
• 对异常波动给出明确的业务背景说明

缺少这些信息时，技能依然可能“格式上看起来不错”，但在解释层面往往会变弱。

performance-reporter 技能常见问题

performance-reporter 适合做 executive reporting 吗？

适合。这正是 performance-reporter skill 最明确的优势之一。它内置了面向高管和其他利益相关方的模板，因此比通用的“analyze my SEO”类 prompt 更适合生成领导层摘要。

performance-reporter 对新手友好吗？

中等偏友好。你不需要复杂部署，但需要对 SEO 指标有基本认识。如果你分不清 sessions、CTR、rankings 和 conversions 的区别，模型依然可能给出一份看上去很完整的输出，但它可能掩盖了输入本身的问题。

performance-reporter 会帮我抓取实时数据吗？

默认不会。仓库提到可选的 MCP network access 用于 integrations，但这个技能的主要价值仍然在于 reporting 和 interpretation framework。除非你的环境本身已经接好了相关工具，否则默认应当认为数据需要你自己提供。

它和直接让 AI 写报告有什么区别？

performance-reporter guide 的价值在于它内嵌了 reporting logic：KPI 定义、benchmark 提示，以及现成的输出模板。通用 prompt 也能写文字，但这个技能更适合产出稳定、可供决策使用的报告。

什么情况下不应该用 performance-reporter？

如果你的主要需求是以下任一项，就不适合直接用 performance-reporter：

• 深度技术诊断
• 自动化 ETL 或 dashboard 同步
• 从工具中抽取原始数据
• 在重大流量下滑后做调查型 SEO 分析

这些情况下，你首先需要的是分析能力或数据管道支持，之后才是 reporting。

代理商能否跨多个客户使用它？

可以，而且这是它很强的 adoption 场景。模板支持在多个账户之间复用统一格式。不过代理商仍然需要针对不同客户调整 KPI 选择、benchmark 和建议内容，避免最终报告过于模板化、缺乏针对性。

如何提升 performance-reporter 技能的使用效果

想让 performance-reporter 更好用，关键是给更好的输入，不是塞更多废话

高质量输入应该具体、可对比、且与受众匹配。不要直接粘贴杂乱无章的导出数据，最好明确提供：

• metric name
• current value
• previous value
• percent or absolute change
• any known cause
• desired report style

这样 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 or revenue
• backlinks or authority
• AI citations / GEO visibility

聚焦 KPI 选择，才能让建议显得更可信，也更有决策价值。

预先说明解释规则

想提升 performance-reporter usage，可以一开始就把判断规则写清楚：

• flag any decline over 10%
• separate brand and non-brand where possible
• prioritize revenue and conversions over vanity metrics
• keep the summary to 5 bullets max
• avoid technical jargon for executives

这样能明显减少来回修改的轮次。

把仓库模板当作输出约束来用

提升 performance-reporter 效果的高杠杆做法，是让 prompt 明确锚定仓库已有的报告模板。你可以直接要求输出包含：

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

这些部分本来就在 reference material 里已有支持，因此输出通常会比临时拼凑的格式更稳定。

需要特别留意的常见失败模式

以下情况最容易导致输出变弱：

• 对比周期不一致
• 流量类和排名类指标混在一起，但没有优先级
• 没有指定 audience
• 模型被迫自行推断缺失定义
• 一次粘贴太多原始数据，却没有先做摘要整理

这些问题大多都能提前避免，而且它们对结果的影响，往往比模型措辞本身更大。

第一版出来后，如何有效迭代

拿到第一版报告后，不要只说“make it better”。更有效的做法是给出有针对性的修改指令，比如：

• “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 顺序
• 偏好的 audience 语气
• 必须包含的版块
• 预警阈值
• recommendations 的表述规则

这样就能把这个技能从一次性助手，逐步变成可重复执行的 reporting system。