Communitygithub.com

作品集构建

根据一个内容文件和三种经验证的页面网格之一,构建或重建设计师的作品集网站,让审阅者在30秒内理解全貌。适用于任何想创建作品集网站、启动个人设计作品网站、重构现有作品集、将项目图像文件夹或Behance/Dribbble/Notion页面转化为自有网站、选择作品集布局或网格,或应用作品集审计修复的场景。面向设计师、艺术总监、设计主管、插画师、动效与3D艺术家、摄影师及电影制作人。

作品集构建 是什么?

这个技能专注于快速构建一个高效的设计师作品集网站,其核心理念是:访客首次访问时只有大约30秒的时间来理解你是谁、你做什么以及如何联系你。它通过强制使用一种经过验证的页面结构(三种网格之一:固定头像加全宽作品、均匀双列网格、或每个项目一个长案例研究)来解决“结构”问题,而将“外观”(字体、颜色、圆角、间距)完全交给用户自行定义。该技能从一个单一的 `portfolio.json` 文件读取所有内容(个人信息、项目、所选网格和主题),并通过一个Python脚本 `scripts/build.py` 生成一个无需框架的静态HTML/CSS网站。生成后,脚本还会输出一个“30秒审计”检查清单和所有未填写的占位符(slots),明确告知用户下一步需要完成的任务。它支持所有主流设计领域,并提供清晰的步骤指南,包括确定作品集目标、让用户选择网格、编写高质量的内容、设置视觉风格以及最终的交付与发布建议。

兼容平台~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/adrituyo/30s/tree/main/skills/portfolio-build

在你喜欢的 AI 中提问

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

文档

作品集构建 是做什么的?

一个作品集第一次访问大约只有30秒。这个技能构建的网站能够充分利用这30秒: 第一屏展示你是谁、你做什么,旁边是真实作品,每个项目中你的角色清晰陈述, 以及一个明确的联系方式。

它修复结构,将外观留给用户。三种网格决定了内容的摆放位置和顺序。 字体、颜色、圆角半径和间距由用户在一个小模块中自行设置。 用这个技能构建的两个作品集应该阅读方式相同,但外观截然不同。

以下路径均相对于此技能的文件夹。

工作原理

一个文件 portfolio.json 包含了所有内容:用户是谁、项目、所选网格和外观。 一条命令即可将其转换为静态网站(纯HTML和CSS,无框架,无需安装):

python3 scripts/build.py path/to/their-site/portfolio.json

网站会生成在内容文件旁边。脚本随后会打印两个列表:一个是30秒审计仍然会标记出的问题, 每一行都关联到一个规则编号(references/rules.md 中每条规则占一行); 另一个是每个仍然等待填入事实的[slot](占位符)。将两者都视为待办事项列表。

步骤

1. 确定作品集的用途

询问,或从已有信息中推断出:

  • 目标。 作品集面向的角色或客户。它决定了标题、项目顺序以及哪些内容可以省略。
  • 作品。 哪些项目,以及每个项目:它是什么,用户的角色,为谁做的,年份,用户做的一个关键决定, 以及结果如何。
  • 素材。 图片和视频的存放位置。

如果用户已有现有网站,请先阅读并沿用其中内容。如果 portfolio-audit 技能可用并且用户有一个在线网站, 先运行它可以准确告诉你需要修改什么。

只询问你找不到的信息。一个拥有图片文件夹和LinkedIn页面的用户已经提供了大部分信息。 如果没有人在那里回答,就利用已有信息继续,并使用占位符(第3步)。

用户不确定的素材(如速写本、学生项目、旧作品)应排除在外。他们对此有疑虑是有原因的, 因为作品集是根据其最薄弱的作品来评判的。说明你排除了哪些内容以及原因。 三个强有力的项目就是一个完整的作品集;不要为了凑数而增加到四个。

2. 让用户选择网格

阅读 references/grids.md。它描述了三种网格以及每种适合的用户。网格决定了整个网站的阅读方式, 因此这是用户的选择,而不是你的选择。你的任务是让这个选择变得简单。

在构建之前,用一条简短信息列出三种网格名称,每行一个,说明你推荐哪种网格以及原因 (基于他们的作品和目标),并询问他们想要哪种。将其与第1步中需要询问的其他问题合并在一起, 这样只有一轮问题,而不是两轮。

  • 如果他们已指定了网格,直接使用,不要重新讨论。
  • 如果他们选择了与你推荐不同的网格,按照他们的选择构建。如果会带来什么影响(例如,index 网格 没有地方放置“决策”和“结果”),说明一次,然后放弃争论。
  • 如果对方不确定,或者没有人回答,就按照你的推荐继续,并在第5步中使用 --compare 参数构建, 这样三种网格都可以并排打开查看。

切换网格只需修改文件中的一个词,所以不会被锁定。这是轻松提供选择的原因,而不是跳过它的理由。

3. 编写内容文件

复制 assets/example/portfolio.json 作为起点,并阅读 references/content.md 了解每个字段。\n将其放入将成为网站的文件夹中,图片也放在旁边。示例使用了 case 网格; 对于 index 和 columns 网格,decision 和 result 是可选的,并且很少需要 before/after 行。

如何编写最重要的部分:

  • 标题: 一句话,说明他们做什么以及为谁做,并包含一个事实。这句话不能适用于其他任何人的作品集。 “金融科技应用的产品设计师。八年经验,最近担任Ledger储蓄流程的负责人。” 而不是“热爱打造体验的多领域创意工作者。”
  • 证明: 标题后面紧跟着的三到四个最强的名称或数字。
  • 排序: 最符合目标的项目排第一,无论其日期。四到八个项目。 次要领域(艺术总监的电影作品、产品设计师的插画)最好作为另一个网站(使用独立的内容文件),而不是混在一起。
  • 每个项目: 一行摘要、角色,以及是为客户、雇主还是个人概念所做。对于产品和领导力目标, 添加决策和结果。
  • 角色: 他们当前的职位名称,按原样写,不要写他们正在申请的职位。
  • 行动号召: 在邮箱上方用一句话说明写信是为了什么。
  • 语言: 用读者所使用的语言编写,并设置 site.lang。模板本身的语言(Index, Facts, Next…) 支持英语和西班牙语;对于任何其他语言,请在 labels 中设置。

只使用用户提供的事实或在其现有页面上出现的事实。你自己推断出的事实(例如从文件名读取的客户名称) 可以使用,但必须告知用户这是推断出来的,以便他们确认。

如果某个事实缺失,请用方括号写一个占位符([year]、[team size]、[what shipped])。 占位符会原样显示在网站上,并且构建脚本会列出每一个,所以:

  • 保持标题中没有占位符:用你已知的信息来写。第一句中的占位符是访客读到的第一件事。
  • 如果整个字段未知且为可选项(city、team、site.url),则省略该字段。
  • 对于没有结果的工作,说出真实情况:“于2024年交付;我没有具体数据”、“概念设计,未上线”。 这也是一个结果。空泛的影响承诺则不是。
  • 含有占位符的网站是草稿。在交付时明确说明这一点。

带有诚实空白的作品集是可以接受的。带有虚构客户的作品集在面试中会是一个问题。

4. 设置外观

在 theme 模块中:明亮或暗色模式、一种强调色、字体、圆角半径、图片间距。 如果用户有品牌或现有网站,则从中获取这些设置。如果他们没有,选择一种适合其作品的字体和强调色, 并说明你的选择。不要复制示例或其他设计师网站的外观。

一种并非所有设备都自带的字体需要 font_url 来加载;仅设置 font 名称会回退到系统字体。 要么两者都指定,要么选择一个系统字体堆栈。

5. 构建、查看、修复

运行构建脚本。如果用户尚未选择网格,请添加 --compare 参数:

python3 scripts/build.py path/to/their-site/portfolio.json --compare

这还会将相同的内容以所有三种网格写入 compare/ 文件夹,并附上一个链接页。 向用户展示该页面,让他们选择。compare/ 仅用于选择:发布前请删除。

然后,在浏览器中以桌面和手机宽度查看(如果可以):在站点文件夹中启动 python3 -m http.server(case 网格链接到项目文件夹,需要服务器), 并亲自检查第一屏:姓名、做什么、证明、联系方式以及一个真实作品,无需滚动。

如果无法打开浏览器,请在交付时说明,并至少将标题和证明控制在约45个单词以内, 这将适合在手机屏幕上第一张图片之上显示。

逐一处理脚本打印的列表。修复你可以从内容层面处理的问题(缺失的角色描述、过大的图片、 过长的标题)。将剩余部分作为一份简短的清单交给用户,说明只有他们才能提供。

6. 交付

告知用户:使用了哪种网格,以及是他们自己选择的还是你推荐的(如果你构建了 compare/, 也要说明其他两种网格只需修改一个词即可切换,或者 compare/ 文件夹中已有); 你撰写了什么标题;你排除了哪些内容;任何你推断出的信息;仍需填充的占位符; 审计列表仍然显示的问题;以及如何修改内容(编辑 portfolio.json,再次运行构建)。 该文件夹是一个完整的静态网站:可以按原样上传到任何静态主机发布。

有两件事只有他们才能提供,因此在此处询问:网站将要使用的地址(site.url), 以及用于链接预览的 1200×630 图片(site.share_image); 使用第一个项目中最佳图片的裁剪版即可。

图片

  • 导出时宽度最多 2000 像素,格式为 AVIF 或 WebP,每个文件不超过约 500 KB。构建脚本会对较大的图片发出警告。 JPEG、PNG 和 SVG 也支持。
  • 当文件成对命名时,会自动使用较小尺寸的手机版图片:内容文件中使用 shot-lg.jpg, 旁边放置 shot-sm.jpg。具有相同名称的 .avif 文件将优先提供给支持它的浏览器。
  • 为每张图片提供 alt 属性,说明其内容。如果没有提供,将使用项目标题,这对于搜索引擎或 AI 助手提供的信息非常少。如果你没有看到图片,请说明每张图片对应哪个作品,并请用户描述它们。
  • 短视频循环(.mp4、.webm)可以作为平铺网格展示。它们默认静音播放,仅在屏幕可见时播放。 为它们提供 ratio 属性。

不应做的事

  • 不要添加开场动画、加载器、自定义光标或延迟内容显示的滚动效果。模板设计的目的就是让第一屏立即显示。
  • 不要将项目标题隐藏在悬停效果后面。手机没有悬停状态。
  • 不要移除“停靠栏”——这个包含姓名和邮箱的小栏目在联系区滚动移出屏幕后出现。 审阅者可能在浏览项目中途决定写信,而不是在页面末尾。
  • 不要用过程图片(便利贴、人物画像)来填充薄弱的作品。一个清晰陈述的决策比什么都重要。
  • 不要手动编辑生成的 HTML:下次构建会覆盖它。如果需要改变结构,请修改内容文件, 或者修改 assets/template/ 中的模板。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相关技能