Communitygithub.com

ComeOnOliver/skillshub

当用户想要规划、重构网站的页面层级、导航、URL结构或内部链接时使用。也适用于用户提及“站点地图”、“网站结构”、“页面层级”、“信息架构”、“IA”、“导航设计”、“URL结构”、“面包屑”、“内部链接策略”、“网站规划”、“需要哪些页面”、“如何组织网站”或“站点导航”等场景。此技能用于规划网站应包含哪些页面及其连接方式,不适用于XML站点地图(技术SEO,请参见seo-audit)。

skillshub 是什么?

此技能专为AI Agent(如Claude Code、Cursor、Codex)设计,用于辅助网站信息架构设计。它能帮助用户规划网站页面层级、导航、URL模式和内部链接,确保对用户直观且对搜索引擎友好。该技能支持多种网站类型(SaaS、内容站、电商、文档、混合站点、小企业),并能提供从基础树状结构到Mermaid可视化站点地图的多种输出格式。它还包含内部链接策略设计、URL规范性检查清单以及导航设计(页头、页脚、面包屑等)的完整实践指南。通过此技能,AI Agent可以引导用户收集商业背景、现有站点状态、内容清单等上下文信息,并最终生成包含页面层级、可视化站点地图、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次点击内从首页到达任何重要页面。这并非绝对,但如果关键页面被埋藏在4层以上,则存在问题。

扁平层级 vs 深层层级

方式最佳适用场景权衡
扁平(2层)小型站点、作品集简单但不可扩展
适中(3层)大多数SaaS和内容站点深度与可发现性良好平衡
深层(4层以上)电子商务、大型文档可扩展但有埋没内容的风险

经验法则:在保持导航清晰的前提下尽可能扁平。如果导航下拉菜单有20个以上项目,则增加一层层级。

层级级别

级别含义示例
L0首页/
L1主要板块/features、/blog、/pricing
L2板块内页面/features/analytics、/blog/seo-guide
L3+详情页面/docs/api/authentication

ASCII树形图格式

页面层级使用以下格式:

首页 (/)
├── 功能 (/features)
│   ├── 分析 (/features/analytics)
│   ├── 自动化 (/features/automation)
│   └── 集成 (/features/integrations)
├── 定价 (/pricing)
├── 博客 (/blog)
│   ├── [分类: SEO] (/blog/category/seo)
│   └── [分类: CRO] (/blog/category/cro)
├── 资源 (/resources)
│   ├── 案例研究 (/resources/case-studies)
│   └── 模板 (/resources/templates)
├── 文档 (/docs)
│   ├── 入门指南 (/docs/getting-started)
│   └── API 参考 (/docs/api)
├── 关于 (/about)
│   └── 招聘 (/about/careers)
└── 联系 (/contact)

何时使用ASCII与Mermaid:

  • ASCII:快速层级草稿、纯文本环境、简单结构
  • Mermaid:视觉展示、复杂关系、标注导航区域或链接模式

导航设计

导航类型

导航类型用途位置
页头导航主导航,始终可见每页顶部
下拉菜单在父菜单下组织子页面从页头项目展开
页脚导航次要链接、法律信息、站点地图每页底部
侧边栏导航板块内导航(文档、博客)板块内左侧
面包屑显示当前在层级中的位置页头下方,内容上方
上下文链接相关内容、下一步操作页面内容内

页头导航规则

  • 主导航最多4-7项(过多会导致决策瘫痪)
  • 行动号召按钮放在最右侧(例如“开始免费试用”、“开始使用”)
  • 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. 导航规范

  • 页头导航项目(已排序,含行动号召按钮)
  • 页脚板块和链接
  • 侧边栏导航(如适用)
  • 面包屑实现说明

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

相关技能