site-architecture
作者 alirezarezvanisite-architecture 可協助 AI agents 稽核並規劃網站結構、URL hierarchy、navigation、crawl paths、breadcrumbs 與 internal linking，用於 Technical SEO。它包含 URL design 與 internal linking 指南，並提供 sitemap analyzer script，協助產出以證據為基礎的網站架構建議。
此 skill 評分為 84/100，對想讓代理稽核或重新設計網站資訊架構與 internal linking 的目錄使用者來說，是相當可靠的上架候選。repository 證據顯示它在觸發條件清晰度、workflow 深度、參考資料與可用分析 script 上都有足夠基礎，比一般 SEO prompt 更能帶來實質助益；不過在安裝與新手導入的包裝上仍可更清楚。
- frontmatter 的觸發範圍清楚涵蓋 site architecture、URL structure、navigation、breadcrumbs、topic clusters、orphan pages 與結構性 SEO 問題，並排除 content strategy 與 schema markup。
- 實作內容有長篇 SKILL.md、脈絡蒐集 prompts、11 個 H2 區段、20 個 H3 區段，以及 internal linking 與 URL design 的實用參考資料支撐。
- 內含一個 stdlib Python sitemap analyzer，可檢查 sitemap.xml 檔案的深度、URL patterns、duplicate paths、orphan candidates，並輸出 JSON summary。
- skill 資料夾中沒有安裝指令或 README，因此目錄使用者可能需要依照上層 repository 的慣例自行推斷安裝方式。
- 目前證據顯示它具備紮實的 SEO 架構指引，但 workflow 摘錄有部分截斷，因此對完整端到端執行細節的把握並非百分之百。
site-architecture skill 概覽
site-architecture 的設計用途
site-architecture skill 可協助 AI 助理稽核、重新設計或規劃網站架構，重點涵蓋技術 SEO、可爬取性、導覽、URL 整潔度與內部連結。當問題屬於結構層面時，它最能派上用場：例如混亂的 URL 資料夾、薄弱的樞紐頁、孤兒頁、不清楚的導覽、糟糕的爬取路徑，或需要兼顧 SEO 安全性的網站搬遷資訊架構。
最適合的使用者與專案
這個 site-architecture skill 適合需要實務架構建議、而不是泛泛行銷建議的 SEO 顧問、技術 SEO 團隊、內容負責人、創辦人與開發者。它特別適用於 SaaS、B2B、內容型網站、文件網站、電商分類架構、在地服務網站，以及正在以主題叢集或 hub-and-spoke 模型重整的網站。
為什麼它比一般 prompt 更有力
一般 prompt 可能只會說「改善內部連結」，但這個 skill 會給 AI 助理一套明確流程：收集現況、目標與限制；評估 URL 模式；描繪導覽深度；並建議內部連結模型。此 repository 也包含 references/internal-linking-playbook.md、references/url-design-guide.md 和 scripts/sitemap_analyzer.py，因此它比簡短的 SEO checklist 更具可操作性。
什麼情況不適合使用這個 skill
不要把 site-architecture 當成決定要發佈哪些新文章、撰寫頁面文案、實作 schema markup，或從零開始做關鍵字研究的主要工具。它可以透過釐清頁面應該放在哪裡、彼此如何連接來支援這些工作流程，但它的核心價值在於架構，而不是內容發想或結構化資料。
如何使用 site-architecture skill
site-architecture 安裝方式與 repository 路徑
從 GitHub skill repository 安裝：
npx skills add alirezarezvani/claude-skills --skill site-architecture
原始檔位於 alirezarezvani/claude-skills 中的 marketing-skill/skills/site-architecture。安裝後，請先閱讀 SKILL.md，再檢查：
references/internal-linking-playbook.mdreferences/url-design-guide.mdscripts/sitemap_analyzer.py
這個 skill 資料夾中沒有獨立的 README 或 metadata file，因此主要操作說明都在 SKILL.md 與兩份參考指南中。
讓 site-architecture 更好用的輸入資料
若要有效使用 site-architecture，不要只對助理說「幫我修 SEO 架構」。提供以下資訊時，這個 skill 的效果最好：
- 網站 URL 與 CMS 或 framework
sitemap.xmlURL 或匯出的 sitemap- 各區段約略頁面數
- 主要商業模式：lead gen、SaaS、e-commerce、media、local、documentation
- 已知問題：孤兒頁、重複頁面、內容薄弱的分類頁、crawl bloat、排名不佳
- 想要排名或保護的優先頁面
- 限制條件：不能改 URL、搬遷期限、CMS 限制、工程資源
更好的 prompt 會像這樣：
Use the
site-architectureskill to audit our B2B SaaS site. Sitemap:https://example.com/sitemap.xml. We have feature pages, solution pages, integrations, docs, and 250 blog posts. Our priority is ranking solution pages without changing existing high-performing blog URLs. Identify structural issues, recommend URL folder rules, navigation changes, hub pages, and internal links. Flag anything that needs redirects or developer work.
架構稽核的建議工作流程
先從證據開始。如果你有 sitemap，可以執行或請助理使用 scripts/sitemap_analyzer.py，檢查 URL 深度、區段分布、重複的路徑模式，以及可能的孤兒頁候選。接著將結果對照 url-design-guide.md，找出不一致的 slugs、過深的資料夾、以日期為基礎的 blog 路徑、混用 trailing slash 的規則，或不清楚的區段命名。
下一步，使用 internal-linking-playbook.md 選擇連結模式。Hub-and-spoke 通常更適合建立主題權威；線性連結適合課程與文件；分類到產品的模型則適合電商。如果資源有限，請要求產出排定優先順序的修正清單，而不是一次做完整重設計。
實用 prompt 格式
完整的 site-architecture 指南型 prompt 應包含你想要的輸出格式。例如：
Produce: 1) current architecture diagnosis, 2) URL rule recommendations, 3) proposed navigation model, 4) internal linking plan by page type, 5) redirect/migration risks, 6) 30-day implementation plan, 7) open questions.
這能減少空泛建議，並推動助理產出可交給 SEO、內容與工程團隊執行的決策。
site-architecture skill 常見問題
site-architecture 適合技術 SEO 工作嗎？
是的。當任務涉及爬取路徑、可索引的 URL 模式、網站深度、內部連結、breadcrumbs、重複的結構模式，或需要兼顧網站搬遷安全性的 URL 決策時，site-architecture 很適合技術 SEO。若是 log-file analysis、Core Web Vitals 除錯或 schema implementation，除非這些問題與架構有關，否則它就不是最合適的工具。
初學者可以使用這個 skill 嗎？
可以，但初學者應提供具體的網站資訊，並要求助理解釋建議。這個 skill 包含實務參考資料，因此你可以要求「說明每項建議，以及它為什麼會影響可爬取性或排名」。第一次使用時，建議先要求診斷，再要求完整重設計。
它和一般 SEO prompt 有什麼不同？
一般 SEO prompt 常產出寬泛建議，例如「增加內部連結」或「讓 URL 更短」。這個 skill 結構更清楚：它會區分現況、目標、限制、URL 設計、導覽與連結架構。內建的 sitemap analyzer 也讓它更容易從原始 sitemap 資料推導出可執行的發現。
什麼時候應該避免安裝？
如果你只需要 blog topic ideas、metadata rewrites、product descriptions 或 schema snippets，就不需要安裝 site-architecture。此外，也不要把它當成高風險網站搬遷的唯一依據；請用它產出架構規劃，再用你的 SEO 工具驗證 redirects、canonicals、analytics 與 crawl data。
如何改善 site-architecture skill
提供真實網站證據給 skill
改善 site-architecture 輸出的最佳方式，是提供 sitemap、目前導覽、關鍵頁面類型與排名優先順序。如果不能分享網域，可以依區段提供匿名化的 URL 範例。真實例子能幫助助理判斷問題在於深度、命名、重複、薄弱的 hub，還是缺少連結。
要求決策，而不只是觀察
較弱的請求會問：「你覺得我們的架構如何？」更好的請求會是：
Recommend the preferred URL structure for features, integrations, solutions, blog, and docs. Keep existing ranking blog URLs unchanged unless there is a clear SEO reason to migrate. Mark each recommendation as keep, change, merge, redirect, or investigate.
這會迫使 skill 產出可直接進入實作的架構建議。
留意常見失敗模式
常見失敗模式包括：在沒有評估搬遷風險的情況下建議改 URL、建立過多 hub pages、不分語意地把所有 URL 都扁平化，或建議不具上下文價值的內部連結。請要求助理區分「安全的 quick wins」與「migration-level changes」，並說明每項結構建議的 SEO 取捨。
第一版輸出後持續迭代
把第一份答案視為架構地圖草稿，而不是最終計畫。後續補上 crawl data、Search Console exports、analytics priorities、CMS 限制或開發者回饋。接著請 site-architecture skill 將計畫修訂為分階段 roadmap：立即可做的內部連結、導覽整理、URL governance rules，以及較長期的重整。