brief

简报管理

简报是本地 SEO 项目的持久工作状态。每个地点对应一份简报。多地点项目则使用品牌汇总简报。定时任务的输出会随着时间推移不断补充简报，逐步累积每家企业的每次扫描、审计、报告和发现记录。

---

结构

briefs/
  {brand}/
    _brand.brief.md          ← config + rollup across all locations
    reports/                 ← brand-level rollup reports
    {location}/
      location.brief.md      ← always current, always lean
      reports/               ← weekly, monthly, QBR reports
      scans/                 ← geogrid scans, citation audits, page audits
      drafts/                ← GBP posts, review responses awaiting approval
      alerts/                ← monitoring alerts

---

首次运行检测

这是最重要的部分。 用户提及某家具体企业，而目前没有该企业的简报时，先不要处理用户的请求。应先完成设置，然后再回到用户的请求。

检测

针对某家具体企业开展任何工作之前，检查是否已有简报：

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

首次运行设置

告诉用户：

“我还没有 [Business Name] 的简报。让我先了解一些情况，以便今后跟踪所有信息。大约需要 2 分钟。”

然后一次只问一个问题，不要一次问完：

Q1：“你希望为哪个主要关键词获得排名？（例如 ‘plumber buffalo ny’）”

Q2：“网站 URL 是什么？”

Q3：“服务范围有多大？（例如 5 英里、20 英里）”

Q4：“你是在为客户管理这项业务，还是自己的业务？”

• 如果是客户，询问：“客户用于接收报告的电子邮件地址是什么？”
• 如果是自己的业务，则跳过

Q5：“你希望将提醒和报告发送到 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. 根据用户回答和对话中已有的上下文填写 Identity 部分

3. 根据 Q4/Q5 的回答配置 _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. 根据审计结果填写 Findings

6. 将 Next Action 设为优先级最高的单项修复任务

7. 提供定时任务设置选项：

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

   你想设置自动监控吗？我可以配置每周排名扫描、评论监控、GBP 变更检测和月度报告，并让它们自动运行。”

   如果用户同意，根据 tasks/README.md 中的任务列表，结合审计结果提出建议，并通过 /schedule 进行配置 如果用户不同意，则继续处理原始请求

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

   “现在让我来[处理原始请求]……”

Claude Project / 浏览器用户

如果无法访问文件系统：进行相同的对话和审计，然后在设置结束时以格式化文本输出简报：

“这是你的简报。请将其添加到 Project 知识库中，这样下次我就能使用它：” [简报内容]

---

非首次运行时创建简报的情况

首次运行之外，如果出现以下情况，应在会话中途创建简报：

• 即将为没有简报的企业调用工具
• 用户明确要求创建简报

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

• 没有具体企业的常规本地 SEO 问题
• 工具或技能说明
• 不涉及实时数据的单个问题解答

简报位置

Claude Code / Cowork：

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

Claude Project： 创建后，将简报文件上传到 Project 知识库。如果用户还没上传，请提醒他们。

---

更新简报（手动会话）

每次会话结束时：

1. 会话日志。 一行：日期 + 处理的事项
2. 运行的工具。 每次工具调用：日期、工具、端点、一行结论
3. 发现。 新问题，按严重、重要、监控分类
4. 交付内容。 标记已完成的事项，添加新的待办事项
5. 下一步行动。 覆盖为唯一最重要的下一步

---

接收定时任务输出

定时任务写入输出文件时：

1. 读取输出文件
2. 在会话日志中添加一行：[DATE] | {task type} → {one-line finding} → see {output path}
3. 如果有新的严重发现：更新「发现」部分
4. 如果任务发现的事项优先级高于当前事项，则更新「下一步行动」
5. 更新 _brand.brief.md 中此位置对应的「位置」表格行

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

---

根据简报恢复工作

用户返回某个业务时：

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

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

---

复利价值

定时任务持续数月向简报写入内容后，历史记录便可供查询：

• “排名为什么在 3 月下降？”读取该时段的 scans/
• “今年的评价趋势如何？”读取 reports/ 中的评价监测记录
• “这个竞争对手是什么时候出现的？”读取竞争对手监测记录

绝不要删除输出文件。 如果文件夹变得杂乱，请归档。历史记录才是价值所在。

---

经验飞轮

每次手动或定时会话期间，留意以下情况：

• 工具返回的数据与技能文件相矛盾
• 在 3 个或更多位置出现了任何地方都未记录的模式
• GBP、算法或 AI 平台的行为与文档记录的预期不同
• 工具端点的行为异常

发现这类情况时，请明确提出：

“我在本次会话中注意到 [X]。技能文件中没有记录这种模式。要我将其添加到 meta/lessons.md 供你审阅吗？”

等待确认，然后记录经验。

---

多地点品牌

每个地点的会话结束后：

• 更新 _brand.brief.md 中「位置」表格里该地点对应的行
• 只有当某种模式出现在 3 个或更多地点时，才将其添加到「品牌级备注」

---

Slug 格式

使用小写字母、连字符，名称清晰易懂：

• 品牌：keystone-insurance、mikes-plumbing
• 地点：buffalo、downtown-chicago、pittsburgh-pa