Communitygithub.com

MOS 網站規劃工具

在實際建立網站之前,為小型企業規劃一個完整的網站藍圖:包含一份有來源佐證的需求摘要、一份搜尋意圖地圖,以及一份包含每頁規格(網址、標題、H1、章節、行動呼籲、證明素材)的網站地圖。所有內容皆源自活躍的 MarketingOS 大腦、僅針對缺口的面談,以及標示為已測量、已觀察或已假設的研究成果。流程會在已批准的計劃儲存至網站專案後停止。

MOS 網站規劃工具 是什麼?

此技能旨在協助使用者在進行任何開發工作前,先為小型企業網站建立一份詳盡且可執行的計劃。它會從 MarketingOS 的商業大腦中提取已知資訊(如品牌、目標受眾、服務),並透過一次僅針對資訊缺口的面談與實際研究來補足不足之處。其產出包含一份有來源佐證的網站需求摘要、一份將搜尋查詢分類的意圖地圖,以及一份包含每頁技術規格(URL、標題、H1、CTA 等)的網站地圖。此技能支援 Claude Code 和 Codex,並透過明確的步驟(從初始檢查到最終的批准循環)引導使用者,確保在花費時間和資源進行建置前,計劃已獲得核准。

相容平台✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/the-vibe-marketing-lab/mos-design-skills/tree/HEAD/mos-design-site-planner

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

MarketingOS 網站規劃工具

將商業大腦已知的資訊,加上一次簡短的面談與實際研究,轉化為一份可供開發人員實際建置的網站計劃:包含一份需求摘要、一份意圖地圖,以及每頁的規格。計劃本身就是最終交付成果。此技能在獲得核准的計劃後停止:絕不會建立頁面、撰寫最終文案、設定重新導向或選擇視覺設計。

MarketingOS 背景與先決條件

建議執行順序:mos-design-authentication → EmDash 專案設定 → mos-design-site-planner → mos-atomic-design-system。這些並非嚴格要求的前置步驟;如果較早的步驟尚未執行,請告知一次並繼續進行。

從當前工作階段及其記錄中解析出活躍的商業大腦與網站專案。在詢問任何問題之前,請先讀取該大腦的 BRAIN.md 或代理指令、CONTEXT.md 及 business/(品牌、語調、受眾、優惠方案、策略、證明素材、競爭對手)。若 mos CLI 可用,mos context show --json 會列出每個上下文欄位對應的檔案。請保持每個商業大腦的上下文獨立。若無 MarketingOS,則從使用者提供的檔案進行工作,並將所有其他資訊視為缺口。

對於捆綁的腳本,請使用 Bun;若缺少 Bun,請引導使用者至 https://bun.com/docs/installation。將 $SKILL 解析為包含此 SKILL.md 的實際目錄;不同代理的安裝位置可能不同。

調用方式:在 Claude Code 中使用 /mos-design-site-planner,在 Codex 中使用 $mos-design-site-planner。在 Claude Code 中使用 AskUserQuestion 提問,在 Codex 中則以帶有編號的問題和字母選項的方式提問。一個初始提示即可驅動整個工作流程;請讓所有核准都在同一個對話中進行。

證據標籤

每個研究發現和每個意圖聲明都帶有一個標籤:

  • measured(已測量):來自工具或匯出檔案的數字(例如 Search Console 點擊次數、關鍵字搜尋量、爬蟲計數),需附上數值及附有日期的來源 ID。
  • observed(已觀察):在特定日期直接觀察到的結果,但未計數(例如自動完成建議、搜尋結果頁面、其他人也問了什麼、競爭對手網站地圖、AI 回答),需附上附有日期的來源 ID。
  • assumed(已假設):基於推理或使用者的陳述,需附上推理理由。

沒有來源的發現將被標記為假設,否則予以省略。工具存取權限、關鍵字搜尋量、「其他人也問了什麼」的問題以及商業事實,僅在實際執行時才會被報告。

工作流程

在每一步完成後,將進度儲存至 <project>/site-plan/state.json,以便後續的工作階段可以從中斷處繼續。檔案格式、範本和狀態結構:請參閱 references/output-format.md。

1. 初步檢查

解析出商業大腦、網站專案(其 docs/project.md 或等效的專案筆記)以及任何現有的網站網址。如果 site-plan/state.json 已存在,請報告其步驟並從該處繼續。檢測此工作階段中哪些研究工具實際可用:Search Console 匯出或連接的工具、DataForSEO 金鑰、爬蟲工具(Scrapling 或純粹的 fetch)、網路搜尋。測試每一個;環境中若存在金鑰但測試呼叫失敗,則視為不可用。檢測步驟:references/research.md。如果尚無網站專案,請詢問一次儲存位置;預設為商業大腦的 outputs/YYYY/MM-Mon/YYYY-MM-DD-site-plan/。

當商業大腦、專案、儲存位置、現有網址(或「新網站」)以及可用的工具列表都已記錄在 state.json 中時,此步驟完成。

2. 我已知的資訊

從商業大腦建立資訊卡:包含業務、服務、地點與服務區域、受眾、優惠方案、語調、證明素材以及主要行動。每個項目都需標明其來源檔案,並標記為 confirmed(已確認)(商業大腦中明確陳述)、inferred(推斷)(從字裡行間推斷)或 missing(缺失)。顯示此資訊卡並讓使用者進行修正。資訊卡格式:references/interview.md。

當使用者已確認或修正資訊卡後,此步驟完成。

3. 僅針對缺口的面談

僅針對資訊卡中標記為推斷或缺失的項目進行提問,以批次方式進行,每個問題附帶建議答案及理由。問題庫涵蓋目標、付費服務、服務地區、新網站與替代網站、功能、證明素材、競爭對手與限制條件:references/interview.md。設計相關內容屬於 mos-atomic-design-system 和設計技能的範疇;在此請勿提及。

當每個需求摘要欄位都獲得回答或記錄為 GAP(缺口)時,此步驟完成。

4. 鎖定需求摘要

在一個畫面中展示需求摘要:事實及其來源、缺口、研究計劃以及任何付費呼叫及其預估成本。在花費研究時間或金錢之前,要求獲得肯定的回覆。

當使用者核准需求摘要後,此步驟完成;將其記錄在 decisions.md 中。

5. 研究

執行初步檢查中找到的每個可用方法:現有網站爬蟲與網址清單、Search Console 查詢與到達頁面、關鍵字搜尋量(有金鑰時使用 DataForSEO,否則使用標記為無搜尋量的自動完成)、搜尋結果頁面與「其他人也問了什麼」、競爭對手網站地圖,以及可選的 AI 回答檢查。缺少的可選來源將被列入研究缺口清單,並繼續進行工作。方法、備用方案與成本報告:references/research.md。每個來源都需在 research/sources.md 中新增一行附有日期的記錄。

當每個方法都已產出帶有標籤的發現結果或一個缺口條目時,此步驟完成。

6. 決定頁面

將查詢分類成群組(意圖),然後套用頁面規則:每個意圖一個頁面、每個付費服務一個服務頁面、僅針對有獨特內容的服務區域建立地區頁面、明確檢查關鍵字蠶食,以及對每個有流量或連結的現有網址做出保留、合併、重新導向或淘汰的決定。使用商業大腦中現有的優惠方案與定位作為框架。規則與測試:references/page-rules.md。

當每個意圖都對應到一個頁面或「無」(附帶原因),並且每個有流量或連結的現有網址都有遷移動作時,此步驟完成。

7. 設定每頁規格

針對每個頁面:網址、標題標籤、H1、目的、目標意圖及其證據、章節大綱、主要行動呼籲、來自商業大腦的真實證明素材(或 GAP: 標記)、內部連結與結構化資料類型。然後撰寫 site-plan.md 和 sitemap.csv,並以草稿模式執行驗證器:

bun $SKILL/scripts/check-site-plan.ts <project>/site-plan --draft

當草稿檢查通過時,此步驟完成。

8. 批准循環

首先顯示網站地圖樹狀結構,然後以每批三到四個頁面的方式顯示頁面規格。對於每個頁面,使用者可以核准、編輯或移除;套用編輯後,重新執行草稿檢查並顯示變更。將每個決定及其日期記錄在 decisions.md 中。重複此過程,直到使用者核准整個計劃。

當每個頁面的最新決定以及計劃本身都為「approved(已核准)」時,此步驟完成。

9. 儲存並交接

撰寫最終檔案(site-plan.md、decisions.md、sitemap.csv、research/),將 state.json 設定為已核准,並執行完整檢查:

bun $SKILL/scripts/check-site-plan.ts <project>/site-plan

在專案筆記(docs/project.md 或等效檔案;若不存在,請先詢問再建立)中新增一則附有日期的條目:說明了規劃了什麼、檔案位置、檢查結果以及下一步(通常是 mos-atomic-design-system)。如果網站專案已經是 git 儲存庫,請透過明確的路徑暫存規劃檔案並進行提交;切勿暫存機密資訊、.env 檔案或未經處理的工具回應,也絕不推送。提交規則:references/output-format.md。

最後說明:變更的內容、檢查輸出、開放的缺口與障礙,以及確切的下一步行動。僅當檢查確實在當前工作階段中執行並通過時,才能報告為通過。

參考地圖

檔案在何時閱讀
references/interview.md步驟 2 至 4:資訊卡、問題庫、批次處理與需求摘要展示
references/research.md步驟 1 和 5:工具檢測、每種研究方法、備用方案與成本
references/page-rules.md步驟 6:意圖分群、地區頁面、關鍵字蠶食、遷移地圖
references/output-format.md步驟 7 至 9:驗證器強制執行的格式、狀態、決定與提交
assets/每個輸出檔案的起始範本
scripts/check-site-plan.ts--help;在步驟 7 至 9 中執行
scripts/test-check-site-plan.ts證明驗證器會拒絕每個格式錯誤的計劃

相關技能

來自 MarketingOS GEO 套件(mos-geo-skills)的可選後續技能,此處僅列出名稱,需另行安裝:mos-geo-topic-clusters 用於在步驟 6 之前對大型 Search Console 或 Ahrefs 匯出檔案進行主題分群,mos-geo-brand-360 用於 AI 回答檢查,以及 mos-geo-fan-out-map 用於網站上線後使用。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相關技能