Communitygithub.com

pikaOne1138/astro-personal-site-starter

设计、构建、优化或审查适用于知识/博客和帮助者/专业服务两种类型的精美 Astro 网站。

astro-personal-site-starter 是什么?

该技能旨在开发具有设计感的 Astro 前端网站,特别适用于个人知识博客或专业服务工作室两种场景。它基于两种内容架构(知识/博客与帮助者/专业服务)和三种视觉风格(纸墨、晨光、静室),组合出多样化的设计方向,而非独立的六个代码库。技能严格限定了范围,专注于精美前端,避免扩展到 CRM、支付、数据库等后端系统。它提供了详细的页面职责、用户流程、UI 规则、导航、行动号召、动效和响应式设计指南,确保网站不仅功能完整,而且视觉上精心打磨。最终交付前需通过一套质量门禁检查,确保主要页面任务明确、层次清晰、移动端适配良好且动效细腻。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/pikaOne1138/astro-personal-site-starter/tree/HEAD/.ai/astro-ui-craft

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

Astro UI Craft

构建让人感觉经过精心设计,而非只是生成的网站。

核心模式

两种内容架构:

  • 知识 / 博客
  • 帮助者 / 专业服务

三种视觉个性:

  • 纸墨(Paper & Ink)
  • 晨光(Morning Light)
  • 静室(Quiet Studio)

将其视为 2 种架构 × 3 种视觉方向,而非六个独立的代码库。

范围护栏

默认范围是精致的前端网站。优先使用外部表单、LINE、预约和新闻通讯服务。不要悄悄扩展到 CRM、认证、会员系统、自定义预订引擎、支付、数据库或 SaaS 管理。

证据层级

  1. 直接打开 / 截图 / 计算的 CSS 观察。
  2. 网络搜索并经页面验证的观察。
  3. 来自已验证案例的跨案例模式。
  4. 设计方案和综合标记。
  5. 仅凭记忆或明确未经核实的候选列表。

知识/博客页面的任务

回答:

  • 这个人在写什么?
  • 新读者应该从哪里开始?
  • 如何找到某个主题的更多内容?
  • 为什么要关注他们?
  • 下一个低摩擦的动作为什么?

默认流程: Hero → 从这里开始/主题 → 精选/最新 → 简短关于 → 资源 → 新闻通讯 → 页脚

帮助者/专业服务页面的任务

回答:

  • 我来对地方了吗?
  • 这个人了解我的情况吗?
  • 他们提供什么?
  • 如果我联系他们会发生什么?
  • 我为什么能信任他们?
  • 下一个低压力的动作为什么?

默认流程: Hero → 共情 → 服务 → 首次访问/流程 → 关于/资质 → 信任 → 常见问题 → 预约/联系 → 页脚

优先考虑大约 7 ± 1 个有意义的版块。

视觉个性

纸墨(Paper & Ink)

温暖的纸张、深色墨水、衬线展示字体、精细的线条、低饱和度图像、编辑风格的列表。

晨光(Morning Light)

奶油色、黏土/玫瑰/鼠尾草色点缀、柔和的衬线 + 易读的无衬线、宽阔的圆角、自然光图像、温和的安抚感。

静室(Quiet Studio)

近乎白色的暖灰色、精确的网格、无衬线为主的字体、一个强烈的强调色、细边框、结构化的服务/内容元数据。

精细 UI 规则

  • 结构优先于装饰。
  • 一致的间距尺度。
  • 长文本行宽约为 60–72 字符。
  • 一个主要强调色 + 中性色。
  • 一致的图片比例和色调处理。
  • 可见的悬停/焦点/激活反馈。
  • 避免霓虹紫、过度玻璃态、随机的便当网格、重复的三列图标块、巨大的模糊渐变、毫无意义的计数器/轮播/打字机效果。

导航

桌面端:[Logo] 4–5 个链接 ... [单个主要 CTA]

  • 知识:文章 / 主题 / 从这里开始 / 关于 + 订阅。
  • 帮助者:服务 / 流程 / 关于 / 文章 / 常见问题 + 预订/联系。
  • 工作坊基准版本避免使用巨型菜单。

行动号召(CTA)

最多三个语义级别:

  • 主要:订阅 或 预订初步会面。
  • 次要:了解适配情况/流程/免费资源。
  • 低压力:阅读/探索/了解更多。

帮助者用语:“預約初談”, “了解合作方式”, “第一次來?先看看流程”, “開始聊聊”.

动效

  • 悬停 150–220ms
  • UI 过渡 180–350ms
  • 显示 400–650ms
  • 移动 4–16px
  • 缩放 ~0.98–1.03
  • 一致的缓出(ease-out)
  • 优先使用 transform + opacity
  • 尊重 prefers-reduced-motion

预期效果:用户可能不会刻意注意到动画,但会感觉网站被精心呵护。

响应式

不要仅仅缩小桌面布局。

  • 桌面端:容器宽度约 1080–1200px。
  • 平板:简化分栏布局/固定的侧边内容。
  • 移动端:单一阅读流,充足侧边内边距,在需要时使用全宽控件。
  • 帮助者页面仅在不会遮挡内容的前提下,可使用固定的预订 CTA。

质量门禁

交付前:

  • 主要页面任务显而易见;
  • 层级结构在不依赖装饰的情况下可正确阅读;
  • 移动端布局正常;
  • 对比度/点击目标/焦点状态可用;
  • 动效细腻且可选;
  • 构建成功;
  • 没有意外的后端范围蔓延。

相关技能