site-architecture

site-architecture 技能概覽

site-architecture 是做什麼用的

site-architecture 技能能幫你設計或稽核搜尋引擎與 AI 爬蟲真正找得到、看得懂的技術基礎。它聚焦在實際的網站結構決策，例如 robots.txt、sitemap、meta 標籤、爬取存取權限與 Core Web Vitals，因此當能見度不只取決於內容品質時，這項技能就特別有用。

最適合的使用者與工作情境

如果你正在上線新網站、修正索引問題，或要為內容量大的網站做 SEO Content discovery，site-architecture skill 會很適合。對開發者、SEO 負責人與編輯來說，它尤其有幫助，因為他們需要的是清楚的技術方案，而不是空泛的 SEO 建議。

這項技能的差異在哪裡

這個技能不只是關於「SEO」的提示詞而已。它同時重視傳統搜尋引擎與 AI 爬蟲（例如 GPTBot、ClaudeBot、PerplexityBot）的可發現性，也重視透過 Open Graph 與 Twitter Cards 呈現的社群預覽。它的核心價值，是把架構決策轉成可爬取、可索引的頁面，並減少那些不易察覺的阻礙。

什麼情況適合、什麼情況不適合

當問題是整站架構、爬取存取，或中繼資料一致性時，它非常適合。若你只是需要一段單次的 meta description、內容簡報，或沒有技術發布層的設計回饋，那它就不太適合。

如何使用 site-architecture 技能

安裝並打開正確的檔案

在執行 site-architecture install 時，請把技能放在你要稽核或設定的網站同一個工作區中，然後先打開 SKILL.md。這個 repo 刻意設計得很輕量，所以最高價值的指引都在那個檔案裡。它沒有可依賴的配套 scripts 或輔助資料夾，因此你必須仔細閱讀規則，並把它套用到自己的技術架構上。

要提供哪些資訊給技能

site-architecture usage 這種用法，在你提供網站類型、平台與目前限制時效果最好。像這樣的輸入就很有力：
“請稽核我們基於 Next.js 的行銷網站，重點看 crawlability、sitemap 覆蓋率與 AI bot 存取；我們只希望公開頁面可被索引。”
這樣能提供足夠脈絡，讓技能產生有用的技術建議，而不是只給你一堆大方向的最佳實務。

如何提示，讓輸出更好

把 site-architecture guide 當成工作流程，而不是檢查清單。你可以直接要求以下其中一種成果：

• 針對特定環境的 robots.txt 草稿
• 公開與私有 URL 的 sitemap 策略
• 模板與頁面類型的中繼資料規則
• 目前網站架構的爬取／索引稽核

如果你需要 site-architecture for SEO Content，就明確說出哪些內容頁最重要、它們是怎麼生成的，以及哪些頁面應該不要出現在搜尋中。這能幫技能在可見度與排除之間取得平衡，這才是架構層真正的取捨。

先讀哪些檔案

先從這些開始：

• skills/site-architecture/SKILL.md

接著檢查你自己 repo 裡任何對應的路徑，例如：

• robots.txt
• sitemap.xml 或 sitemap 產生器
• HTML templates
• public asset directories

因為這個技能 repo 本身沒有額外支援檔，實作品質就取決於你能不能把它的規則對應到實際的網站結構上。

site-architecture 技能 FAQ

site-architecture 只適合開發者嗎？

不是。site-architecture skill 對 SEO、內容團隊與網站擁有者也很有用，只是最後的改動通常還是由開發者實作。非開發者的價值在於，先定義好爬取與索引政策，再開始動程式碼。

這跟一般提示詞有什麼不同？

一般提示詞常會問「SEO 最佳實務」，最後得到的通常是很制式的內容。site-architecture 的範圍更窄：它聚焦在爬取存取、內容發現、中繼資料與技術限制。當你需要的是會影響索引的決策，而不只是文案建議時，它就更合適。

這對新手友善嗎？

如果你能清楚描述網站，答案是可以。這個技能對新手友善的地方，在於它能替技術問題建立結構；但你仍然需要一些基本資訊，例如你的平台、公開／私有 URL 規則，以及網站是否應該被索引。

什麼情況下不要用它？

當任務純粹是創意類工作，例如寫首頁文案或替產品命名時，不要用 site-architecture。如果網站完全沒有爬取或索引上的顧慮，它也不是對的工具，因為這類架構指引只會增加不必要的負擔。

如何改進 site-architecture 技能

提供真正重要的限制條件

最好的輸出來自清楚交代平台、主機模式與索引目標的輸入。請說明你是 static hosting、SSR、CMS-driven publishing，還是混合式架構，也要說明哪些區塊必須封鎖給爬蟲。這樣可以減少猜測，讓建議更容易直接落地。

不只提供首頁，也要提供頁面類型

要提升 site-architecture 的結果，請列出主要的 URL 類別：產品頁、部落格文章、分類頁、文件頁、登入頁、後台區與篩選搜尋頁。這樣技能就能把可索引的模板，和應該排除的 URL 分開來看，這通常就是乾淨架構與誤耗爬取資源之間的差別。

留意常見失誤

最常見的漏失包括：在 robots.txt 裡誤擋有價值的頁面、暴露重複或低價值的 URL，以及在不同模板之間發佈不一致的 metadata。若第一次輸出看起來很制式，通常問題出在輸入不夠完整：缺少 URL 範例、內容優先順序不清楚，或沒有提到技術堆疊的限制。

用實證來迭代

第一次建議出來後，請用正式環境的檔案與 log 來驗證：確認 sitemap 覆蓋率、檢查 robots.txt，並在幾個代表性頁面上檢視實際渲染出的 metadata。接著再請技能只修正出問題的部分，例如「針對 faceted URLs 調整」或「收緊 staging 與 production 的 bot 存取」。這樣可以讓 site-architecture 技能保持聚焦，也能在第二輪得到更好的技術決策。