jahidulislamseo/antigravity-ai-skills

Brief 管理

Brief 是本地 SEO 專案的持久工作狀態。每個地點一個 Brief。多地點工作使用品牌彙總。排程任務的輸出會隨著時間延伸 Brief，為每家企業建立每次掃描、審計、報告和發現的累積歷史紀錄。

---

結構

briefs/
  {brand}/                     ← 品牌層級
    _brand.brief.md            ← 設定 + 所有地點的彙總
    reports/                   ← 品牌層級彙總報告
    {location}/                ← 地點目錄
      location.brief.md        ← 始終保持最新，始終精簡
      reports/                 ← 週報、月報、季度業務回顧報告
      scans/                   ← 地理網格掃描、引用審計、頁面審計
      drafts/                  ← 等待批准的 Google 商家檔案貼文、評論回覆
      alerts/                  ← 監控警報

---

首次執行檢測

這是最重要的部分。 當用戶提到特定商家，但沒有現有 Brief 時，請勿直接執行他們的要求。請先執行設定，然後再回到他們原本的要求。

檢測

在為特定商家進行任何工作之前，檢查是否有現有的 Brief：

• Claude Code：尋找 briefs/{品牌縮寫}/{地點縮寫}/location.brief.md
• Claude Project：檢查 Project 知識庫中是否有該商家的 Brief 檔案
• 如果找到：前往 從 Brief 恢復
• 如果未找到：前往 首次執行設定

首次執行設定

告訴用戶：

「我還沒有 [商家名稱] 的 Brief。讓我先取得一些詳細資訊，這樣我就可以追蹤後續的所有進度。這大約需要 2 分鐘。」

然後一個一個地問這些問題，不要一次問完：

Q1：「您想要排名的首要關鍵字是什麼？（例如 'plumber buffalo ny'）」

Q2：「網站網址是什麼？」

Q3：「服務範圍延伸到多遠？（例如 5 英里、20 英里）」

Q4：「您是為客戶管理這個，還是這是您自己的生意？」

• 如果是客戶，問：「客戶用於接收報告的電子郵件是什麼？」
• 如果是自己的生意，跳過

Q5：「您希望將警報和報告發送到 Slack 頻道嗎？」（選填，如果他們說不，則跳過）

就這樣。除非有些資訊真的不清楚，否則不要問更多問題。

問題之後

1. 建立 Brief 資料夾結構：

   • briefs/{品牌縮寫}/{地點縮寫}/location.brief.md
   • briefs/{品牌縮寫}/{地點縮寫}/reports/
   • briefs/{品牌縮寫}/{地點縮寫}/scans/
   • briefs/{品牌縮寫}/{地點縮寫}/drafts/
   • briefs/{品牌縮寫}/{地點縮寫}/alerts/
   • briefs/{品牌縮寫}/_brand.brief.md

2. 根據回答和對話中已有的上下文，填入「識別」部分

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. 從審計結果填入「發現」部分

6. 將「下一個動作」設定為單一最高優先級的修正項目

7. 提供排程任務設定選項：

   「Brief 已建立並完成初始審計。我發現了 [X 個嚴重、Y 個重要的問題]。[用一句話說明最重要的發現]。

   您想要設定自動監控嗎？我可以配置每週排名掃描、評論監控、Google 商家檔案變更檢測以及每月自動報告。

   如果要，請瀏覽 tasks/README.md 中的任務清單，根據審計結果推薦，並透過 /schedule 配置。 如果不要，則繼續處理原本的要求。

8. 然後回到用戶原本的要求：

   「現在讓我 [原本的要求]...」

針對 Claude Project / 瀏覽器用戶

如果沒有檔案系統存取權：執行相同的對話和審計，然後在設定的最後將 Brief 輸出為格式化文字：

「這是您的 Brief。請將其新增到您的 Project 知識庫中，這樣我下次就會有它：」 [Brief 內容]

---

何時建立 Brief（非首次執行）

在非首次執行的情況下，如果出現以下情況，請在會話中建立 Brief：

• 即將對一個沒有 Brief 的商家進行工具呼叫
• 用戶明確要求建立一個

請勿為以下情況建立 Brief：

• 沒有特定商家的通用本地 SEO 問題
• 工具或技能的說明
• 不需要即時資料的單一問題回答

---

Brief 存放位置

Claude Code / Cowork：

briefs/{品牌縮寫}/{地點縮寫}/location.brief.md

Claude Project： 建立後將 Brief 檔案上傳到 Project 知識庫。如果用戶還沒這樣做，請告訴他們。

---

更新 Brief（手動會話）

在每次會話結束時：

1. 會話記錄。 一行：日期 + 處理的內容
2. 已執行的工具。 每個工具呼叫：日期、工具、端點、一行發現
3. 發現。 新的問題，分類為「嚴重 / 重要 / 監控」
4. 交付物。 標記為已完成，新增待辦事項
5. 下一個動作。 用單一最重要的下一步覆蓋

---

接收排程任務輸出

當排程任務寫入一個輸出檔案時：

1. 讀取該輸出檔案
2. 在會話記錄中新增一行：[日期] | {任務類型} → {一行發現} → 請參閱 {輸出路徑}
3. 如果有新的「嚴重」發現：更新「發現」部分
4. 如果該任務發現了比當前更高的優先級事項，則更新「下一個動作」
5. 更新 _brand.brief.md 中此地點的「地點」表格列

Brief 保持精簡。詳細資訊存在於輸出檔案中。Brief 是指標。

---

從 Brief 恢復

當用戶回到某個商家時：

1. 讀取 Brief
2. 讀取每個子資料夾中最新的輸出檔案以了解當前狀態
3. 用 2-3 句話總結：已完成的事項、主要發現、當前狀態
4. 說明「下一個動作」
5. 問：「想從這裡繼續，還是有其他特定事項？」

除非用戶要求，或資料已超過 30 天，否則不要重新執行 scans/ 中已有結果的工具。

---

累積價值

經過數月的排程任務將結果寫入 Brief 後，歷史紀錄就可以被查詢：

• 「為什麼三月的排名會下降？」讀取該期間的 scans/
• 「今年的評論趨勢如何？」讀取 reports/ 的評論監控
• 「這個競爭者何時出現的？」讀取競爭者監控

永遠不要刪除輸出檔案。 如果資料夾變得難以管理，請將其歸檔。歷史紀錄才是價值所在。

---

經驗教訓飛輪

在每次會話（手動或排程）期間，留意以下情況：

• 工具返回的資料與技能檔案不一致
• 在 3 個以上地點出現但未在任何文件中記錄的模式
• Google 商家檔案、演算法或 AI 平台的行為與文件預期不同
• 某個工具端點出現異常行為

當觀察到這些情況時，明確地提出來：

「我在這次會話中注意到了 [X]。這個模式不在技能檔案中。您要我將它新增到 meta/lessons.md 供審查嗎？」

等待確認。然後寫下這個經驗教訓。

---

多地點品牌

每次地點會話結束後：

• 更新 _brand.brief.md 的「地點」表格中該地點的列
• 僅當某個模式出現在 3 個以上地點時，才將其新增到「品牌層級備註」

---

縮寫格式

使用小寫、連字號，名稱應淺顯易懂：

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