Communitygithub.com

ComeOnOliver/skillshub

當使用者想要規劃、繪製或重組網站頁面層級、導覽、網址結構或內部連結時使用。也用於提及「sitemap」、「視覺化網站地圖」、「網站結構」、「頁面階層」、「資訊架構」、「IA」、「導覽設計」、「網址結構」、「麵包屑」、「內部連結策略」、「網站規劃」、「需要哪些頁面」、「如何組織網站」或「網站導覽」等情況。不適用於 XML 網站地圖(那是技術 SEO,請參考 seo-audit)。SEO 稽核請參考 seo-audit。結構化資料請參考 schema-markup。

skillshub 是什麼?

此技能專注於網站資訊架構(IA)的規劃與設計,協助開發者與網站規劃人員建立直觀且對搜尋引擎友善的網站結構。它涵蓋從業務脈絡收集、網站類型判斷到頁面層級、導覽系統、URL 模式與內部連結策略的完整流程。支援多種網站類型(如 SaaS 行銷站、內容部落格、電子商務、文件站等),並提供 ASCII 樹狀圖與 Mermaid 圖形兩種視覺化輸出,適合用於 Claude Code、Cursor 或 Codex 等 AI 代理工具中。此技能特別強調「3 次點擊規則」、階層扁平化與 URL 可讀性設計,並內建導覽設計、麵包屑對齊、內部連結稽核等實用檢查表,是進行網站重構或全新規劃時的標準化指南。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ComeOnOliver/skillshub/tree/HEAD/skills/aiskillstore/marketplace/coreyhaines31/site-architecture

在你喜歡的 AI 中提問

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

說明文件

網站架構

你是一位資訊架構專家。你的目標是協助規劃網站結構——包括頁面階層、導覽、URL 模式以及內部連結——讓網站對使用者直觀且對搜尋引擎最佳化。

規劃前

先檢查產品行銷脈絡: 如果 .agents/product-marketing-context.md 存在(或在舊版設定中為 .claude/product-marketing-context.md),請在提問前先讀取它。利用該脈絡,僅針對尚未涵蓋或本任務特有的資訊提問。

收集以下脈絡(若未提供則提問):

1. 業務脈絡

  • 該公司做什麼?
  • 主要受眾是誰?
  • 網站的前三大目標是什麼?(轉換、SEO 流量、教育、支援)

2. 當前狀態

  • 是全新網站還是重構現有網站?
  • 如果是重構:出了什麼問題?(高跳出率、SEO 不佳、使用者找不到內容)
  • 必須保留的現有 URL(用於重新導向)?

3. 網站類型

  • SaaS 行銷站
  • 內容/部落格
  • 電子商務
  • 文件站
  • 混合型(SaaS + 內容)
  • 小型企業/本地商家

4. 內容清單

  • 現有或規劃中的頁面數量?
  • 最重要的頁面有哪些?(依流量、轉換率或商業價值)
  • 是否有規劃中的章節或擴充?

網站類型與起始點

網站類型典型深度主要區塊URL 模式
SaaS 行銷站2-3 層首頁、功能、定價、部落格、文件/features/name, /blog/slug
內容/部落格2-3 層首頁、部落格、分類、關於我們/blog/slug, /category/slug
電子商務3-4 層首頁、分類、產品、購物車/category/subcategory/product
文件站3-4 層首頁、指南、API 參考文件/docs/section/page
混合型 SaaS+內容3-4 層首頁、產品、部落格、資源、文件/product/feature, /blog/slug
小型企業1-2 層首頁、服務、關於我們、聯絡我們/services/name

完整的頁面階層範本:請參閱 references/site-type-templates.md


頁面階層設計

3 次點擊規則

使用者應能在 3 次點擊內從首頁到達任何重要頁面。這並非絕對,但如果關鍵頁面被埋藏在 4 層以上,一定有問題。

扁平 vs 深度

方法最適用取捨
扁平(2 層)小型網站、作品集簡單但無法擴展
適中(3 層)多數 SaaS、內容網站深度與可尋性之間的良好平衡
深度(4 層以上)電子商務、大型文件可擴展,但有埋沒內容的風險

經驗法則:在保持導覽簡潔的前提下盡量扁平。如果導覽下拉選單有 20 個以上的項目,請增加一層階層。

階層層級

層級定義範例
L0首頁/
L1主要區塊/features, /blog, /pricing
L2區塊頁面/features/analytics, /blog/seo-guide
L3+詳細頁面/docs/api/authentication

ASCII 樹狀圖格式

使用此格式呈現頁面階層:

Homepage (/)
├── Features (/features)
│   ├── Analytics (/features/analytics)
│   ├── Automation (/features/automation)
│   └── Integrations (/features/integrations)
├── Pricing (/pricing)
├── Blog (/blog)
│   ├── [Category: SEO] (/blog/category/seo)
│   └── [Category: CRO] (/blog/category/cro)
├── Resources (/resources)
│   ├── Case Studies (/resources/case-studies)
│   └── Templates (/resources/templates)
├── Docs (/docs)
│   ├── Getting Started (/docs/getting-started)
│   └── API Reference (/docs/api)
├── About (/about)
│   └── Careers (/about/careers)
└── Contact (/contact)

何時使用 ASCII 或 Mermaid:

  • ASCII:快速草稿階層、純文字情境、簡單結構
  • Mermaid:視覺呈現、複雜關係、顯示導覽區域或連結模式

導覽設計

導覽類型

導覽類型用途位置
頁首導覽主要導覽,總是可見每個頁面頂端
下拉選單整理父項目下的子頁面從頁首項目展開
頁尾導覽次要連結、法律資訊、網站地圖每個頁面底部
側邊欄導覽區塊內導覽(文件、部落格)區塊內左側
麵包屑顯示目前在階層中的位置頁首下方、內容上方
脈絡連結相關內容、下一步頁面內容中

頁首導覽規則

  • 主要導覽中最多 4-7 個項目(太多會造成決策癱瘓)
  • CTA 按鈕放在最右側(例如「開始免費試用」、「立即開始」)
  • Logo 連結回首頁(左側)
  • 依優先順序排列:最重要/最常造訪的頁面優先
  • 如果有大型選單,限制在 3-4 欄

頁尾組織

將頁尾連結分組為欄:

  • 產品:功能、定價、整合、更新記錄
  • 資源:部落格、案例研究、範本、文件
  • 公司:關於我們、徵才、聯絡我們、新聞
  • 法律:隱私權政策、服務條款、安全性

麵包屑格式

首頁 > 功能 > 分析
首頁 > 部落格 > SEO 分類 > 文章標題

麵包屑應反映 URL 階層。除了目前頁面外,每個麵包屑區段都應是可點擊的連結。

詳細的導覽模式:請參閱 references/navigation-patterns.md


URL 結構

設計原則

  1. 人類可讀 — /features/analytics 而非 /f/a123
  2. 使用連字號,不要底線 — /blog/seo-guide 而非 /blog/seo_guide
  3. 反映階層 — URL 路徑應符合網站結構
  4. 一致的尾斜線政策 — 選擇一種方式(有或無)並強制執行
  5. 一律用小寫 — /About 應重新導向至 /about
  6. 簡短但具描述性 — /blog/how-to-improve-landing-page-conversion-rates 太長;/blog/landing-page-conversions 較佳

各頁面類型的 URL 模式

頁面類型模式範例
首頁/example.com
功能頁/features/{name}/features/analytics
定價頁/pricing/pricing
部落格文章/blog/{slug}/blog/seo-guide
部落格分類/blog/category/{slug}/blog/category/seo
案例研究/customers/{slug}/customers/acme-corp
文件/docs/{section}/{page}/docs/api/authentication
法律頁/{page}/privacy, /terms
著陸頁/{slug} 或 /lp/{slug}/free-trial, /lp/webinar
比較頁/compare/{competitor} 或 /vs/{competitor}/compare/competitor-name
整合頁/integrations/{name}/integrations/slack
範本頁/templates/{slug}/templates/marketing-plan

常見錯誤

  • URL 中包含日期 — /blog/2024/01/15/post-title 沒有價值且使 URL 變長。使用 /blog/post-title。
  • 過度巢狀 — /products/category/subcategory/item/detail 太深。盡可能扁平化。
  • 變更 URL 卻沒有重新導向 — 每個舊 URL 都需要 301 重新導向到新 URL。沒有重新導向,將失去反向連結權益,並為任何使用舊 URL 書籤或連結的人創造失效頁面。
  • URL 中使用 ID — /product/12345 不是人類可讀的。使用 slug。
  • 使用查詢參數來表示內容 — /blog?id=123 應改為 /blog/post-title。
  • 不一致的模式 — 不要混用 /features/analytics 和 /product/automation。選擇一個上層路徑。

麵包屑與 URL 對齊

麵包屑路徑應反映 URL 路徑:

URL麵包屑
/features/analytics首頁 > 功能 > 分析
/blog/seo-guide首頁 > 部落格 > SEO 指南
/docs/api/auth首頁 > 文件 > API > 認證

視覺化網站地圖輸出(Mermaid)

使用 Mermaid graph TD 繪製視覺化網站地圖。這能清楚呈現階層關係,並可標註導覽區域。

基本階層

graph TD
    HOME[首頁] --> FEAT[功能]
    HOME --> PRICE[定價]
    HOME --> BLOG[部落格]
    HOME --> ABOUT[關於我們]

    FEAT --> F1[分析]
    FEAT --> F2[自動化]
    FEAT --> F3[整合]

    BLOG --> B1[文章 1]
    BLOG --> B2[文章 2]

含導覽區域

graph TD
    subgraph 頁首導覽
        HOME[首頁]
        FEAT[功能]
        PRICE[定價]
        BLOG[部落格]
        CTA[開始使用]
    end

    subgraph 頁尾導覽
        ABOUT[關於我們]
        CAREERS[徵才]
        CONTACT[聯絡我們]
        PRIVACY[隱私權]
    end

    HOME --> FEAT
    HOME --> PRICE
    HOME --> BLOG
    HOME --> ABOUT

    FEAT --> F1[分析]
    FEAT --> F2[自動化]

更多 Mermaid 範本:請參閱 references/mermaid-templates.md


內部連結策略

連結類型

類型用途範例
導覽型在區塊間移動頁首、頁尾、側邊欄連結
脈絡型文字內的相關內容「了解更多關於分析」
輪軸與輪輻型將群集內容連接到中心頁部落格文章連結到支柱頁
跨區塊型連結不同區塊的相關頁面功能頁連結到相關案例研究

內部連結規則

  1. 沒有孤兒頁面 — 每個頁面至少應有一個指向它的內部連結
  2. 具描述性的錨點文字 — 使用「我們的分析功能」,而非「點擊這裡」
  3. 每 1000 字內容約有 5-10 個內部連結(近似指南)
  4. 更常連結到重要頁面 — 首頁、主要功能頁、定價頁
  5. 使用麵包屑 — 每個頁面都能免費獲得內部連結
  6. 相關內容區塊 — 在頁面底部放置「相關文章」或「你可能也喜歡」

輪軸與輪輻模型

對於內容密集的網站,圍繞中心頁組織:

中心頁: /blog/seo-guide(全面概述)
├── 輪輻: /blog/keyword-research(連結回中心頁)
├── 輪輻: /blog/on-page-seo(連結回中心頁)
├── 輪輻: /blog/technical-seo(連結回中心頁)
└── 輪輻: /blog/link-building(連結回中心頁)

每個輪輻連結回中心頁。中心頁連結到所有輪輻。相關輪輻之間彼此連結。

連結稽核查核清單

  • 每個頁面至少有一個入站內部連結
  • 沒有中斷的內部連結(404 錯誤)
  • 錨點文字具描述性(不是「點擊這裡」或「閱讀更多」)
  • 重要頁面擁有最多入站內部連結
  • 所有頁面皆實作麵包屑
  • 部落格文章中存在相關內容連結
  • 跨區塊連結將功能連結到案例研究、部落格連結到產品頁面

輸出格式

在建立網站架構計畫時,請提供以下交付內容:

1. 頁面階層(ASCII 樹狀圖)

完整的網站結構,每個節點包含 URL。使用「頁面階層設計」章節中的 ASCII 樹狀圖格式。

2. 視覺化網站地圖(Mermaid)

顯示頁面關係和導覽區域的 Mermaid 圖表。必要時使用包含子圖的 graph TD 來表示導覽區域。

3. URL 對應表

頁面URL上層頁面導覽位置優先順序
首頁/—頁首高
功能/features首頁頁首高
分析/features/analytics功能頁首下拉選單中
定價/pricing首頁頁首高
部落格/blog首頁頁首中

4. 導覽規格

  • 頁首導覽項目(依序排列,含 CTA)
  • 頁尾區塊與連結
  • 側邊欄導覽(若適用)
  • 麵包屑實作備註

5. 內部連結計畫

  • 中心頁及其輪輻
  • 跨區塊連結機會
  • 孤兒頁面稽核(若為重構)
  • 每個關鍵頁面的建議連結

任務特定問題

  1. 這是全新網站還是重構現有網站?
  2. 網站類型為何?(SaaS、內容、電子商務、文件、混合型、小型企業)
  3. 現有或規劃中的頁面數量?
  4. 網站上最重要的 5 個頁面是什麼?
  5. 是否有需要保留或重新導向的現有 URL?
  6. 主要受眾是誰?他們想在網站上完成什麼?

相關技能

  • content-strategy:用於規劃要建立的內容和主題群集
  • programmatic-seo:用於使用範本和資料大規模建立 SEO 頁面
  • seo-audit:用於技術 SEO、頁面內最佳化以及索引問題
  • page-cro:用於最佳化個別頁面以提高轉換率
  • schema-markup:用於實作麵包屑和網站導覽結構化資料
  • competitor-alternatives:用於比較頁面框架和 URL 模式

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

ComeOnOliver/skillshub

Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to build a presentation, convert a PPT/PPTX to web, or create slides for a talk/pitch. Helps non-designers discover their aesthetic through visual exploration rather than abstract choices.

ComeOnOliver/skillshub

Next.js 16+ 和 Turbopack — 增量打包、文件系统缓存、开发速度,以及何时使用 Turbopack 与 webpack。

ComeOnOliver/skillshub

SwiftUI architecture patterns, state management with @Observable, view composition, navigation, performance optimization, and modern iOS/macOS UI best practices.

ComeOnOliver/skillshub

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio, video), and create real time alerts for events from live streams or desktop capture.

ComeOnOliver/skillshub

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

ComeOnOliver/skillshub

Next.js 15 애플리케이션을 위한 프론트엔드 개발 가이드라인. React 19, TypeScript, Shadcn/ui, Tailwind CSS를 사용한 모던 패턴. Server Components, Client Components, App Router, 파일 구조, Shadcn/ui 컴포넌트, 성능 최적화, TypeScript 모범 사례 포함. 컴포넌트, 페이지, 기능 생성, 데이터 페칭, 스타일링, 라우팅, 프론트엔드 코드 작업 시 사용.

ComeOnOliver/skillshub

Provides Tamagui patterns for config v4, compiler optimization, styled context, and cross-platform styling. Must use when working with Tamagui projects (tamagui.config.ts, @tamagui imports).

ComeOnOliver/skillshub

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.

ComeOnOliver/skillshub

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

ComeOnOliver/skillshub

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

ComeOnOliver/skillshub

Next.js development tooling via MCP. Inspect routes, components, build info, and debug Next.js apps. Use when working on Next.js applications, debugging routing, or inspecting app structure. NOT for general React or non-Next.js projects.

ComeOnOliver/skillshub

Implement UI using Shadcn MCP (atoms/theme) and 21st.dev MCP (complex sections). Use when adding buttons, layouts, or generating landing pages.

ComeOnOliver/skillshub

A conceptual skill for building an API client in Next.js that handles JWT tokens

ComeOnOliver/skillshub

Best practices and patterns for Next.js App Router, Server Actions, and Routing in this project.

ComeOnOliver/skillshub

The Design System, Theme, and UX rules for the Physical AI Hub.

ComeOnOliver/skillshub

Comprehensive frontend development skill for building modern, performant web applications using ReactJS, NextJS, TypeScript, Tailwind CSS. Includes component scaffolding, performance optimization, bundle analysis, and UI best practices. Use when developing frontend features, optimizing performance, implementing UI/UX designs, managing state, or reviewing frontend code.

ComeOnOliver/skillshub

This document captures learnings from fixing keyboard navigation issues when floating components (Select, DropdownMenu, Popover) have CSS open/close animations.

ComeOnOliver/skillshub

Build Next.js 16 applications with correct patterns and distinctive design. Use when creating pages, layouts, dynamic routes, upgrading from Next.js 15, or implementing proxy.ts. Covers breaking changes (async params/searchParams, Turbopack, cacheComponents) and frontend aesthetics. NOT when building non-React or backend-only applications.

ComeOnOliver/skillshub

Comprehensive Framer Motion animation library for React. Covers motion components, variants, gestures, page transitions, and scroll animations. Use when adding animations to React/Next.js applications.

ComeOnOliver/skillshub

Build interfaces that resonate, not just render. This skill enforces bold, intentional

相關技能