GEO 月度对比报告生成器
对比两份 GEO 审计报告,自动计算分数提升与待办完成度,为代理机构生成一份"这是您的进步"客户留存储报告。
该技能仅读取本地审计文件并写入 ~/.geo-prospects/reports/,无网络请求、无敏感数据外传,风险面较小,README 说明了数据存储位置且卸载器不删除用户数据(透明)。但允许 Bash 且未说明确认机制、无回滚说明;扣分点:权限确认与数据流细节披露不完整。
工作流自洽:文件发现、解析、delta 计算、输出路径均有明确步骤,找不到文件时有引导性失败提示(建议先运行 /geo prospect audit)。但解析依赖脆弱的文本模式匹配,且明确允许'若找不到分数就用上下文估算'——引入主观性与不可复现性;仓库测试仅覆盖 fetch_page.py 的 SSR 检测,未覆盖本技能的关键路径。静态评估上限为10;扣分点:估算模式破坏确定性、关键路径无测试。
触发词清晰(compare/delta/monthly report 及意大利语),目标场景(GEO 代理月度客户报告)明确,输入输出路径与前置条件(需两份审计文件)已声明。但边界较窄:仅依赖 ~/.geo-prospects/audits/ 中的 Markdown 格式审计文件,对其他来源输入的适配未说明;无中文支持,未评估大陆网络可达性(本技能本身不依赖外部服务,影响有限)。扣分点:非标准输入与非预期场景边界证据不足。
SKILL.md 有版本号、frontmatter、结构分层良好(目的/命令/工作流/模板/计算逻辑),README 提供架构与数据存储说明,MIT 许可明确。但无 changelog、无已知限制章节、维护责任与更新路径未明(未验证发布者),模板中夹带营销性内容。扣分点:版本治理与限制披露不完整。
核心任务(对比两份审计并生成进度报告)流程完整,模板详细可直接产出 markdown 报告。但'估算分数'可能生成缺乏事实依据的对照数据,'Estimated Business Impact'中的百分比/欧元数字在模板中允许编造式填充,产出报告需人工核实后才能交付客户。静态上限为7;扣分点:产出直接可用性受限,比较收益证据不足。
模板示例数字(32→44)为演示性内容而非已验证输出;delta 计算逻辑仅是模式列表;仓库测试不覆盖本技能;无第三方执行证据。静态上限为5;扣分点:无可审计的本技能关键路径复现材料。
- 静态评审未执行任何代码,评分基于源码阅读,置信度低。
- 允许'上下文估算分数'可能导致生成的月度报告包含无事实依据的数字,交付客户前必须人工核实。
- 报告模板含'业务影响估算'占位符(AI 流量增长百分比、欧元价值),易被填充为夸大或编造的营销数据。
- 本技能依赖同仓库 geo-prospect audit 产生的特定 Markdown 格式,其他格式输入的兼容性未声明。
- 允许使用 Bash 工具但未说明确认与回滚机制,建议使用者审查实际执行的命令。
- 发布者身份未经核实,维护与更新路径不明确;无中文支持。
这个 Skill 能做什么,适合哪些场景?
geo-compare 是 geo-seo-claude 仓库(共 16 个技能)中的一个子技能,专门用于 GEO(生成式引擎优化)客户的月度进度追踪。它读取基线审计与当前审计两份文件,计算总 GEO 分数、6 个分类、5 个 AI 平台以及 14 个 AI 爬虫访问状态的差值,并输出一份包含图表、行动项状态、本月亮点和下月重点的完整 Markdown 客户报告。报告保存到 ~/.geo-prospects/reports/ 目录。它本身不做审计——若没有历史审计文件,会提示先运行 /geo prospect audit。适合已经使用该仓库其他审计技能、需要向客户证明价值的 GEO 代理机构。
通过 /geo compare <域名> 或直接传入两个审计文件路径触发。工作流程:1) 在 ~/.geo-prospects/audits/ 中查找该域名的审计文件,按日期排序,取最旧为基线、最新为当前(仅有一份时以它为基线并运行一次快速审计);2) 从两份审计中解析总分、6 个分类分数、5 个平台分数、14 个 AI 爬虫的允许/阻止状态、关键问题与行动项;3) 计算差值并标注趋势(▲ 提升、▼ 下降、── 不变);4) 生成 Markdown 月度报告(含 ASCII 分数条、前后对比表、行动项完成状态、本月成果、新发现问题、下月优先事项、6 个月轨迹和预估业务影响)并保存到 ~/.geo-prospects/reports/<域名>-monthly-<YYYY-MM>.md,同时打印摘要统计。若文件中找不到精确分数,会根据文字描述的发现进行估算。
- GEO 代理机构在每月客户例会前,用 /geo compare electron-srl.com --month march-2026 生成本月进度报告,向客户展示分数从 32 提升到 44
- 代理机构续约谈判时,用行动项完成表(如 quick wins 3/5 已完成)证明服务交付情况
- 只有一份历史审计时,以旧审计为基线、现场跑一次快速审计作为当前值,立即生成首份月度对比
- 团队内部用 6 个月轨迹表检查客户是否按计划朝 65/100 的第 6 个月目标推进
- 分数出现下降时,用报告中的"新发现问题"板块把退步重新定位为新发现的优化机会
这个 Skill 有哪些优点和局限?
- 报告结构完整且面向客户留存:总分进度条、分类/平台前后对比表、爬虫访问变化、行动项完成率、6 个月轨迹一应俱全
- 支持域名或文件路径两种输入方式,审计文件的发现逻辑明确(按日期取最旧与最新)
- 自带趋势解读规则,包括把分数下降重新框定为"新发现的机会"的话术指引
- 自带触发词(compare、delta、monthly report 等,含意大利语)便于模型自动调用
- 强依赖同仓库的其他技能(/geo prospect audit、/geo report-pdf):单独使用此技能时缺少审计数据源,几乎无法工作
- 当审计文件中无精确分数时会"基于文字发现估算"分数,可能导致进度对比的准确性存疑
- 报告中的业务影响数字(AI 引用概率提升 X%、月度流量价值 +€X)为模板占位估算,并非实测数据
- 仓库无 Topics 标签、未提供该子技能的测试套件或示例报告输出
- 月度报告仅输出 Markdown;可视化 PDF 依赖仓库中另一技能
如何安装这个 Skill?
此技能不能单独安装,需安装整个 geo-seo-claude 仓库。macOS/Linux:curl -fsSL https://raw.githubusercontent.com/zubair-trabzada/geo-seo-claude/main/install.sh | bash。Windows(Git Bash):使用 install-win.sh。手动方式:git clone https://github.com/zubair-trabzada/geo-seo-claude.git && cd geo-seo-claude && ./install.sh。要求:Python 3.8+(Debian/Ubuntu 需 python3-venv)、Claude Code CLI、Git;可选 uv 加速安装、Playwright 用于截图。仓库以 MIT 许可证发布。
如何使用这个 Skill?
安装后在 Claude Code 中打开并运行:/geo compare <域名>(如 /geo compare electron-srl.com);或直接指定两份审计文件:/geo compare ~/.geo-prospects/audits/<域名>-2026-01-15.md ~/.geo-prospects/audits/<域名>-2026-03-12.md;可加月份参数:/geo compare electron-srl.com --month march-2026。若无历史审计文件,技能会建议先运行 /geo prospect audit <域名>。生成后可运行 /geo report-pdf 生成可视化 PDF 版本(该 PDF 功能属于同仓库的另一技能)。