Communitygithub.com

mohammadNafia/portfolio

为浅灰色“像素显示”风格个人作品集网站(浮动药丸导航、像素字体部分标题配手绘波浪下划线、锯齿/撕纸效果分区、扇形卡片英雄区、模糊滚动展示、标志跑马灯、案例研究轮播)提供设计系统与构建规则。

portfolio 是什么?

这个技能定义了一套严格的视觉与动效系统,用于构建和维护一个具有独特“像素显示”风格的个人作品集网站。它强制规定了仅使用两种字体(像素显示字体和无衬线几何字体)、一种强调色(蓝色`#0B8DF8`)以及特定的圆角、分隔线和动效模式。其核心理念是确保网站所有新增内容(如节、组件或页面)都与原始设计完全一致,避免风格漂移。该技能支持在编辑、扩展或添加任何新内容时使用,包括用户上传图片或提出特定布局要求(如“添加一个版块”或“保持相同风格”)。它提供了完整的参考文件体系,包括设计令牌、组件库、动效规范和节模板,并包含了一个自检清单以确保每次修改都符合系统规则。配套的 `base.css` 文件已经实现了所有令牌和基础样式,可直接使用。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/mohammadNafia/portfolio/tree/HEAD/docs

在你喜欢的 AI 中提问

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

文档

Pixel Portfolio 风格

一套完整的视觉与动效系统。请严格遵循。当此文档未覆盖某情况时,请选择更安静、更圆润、更具几何感的方案——切勿引入新颜色、新字体、新圆角或新的缓动曲线。

不可妥协项(每次必读)

  1. 仅使用两种字体。 像素显示字体用于部分标题和英雄区关键词。无衬线几何字体用于其他所有内容。
  2. 仅使用一种强调色。 蓝色 #0B8DF8。次要按钮使用黑色 #111。别无其他。
  3. 每个部分标题:大写像素字体 + 手绘波浪 SVG 下划线,居中。
  4. 每个部分 在滚动时以相同的模糊渐入过渡方式呈现(参见 references/motion.md)。
  5. 圆角为药丸形或20px。 永远不要使用4px、8px或尖锐的角落(锯齿分隔线除外)。
  6. 无边框。 元素之间的分离通过 #F2F2F2 填充和柔和阴影实现,而非1px线条。
  7. 内容列居中,最大宽度1080px。 垂直间距充足(各部分之间120–160px)。
  8. 文案偏向小写且带自嘲/人性化, 避免企业腔。使用短句。

添加任何新内容时的工作流程

  1. 阅读 references/design-tokens.md → 使用 CSS 变量,不要使用原始十六进制值。
  2. 阅读 references/components.md → 检查该内容是否已存在相应模式(药丸、标签、卡片、部分标题、跑马灯、轮播、表单字段)。复用现有模式,不要发明第二种卡片样式。
  3. 阅读 references/motion.md → 应用标准的显示和悬停行为。
  4. 如果是全新的部分,阅读 references/section-recipes.md 并严格遵循“新部分模板”(间距、标题、显示、容器)。
  5. 交替使用 --bg / --bg-hero 作为部分背景色。如果两个相邻部分背景不同,在它们之间放置一个锯齿分隔线(绝不要使用直线)。
  6. 仅当该部分是顶级目的地时才在导航药丸链接中注册其 ID(最多4个导航链接;如果要添加第5个,请询问用户应移除哪一个)。
  7. 将任何新图像占位添加到 assets/IMAGES.md,并注明所需的确切宽高比,以便用户知道提供什么。

完成前的自我检查

  • 每个新标题是否都使用了像素字体 + 波浪下划线?
  • 是否有任何十六进制代码不在令牌列表中?删除它。
  • 是否有任何圆角不是 999px 或 20px / 16px / 14px?修正它。
  • 新块是否以 blur(10px) → 0 和 y: 30px → 0 的方式淡入?
  • 悬停状态是否使用了 scale(1.03) + 阴影抬高 + 250ms?
  • 移动端:扇形/轮播/网格是否按照 references/components.md 中的移动端规则折叠?
  • 是否保持了各部分垂直内边距为 clamp(80px, 10vw, 160px)?

参考文件

文件何时阅读
references/design-tokens.md始终——颜色、字体标度、间距、阴影、字体
references/components.md构建任何 UI 元素(导航、卡片、标签、表单、跑马灯、轮播、分隔线)
references/motion.md任何动画、显示、悬停或页面加载编排
references/section-recipes.md添加全新的部分或页面
assets/base.css即用型样式表,已实现所有令牌和基础样式
assets/IMAGES.md网站需要什么图像以及什么比例

相关技能