jahidulislamseo/antigravity-ai-skills

简报管理

简报是本地 SEO 履约的持久工作状态。每个位置一个简报。多位置工作使用品牌汇总。计划任务的输出会随时间扩展简报，为每个业务构建每次扫描、审计、报告和发现的累积历史记录。

---

结构

briefs/
  {brand}/
    _brand.brief.md          ← 配置 + 所有位置的汇总
    reports/                 ← 品牌级别的汇总报告
    {location}/
      location.brief.md      ← 始终最新，始终简洁
      reports/               ← 周报、月报、季度业务回顾报告
      scans/                 ← 地理网格扫描、引用审计、页面审计
      drafts/                ← 待批准的 Google 商业档案帖子、回复草稿
      alerts/                ← 监控告警

---

首次运行检测

这是最重要的部分。 当用户提到一个特定的业务且没有现有简报时，请不要继续执行他们的请求。先进行设置，然后再回到他们的需求。

检测

在对某个特定业务执行任何工作之前，检查是否有现有简报：

• Claude Code：查找 briefs/{brand-slug}/{location-slug}/location.brief.md
• Claude Project：检查项目知识库中是否有该业务的简报文件
• 如果找到：转到 从简报恢复
• 如果未找到：转到 首次运行设置

首次运行设置

告知用户：

“我还没有 [业务名称] 的简报。让我先获取一些详细信息，以便以后可以跟踪所有内容。这大约需要 2 分钟。”

然后一次一个地询问以下问题，不要一次性全部问完：

问题 1： “您想排名的核心关键词是什么？（例如“plumber buffalo ny”）”

问题 2： “网站 URL 是什么？”

问题 3： “服务区域延伸多远？（例如 5 英里、20 英里）”

问题 4： “您是为客户管理这个，还是这是您自己的业务？”

• 如果是客户，询问：“客户的报告邮箱是什么？”
• 如果是自己的业务，跳过

问题 5： “您是否希望将告警和报告发送到 Slack 频道？”（可选，如果用户说不需要则跳过）

就这样。除非某些内容确实模棱两可，否则不要询问更多问题。

问题之后

1. 创建简报文件夹结构：

   • briefs/{brand-slug}/{location-slug}/location.brief.md
   • briefs/{brand-slug}/{location-slug}/reports/
   • briefs/{brand-slug}/{location-slug}/scans/
   • briefs/{brand-slug}/{location-slug}/drafts/
   • briefs/{brand-slug}/{location-slug}/alerts/
   • briefs/{brand-slug}/_brand.brief.md

2. 根据回答以及对话中已有的上下文填充“身份信息”部分

3. 根据问题 4/5 的回答配置 _brand.brief.md 的审批块

4. 自动运行初始审计，无需请求许可：

   • LocalSEOData local_audit
   • LocalSEOData business_profile + profile_health
   • LocalSEOData geogrid_scan（7x7、核心关键词、指定的半径）
   • LocalSEOData citation_audit
   • LocalSEOData review_velocity + google_reviews
   • LocalSEOData competitor_gap

5. 从审计结果中填充“发现”部分

6. 将“下一个操作”设置为单一最高优先级的修复项

7. 提供计划任务设置：

   “简报已创建，初始审计已完成。我发现 [X 个严重问题，Y 个重要问题]。 [用一句话说明最重要的发现]。

   是否希望我设置自动监控？我可以配置每周排名扫描、评论监控、Google 商业档案更改检测以及自动生成为月报。”

   如果同意，从 tasks/README.md 浏览任务列表，根据审计结果推荐，通过 /schedule 配置 如果不同意，继续执行原始请求

8. 然后回到用户最初的要求：

   “现在让我 [原始请求]...”

针对 Claude Project / 浏览器用户

如果没有文件系统访问权限：执行相同的对话和审计，然后在设置结束时将简报作为格式化文本输出：

“这是您的简报。请将其添加到您的项目知识库中，这样我下次就能找到它：” [简报内容]

---

何时创建简报（非首次运行）

在非首次运行的情况下，在会话过程中创建简报，如果：

• 即将对一个没有简报的业务进行工具调用
• 用户明确要求创建一个

不要为以下情况创建简报：

• 没有指定业务的通用本地 SEO 问题
• 工具或技能解释
• 没有实时数据的单一问题回答

---

简报位置

Claude Code / Cowork：

briefs/{brand-slug}/{location-slug}/location.brief.md

Claude Project： 创建后，将简报文件上传到项目知识库。如果用户未操作，请告知他们。

---

更新简报（手动会话）

每次会话结束时：

1. 会话日志。 一行：日期 + 所做的工作
2. 已运行的工具。 每个工具调用：日期、工具、端点、一行发现
3. 发现。 新问题，按严重/重要/监控分类
4. 可交付成果。 标记已完成，添加新的待处理项
5. 下一个操作。 覆盖为最重要的下一步

---

接收计划任务输出

当计划任务写入输出文件时：

1. 读取输出文件
2. 在会话日志中添加一行：[日期] | {任务类型} → {一行发现} → 见 {输出路径}
3. 如果发现新的严重问题：更新“发现”部分
4. 如果任务揭示了比当前更高的优先级，则更新“下一个操作”
5. 更新 _brand.brief.md 中该位置的“位置”表格行

简报保持简洁。详细信息保存在输出文件中。简报是索引。

---

从简报恢复

当用户回到某个业务时：

1. 读取简报
2. 读取每个子文件夹中最近的输出文件，以获取当前状态
3. 用 2-3 句话总结：已完成的工作、关键发现、当前状态
4. 说明“下一个操作”
5. 询问：“想从这里继续，还是处理其他具体事项？”

除非用户要求或数据超过 30 天，否则不要重新运行 scans/ 中已有结果的工具。

---

累积价值

经过数月计划任务向简报写入数据后，历史记录是可查询的：

• “为什么三月份排名下降了？” 读取该时期的 scans/
• “今年评论趋势如何？” 读取 reports/ 中的评论监控
• “这个竞争对手是何时出现的？” 读取竞争对手监控

永远不要删除输出文件。 如果文件夹变得难以管理，请归档。历史记录就是价值。

---

经验飞轮

在每次会话（手动或计划）中，注意观察：

• 返回的数据与技能文件相矛盾
• 在 3 个以上位置出现的模式但没有任何地方记录
• Google 商业档案、算法或 AI 平台的行为与文档预期不符
• 某个工具端点行为异常

当观察到时，明确提出来：

“我在本次会话中注意到了 [X]。这个模式没有包含在技能文件中。您希望我将它添加到 meta/lessons.md 以供审核吗？”

等待确认。然后编写经验。

---

多位置品牌

每次完成某个位置的会话后：

• 更新 _brand.brief.md 中该位置的“位置”表格行
• 仅当某个模式出现在 3 个以上位置时，才添加到品牌级备注中

---

别名格式

小写、连字符、直观：

• 品牌：keystone-insurance、mikes-plumbing
• 位置：buffalo、downtown-chicago、pittsburgh-pa