performance-monitor

性能监控

一个监控技能，两种模式。report 汇总已发生情况，生成面向利益相关方的多指标快照（流量、排名、GEO/AI、权威度、反向链接、内容），并将周期环比变化转化为优先级明确的建议。alert 配置前瞻性的阈值和异常通知，确保排名、流量、技术健康状况、反向链接、竞争对手排名或 AI 引用出现下降时，能在有人查看之前触发通知。根据意图选择模式：过去时态的报告 → report；将来时态的“出现情况时通知我” → alert。

模式集： report（多指标快照） · alert（前瞻性阈值/异常）。未说明时的默认模式：根据动词时态推断（参见决策关卡）。

范围限制——此技能不做什么： 此技能不会计算 CORE-EEAT 内容评分，也不会运行其否决检查（T04/C01/R10）——该关卡由 content-quality-auditor 负责；此技能不会计算 CITE 域名评分，也不会运行其否决检查（T03/T05/T09）——该关卡由 domain-authority-auditor 负责。若关卡已生成这些评分，此技能会报告评分并监控其变化；绝不会自行评分。逐项排名原始变化由 rank-tracker 负责。

快速开始

# report mode
Create an SEO performance report for [domain] for [time period]
Generate an executive summary of SEO performance for [month/quarter]
Create a GEO visibility report for [domain]

# alert mode
Set up SEO monitoring alerts for [domain]
Create ranking drop alerts for my top 20 keywords
Alert me when AI citations for [domain] drop

最简有效调用：performance-monitor <domain>（自动推断模式）。输出：report 返回一个仪表板，包含指标表 → 变化情况 → 原因 → 后续行动，每个数据都标有来源；alert 返回一份提醒配置摘要，列出命名触发条件、阈值、优先级和发送路由。两种模式都会生成可供存入 memory/monitoring/ 的交接摘要。

技能约定

预期输出：report 模式 → 基于变化的多指标报告/仪表板及每项变化的 Cycle Retro；alert 模式 → 一份提醒配置摘要，用于启动有明确关联的回读，而不是宣称即时结果。两种模式都包含精确的页面/变化/测量关联、证据引用，以及用于存入 memory/monitoring/ 的标准交接摘要。

• 读取：先前的基线和当前性能数据。report 读取当前及前一周期的流量/排名/权威度/内容指标、报告受众和日期范围。alert 读取基线、需监控的关键关键词/指标、正常波动范围和发送偏好。还包括用户提供的任何数据或工具数据。
• 写入：面向用户的监控交付内容，以及可存入 memory/monitoring/ 以供复用的摘要。
• 提升：重大变化、已确认的异常、持续有效的阈值和后续行动；待定决策写入 memory/open-loops.md（绝不直接写入 decisions.md）。
• 完成条件：
  • report：每个范围内的章节（流量、排名、GEO、权威度、反向链接、内容）均已提供或标记为“尚未评估”；每项指标均关联来源、时间、区间和目标，并与前一周期/对照组比较；每个有变化的页面均记录当前页面/内容/变化以及测量约定的引用/哈希；建议均注明负责人、优先级和预期影响。
  • alert：每个选定的提醒类别均有命名的触发条件、阈值和优先级；已定义 Critical/High/Medium/Low 响应计划和发送路由；阈值根据指标所述的正常波动范围进行调整。
• 首选下一技能：参见下一最佳技能——两种模式会相互交接。

交接摘要

按照 skill-contract.md §Handoff Summary Format 中的标准格式生成。在 Objective 行中注明当前模式（report / alert）。

数据源

所有集成都可选（参见 CONNECTORS.md）。Tier 1（无需密钥）在两种模式下均可使用；需要密钥的工具需选择加入 Tier 2/3。

• report：连接工具后，汇总来自 ~~analytics 的流量、来自 ~~search console 的搜索数据、来自 ~~SEO tool 的排名和反向链接，以及来自 ~~AI monitor 的 AI 可见度。未连接工具时，请用户提供 analytics 导出数据、Search Console 数据、排名数据和 KPI。
• alert：连接工具后，监控来自 ~~SEO tool、~~search console 和 ~~web crawler 的实时数据流。未连接工具时，请用户提供基准数据、关键字、通知偏好和历史数据。

零依赖测量闭环（两种模式均适用）：每项报告的变化或触发的警报都应来自计算得出的差值，而非目测估算。存储每个周期的 KPI，并由台账计算变化：python3 "${CLAUDE_PLUGIN_ROOT}/scripts/connectors/ledger.py" record <domain> --source monitor --data '{"sessions": ..., "clicks": ..., ...}'，然后运行 ledger.py diff <domain> --source monitor 获取周期差值，并运行 ledger.py trend <domain> --source monitor --field <kpi> 获取趋势线。每个数据都要标注为 Measured / User-provided / Estimated，并将结果变化归因于对照组，而非最近一次改动 — 参见 references/measurement-protocol.md。另请参见 scripts/connectors/README.md。

决策关卡

遇到以下情况时，停止并询问用户：

• 模式不明确 — 请求既不符合过去时（“报告上个月的情况”），也不符合将来时（“当 X 下跌时告诉我”）。提供以下选项：(1) 立即生成 report 快照；(2) 设置 alert 进行持续监控；(3) 两者都选。
• report：无法确定报告周期或对比周期，且上下文中也没有相关信息 — 提供以下选项：(1) 最近 30 天与之前 30 天对比；(2) 上一个自然月与前一个月对比；(3) 自定义时间范围。周期对比是必需项，不可省略。
• alert：要监控的指标没有基准数据或正常波动参考 — 阈值会沦为随意设定。提供以下选项：(1) 提供近期基准数据；(2) 使用 Alert Threshold Quick Reference 中的默认值并标注为 Estimated；(3) 取消。

继续处理，无需询问（以下情况绝不停止）：

• 报告某个部分缺少源数据 — 将该部分标记为“尚未评估”并继续；不要编造指标。
• 未说明受众（report）— 默认使用高管模板，并注明此假设。
• 未说明通知渠道（alert）— 默认使用上下文中的渠道（或电子邮件），并注明。
• 用户未提及的警报类别 — 保持未配置；不要添加用户未请求的警报。

说明

步骤 0 — 选择模式。 如果提供了 --mode，读取其值。否则根据请求推断：过去时 / “我们的表现如何” / “月报” → report；将来时 / “当……时告诉我” / “预警” → alert。如果两者都不符合，则使用上述模式不明确关卡。

模式：报告

使用 报告输出模板，并涵盖：

1. 定义报告参数 — 领域、周期、对比周期、报告类型、受众、重点领域、数据新鲜度。
2. 执行摘要 — 整体评级、成果、关注事项、必需操作、一览指标（流量、排名、转化、DA/权威度、AI 引用）以及 SEO 投资回报率；为每项指标标注 Measured / User-provided / Estimated。
3. 自然流量 — 会话数、用户数、页面浏览量、互动度/跳出率、趋势、来源/设备细分、热门页面；为每项数据标注来源。
4. 关键词排名 — 排名区间、分布变化、排名提升/下降幅度最大的关键词、SERP 功能。对于逐个排名位置的原始变化，请参阅 rank-tracker，不要在此重新计算。
5. GEO / AI 表现 — AI 引用概览、按主题划分的引用、GEO 成果、优化机会。
6. 域名权威度（CITE） — 仅当某个门控流程已生成 CITE 各维度评分和否决状态时，才予以列出；否则标记为“尚未评估”。不要在此计算 CITE。
7. 内容质量（CORE-EEAT） — 仅当已有平均评分和趋势数据时，才予以列出；否则标记为“尚未评估”。不要在此计算 CORE-EEAT。
8. 反向链接 — 链接配置文件摘要、获取趋势、值得关注的链接、竞争态势。
9. 内容表现 — 发布摘要、热门内容、需要关注的内容、内容投资回报率。
10. 建议 — 提供即时/短期/长期操作，并列出优先级、负责人、预期影响和下个周期的目标。
11. 编制完整报告 — 目录、附录、数据来源、方法论、术语表。

模式：提醒

使用 提醒配置模板，并：

1. 定义提醒类别 — 从排名、流量、技术、反向链接、竞争对手、GEO / AI 和品牌中选择。
2. 按类别配置提醒规则 — 为每条适用规则定义触发条件、阈值、提醒名称和优先级；将每个阈值与明确的基线关联，并标注该基线为 Measured / User-provided / Estimated。
3. 定义提醒响应计划 — 将 Critical / High / Medium / Low 映射到响应时间和后续操作。
4. 设置提醒发送方式 — 渠道、路由、冷却时间、维护窗口、升级路径。
5. 创建提醒摘要 — 输出各类别的数量、Critical 应对手册，以及每周检查清单作为交付内容。

通用规范（两种模式均适用）

为每项指标标注 Measured（工具/导出数据）、User-provided 或 Estimated（模型推断）；绝不可将估算值表述为实测值；如果某项必需指标不可用，标记为 N/A，不要编造数据。区分观察到的变化、合理的解释（陈述原因前需交叉验证）、优化机会以及需要后续检查（抓取/SERP/排名/审计）；绝不可将未经验证的解释报告为已确认原因。

提醒阈值速查

指标	警告	严重	频率
自然流量	周环比 -15%	周环比 -30%	每日
关键词排名	下降 >3 位	下降 >5 位	每日
已编入索引的页面	变化 -5%	变化 -20%	每周
抓取错误	每日新增 >10 个	每日新增 >50 个	每日
Core Web Vitals	“需要改进”	“较差”	每周
丢失的反向链接	1 周内 >5%	1 周内 >15%	每周
AI 引用损失	任一关键查询	>20% 的查询	每周
安全问题	检测到任何问题	检测到任何问题	每日

急剧下跌触发条件（始终启用）：如果自然流量或关键词整体排名较其滚动基线下降 >30%（默认：同一星期几区间内，之前 28 天的中位数），则无论所属类别如何，均触发 Critical 提醒。使用滚动中位数，而不是前一天的单个数据点，以免被某个噪声数据点误触发。为基线标注 Measured / User-provided / Estimated。

对照控制组读取变化

报告的变化或触发的警报，只有在预先设定的固定回读窗口内胜过控制组，才能作为证据——对于受混杂因素影响的结果，仅比较原始前后数据只是一个故事，而非证明。附上 references/measurement-protocol.md §Cross-discipline decision protocol 中的决策协议：

首先应用 SEO/GEO Evidence and Cycle Control Profile。回读必须绑定当前未分叉的页面/内容/变更版本头，以及精确的测量合约哈希。后续编辑会取代旧绑定并开启新窗口；事后设定的窗口必须明确标记为 reconstructed。

• 回读窗口——根据变更类型预先选择窗口（内容更新：7/14/28/56 天；新内容：14/28/56/90 天；技术修复：每日 ×7 天，然后 28 天；AEO/GEO 展现：每周），不要对窗口内的噪声作出反应。警报触发会开启一个回读窗口，而非立即作出结论——在宣布事件前，先确认下降持续存在。
• 必需的回读字段——记录：页面/内容/变更引用 + 哈希 · 当前版本头 · 测量合约引用/哈希 · 负责人 · 基线/候选/控制窗口 · 证据引用 · 主要指标 + 次要指标 · 决策 · 注意事项 · 下一次修补 · 下次回读日期 · 适用的索引回执。
• 决策——将每项变更标记为 Promote（主要指标超过门槛且优于控制组）、Keep-testing（趋势向好，但尚未达到显著性）、Rollback（劣于控制组，且差距达到相同门槛）或 Unproven（其他所有情况）。报告相对于控制组的变化，而非原始变化。

示例

• report：执行摘要，包含整体状态、流量/排名/转化/权威度/AI 引用概览指标、SEO ROI，以及列明负责人和日期的即时/月度/季度行动。
• alert：关键词警报矩阵，列出 Critical 与 High 阈值、针对下跌的响应计划，以及发送至电子邮件 + Slack 的通知路由。

保存结果

询问“保存这些结果吗？”如果回答是，则使用文件名 YYYY-MM-DD-<topic>.md 写入 memory/monitoring/——参见 skill-contract.md §Save Results Template。此技能不负责审计：写入记忆前先征求同意，并将类似否决权的风险移交给相关审计关卡处理，而不是自行附加否决标记。

参考资料

• Report Output Templates — 适用于全部 11 个报告章节的精简起始模板（report 模式）
• KPI Definitions — SEO/GEO 指标定义，包含基准、阈值、趋势分析和归因指南
• Report Templates by Audience — 面向高管、营销、技术和客户受众的即用模板
• Alert Configuration Templates — 完整的类别表、阈值和响应计划模板（alert 模式）
• Alert Threshold Guide — 阈值设置、疲劳预防、升级路径和响应手册
• Measurement & Attribution Protocol — 回读窗口、必需字段，以及 Promote / Keep-testing / Rollback / Unproven 决策规则
• SEO/GEO Evidence and Cycle Control Profile — 搜索/页面绑定、索引回执、时效性和 Cycle Retro 字段

下一个最佳技能

先按模式判断，然后终止：

• 在 report 之后——某项变更需要持续监控 → 以 alert 模式运行此技能。对于标记为“尚未评估”的部分，若涉及权威性 → domain-authority-auditor；若涉及内容质量 → content-quality-auditor。无需采取行动的一次性报告 → 终止。
• 在 alert 之后——用户要求定期报告 → 以 report 模式运行此技能。独立的提醒设置 → 终止。

终止规则：skill-contract.md §Termination rules 中的已访问集合和 max-depth: 3 规则适用。请勿在此链中重新进入已运行过的模式（report→alert→report 会因已访问集合而停止）；如果路由存在歧义，请列出选项并停止，不要自动继续。