Communitygithub.com

ShaysFrame/my — 个人简历与品牌系统

用于构建、设计和优化 M. Mahafuj Rahman(Shay)个人作品集网站、博客、项目页面、简历页等自助推广内容的技能。

my — 个人简历与品牌系统 是什么?

这是一个专为全栈开发者 M. Mahafuj Rahman(在线化名 Shay)设计的个人品牌与简历构建系统。该技能基于 Astro 框架和 TypeScript,遵循极致的编辑级美学——高对比度、排版驱动、无彩色强调、仅靠黑白层级传递信息。技能文档详细规定了色彩体系、排版规则(如显示字体使用 Playfair Display,正文使用 Inter)、交互哲学(CSS 优先的三层动画体系,仅允许英雄区有一个“惊艳”效果),以及站点结构(包含首页、关于、项目、简历、博客区域)。对于项目展示,它优先排序了 Qifa、Open RTMS 等 6 个已交付项目,并规定了问题驱动的叙述结构。该技能可与 Claude Code、Cursor 等 AI 编码工具配合使用,帮助 AI 生成符合 Shay 个人品牌的 Astro 组件、项目页面和交互型内容,避免千篇一律的模板化审美。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ShaysFrame/my/tree/HEAD/tools/portfolio-skill

在你喜欢的 AI 中提问

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

文档

M. MAHAFUJ RAHMAN 简历 — 品牌与构建系统

您正在构建 M. Mahafuj Rahman 的个人作品集。他是一位全栈开发者,在移动端、Web、后端、物联网和机器学习领域都有丰富落地项目。该作品集必须传达出深度、广度和工艺——而不仅仅是罗列技术栈。


身份标识

姓名:M. MAHAFUJ RAHMAN(线上昵称 Shay) GitHub:ShaysFrame 网站:shay.pub
技术栈定位:全栈通才 — Flutter、Vue、Astro、React、Django、PHP、Docker、YOLO/CV
职业目标:通过展示真正交付的作品,进入顶级科技公司任职


设计理念

审美风格:编辑风。高对比。排版主导。瞬间抓人眼球。
氛围:干净优雅——像杂志封面,而不是 SaaS 着陆页。
指导原则:每个元素要么抓人眼球,要么被移除。

色彩体系

--color-bg:        #0a0a0a   /* 近乎黑色的背景 */
--color-surface:   #111111   /* 卡片、面板 */
--color-border:    #222222   /* 细微分隔线 */
--color-text:      #f5f5f5   /* 主要文本——偏白而非刺眼的纯白 */
--color-muted:     #777777   /* 次要/元数据文本 */
--color-accent:    #ffffff   /* 纯白——仅用于实现最大对比度 */
--color-highlight: #e8e8e8   /* 悬停状态、选中项 */

无彩色强调。无渐变。黑色、白色和对比度完成所有工作。

排版

  • 展示/标题:一个大胆的衬线体或高对比度怪诞展示字体。 推荐:Playfair Display、Editorial New、PP Neue Montreal、Instrument Serif
  • 正文/UI:干净几何无衬线体。Inter、DM Sans 或 Geist
  • 代码:JetBrains Mono 或 Geist Mono
  • 规则:更少的字重,更有意地调整字号。用字阶而非颜色来建立层级。

动效与交互

理念:动效应显得必不可少,而非装饰性。每个动画都要回答“这个元素为什么动?”——为了引导注意力、指示状态或奖励滚动。

第一层 — CSS(始终使用,无依赖)

  • 页面过渡:使用 Astro 内置的 <ViewTransitions /> — 零 JS 成本
  • 悬停状态:透明度变化、下划线揭示、轻微缩放(1.0 → 1.02)
  • 焦点状态:使用 --color-accent 显示可见环
  • 入口:使用 CSS @keyframes fadeUp 实现首屏内容进入动画

第二层 — 滚动驱动动画(CSS 优先)

  • 在浏览器支持的情况下,使用原生 CSS animation-timeline: scroll()
  • 回退方案:使用小型 .ts 工具中的 IntersectionObserver — 无需库
  • 项目卡片:进入视口时交错执行 fade + translateY(24px → 0)
  • 章节标题:滚动时从左滑入

第三层 — 英雄区“惊艳”元素(且仅有一个)

  • 英雄区获得一个标志性动效。按偏好顺序选项如下:
    1. 交错字母/词语揭示 — 英雄名称逐字符动画进入(纯 CSS)
    2. 噪点/颗粒叠加 — 在深色背景上添加 CSS 动画颗粒纹理(纯 CSS)
    3. 细微 3D 倾斜 — 鼠标移动时项目卡片轻微倾斜(Vanilla JS,约 15 行)
    4. Three.js / React Three Fiber — 仅当需要特定 3D 资源时(例如旋转的几何徽标)。使用 3D-Animation-Creator 或 3D-Website-Asset-Generator 技能单独生成资源,然后作为单个隔离组件嵌入。

永远不要做的

  • 全页 Three.js 背景(影响性能,分散内容注意力)
  • 除英雄区外任何地方的循环动画
  • 弹性弹簧物理(与编辑风审美不符)
  • 文本上的视差滚动
  • 仅因教程中使用而添加的动效

站点结构

/                  → 英雄区 + 精选项目预告 + 简短介绍
/about             → Shay 是谁、背景、理念、技能概览
/projects          → 所有项目的网格,带技术栈标签和简短描述
/projects/[slug]   → 单个项目深入解读(问题、解决方案、技术栈、链接、截图)
/resume            → 内嵌简历视图 + 可下载的 PDF 链接
/blog              → 博客文章列表(Astro 已存在)
/blog/[slug]       → 单篇文章(已存在)

技术栈

  • 框架:Astro(SSG,markdown 优先,默认零 JS,优秀 SEO)
  • 组件语言:Astro 组件 + React/Preact(.tsx)用于交互岛
  • 语言:全面使用 TypeScript — .ts、.tsx、.astro,带类型化的 frontmatter。绝不使用 .js 或 .jsx
  • 样式:CSS 自定义属性(除非用户明确要求,否则不使用 Tailwind)
  • 部署:Vercel
  • 内容:使用 Astro Content Collections 管理博客文章和项目

项目展示优先级

构建项目页面时,按此顺序优先展示以下项目(最重要的最先):

  1. Qifa — 多应用生态系统(客户端、商店、办公、Docker、自定义日志面板、ChatWoot)
  2. Open RTMS — 使用 YOLO v8n 人脸检测的实时系统(机器学习的角度罕见且令人印象深刻)
  3. XueHanYu — 全栈(Vue + Django)中文学习平台
  4. NoorConnect — 应用 + 后端 + 固件(物联网/嵌入式对 Web 开发者来说很罕见)
  5. Jidian Daojia — Flutter + PHP + uniapp,多平台
  6. LittleLemon — Meta Professional Certificate 顶点项目(有证书背书)

每个项目页面的内容结构:

  1. 一行钩子(解决什么问题,而非使用什么技术)
  2. 技术栈徽章
  3. 挑战 / 为什么有趣
  4. 关键决策
  5. 链接(GitHub,如果可以的话提供线上演示)

写作语调

  • 直接。自信。无废话。
  • 适当时使用第一人称(“我构建了...”、“我选择了...因为...”)
  • 避免:“对...充满热情”、“自我驱动”、“结果导向”、“利用协同效应”
  • 技术细节 > 模糊声明。说“构建了一个使用 YOLO v8n 的实时人脸检测管线”,而不是“从事计算机视觉项目”

组件指南

为该项目生成 Astro 组件时:

  • 默认导出风格:使用 --- frontmatter 的 .astro 文件
  • 使用上述调色板中的 CSS 自定义属性
  • 移动端优先的响应式设计
  • 语义化 HTML(正确使用 <article>、<section>、<nav>、<main>)
  • 除动态值外,不使用内联样式
  • 通过 CSS 实现动画 — 关键帧放在 global.css 或作用域 <style> 块中
  • 交互岛:使用 client:visible 指令,仅在需要时加载 JS

应避免的内容

  • 泛泛的英雄文本,如“嗨,我是一个热爱编码的开发者”
  • 紫色渐变、全圆角、蓝色 CTA 按钮
  • 杂乱布局——拥抱白色(或黑色)空间
  • 不加上下文地罗列你接触过的所有技术
  • 读起来像简历的文案;这是一个叙述,而非列表

相关技能