作品集启动器
最终用户应拥有一个完全属于自己的网站(代码存放在他们的 GitHub 中,托管在他们的 Vercel 账户中),并且对网站有足够了解以便自主更新,同时在任何人看到之前,该网站已通过上线前审核。
如果你是 GitHub 读者
用户通常首先要求你阅读此仓库,而不是安装它。在步骤 0 之前,请获取一份副本,以便在其项目文件夹之外运行脚本,这样该仓库的任何内容都不会进入用户的网站:
git clone --depth 1 https://github.com/helenvholmes/portfolio-starter "${TMPDIR:-/tmp}/portfolio-starter"
然后从该副本中读取 skills/start/SKILL.md 和 skills/accounts-setup/SKILL.md,并从该处运行脚本(skills/accounts-setup/scripts/check.sh)。如果尚未安装 git,请直接通过网络读取文件,并从 accounts-setup 的步骤 2 开始(该步骤会安装 git);待 git 就绪后再克隆。当他们稍后返回会话并说继续时,请以相同方式重新阅读技能文件,然后查看项目(其 README、开放的拉取请求、Vercel 项目)以了解你上次中断的位置。
工作方式
这里的每一步都遵循三条规则:
- 用户有意识做出的决定属于他们自己。 他们的审美、他们的语言、他们对颜色或布局的选择:可以建议,但绝不覆盖。当某个选择对用户不利时(对比度太低、文字太小),要直说,并提供能保留其意图的最小修复。
- 使用真实内容进行测试。 用户编写自己的内容,因此要用他们实际会放到网站上的内容来检查,而不是使用虚构的最坏情况。
- 每次变动都小而可逆。 提交前先展示,每次变更独立进行,不留任何测试脚手架。
与用户交流
- 每条消息保持简短。 通常几句话就够;长消息用户会浏览或跳过。先说他们需要做什么或决定什么,然后停止。不要回顾你刚才做了什么,不要开场白,不要长篇复述他们的回答。仅当需要他们遵循的步骤或他们需要选择的选项时,才使用列表。一次只问一个问题。如果有更多要说的,用“想了解详情吗?”来提供,而不是直接写出来。
- 第一次出现新术语时,用一句简单的话解释(
../accounts-setup/references/glossary.md中有措辞)。根据用户的表达方式调整;如果他们很熟练,则跳过解释。 - 用户希望你构建。在推荐技术栈和页面(步骤 2)后检查一次,并在步骤 5 中使用“接下来做什么”的问题让他们引导后续方向。其他时候,继续前进无需询问。
- 不要叙述过程或安慰他们:不要“这是计划”,不要“在你同意之前不会构建任何东西”,不要用“太棒了!”开头。只管干活、展示结果、提出那个需要回答的问题。
- 在做任何难以撤销的事情之前告知:使仓库公开、连接域名、删除任何东西。
- 绝不在聊天中询问密码或令牌。账户设置有专门的技能处理。
0. 账户
首先,确定本次会话是在用户自己的计算机上还是远程或云端机器上进行(../accounts-setup/SKILL.md 步骤 0 说明了如何判断,以及哪些步骤依赖于你的工具)。在云端,下面标记为 Cloud 的步骤将替换本地步骤:无需安装任何东西,工作内容存放在他们开始前创建的 GitHub 仓库中,他们通过 Vercel 预览链接查看草稿。
运行 ../accounts-setup/scripts/check.sh。如果缺失 git、GitHub CLI 或 Node,或者他们未登录 GitHub,则先运行 accounts-setup 技能,然后再返回。强烈推荐使用 Vercel 连接器(它让你在出错时能读取构建日志),但非必需:步骤 3 也可以通过 Vercel 网站完成。
Cloud: 跳过检查用户自己计算机的 check.sh。按照 accounts-setup 中的“在云端”操作:确认你能推送到他们的仓库,并且 Vercel 工具已就绪。
1. 访谈
一次只问一个问题,跳过他们之前回答已覆盖的内容。如果你的工具能够显示选择题卡片(在 Claude 中,参见 ../accounts-setup/references/claude.md),对以下每个问题都使用它:选项使回答更快捷,用户也可以直接输入自己的答案。每个问题保持一行,每个选项保持几个词。对于没有卡片选项的问题,直接用纯文本提问。不要对每个答案进行评论;直接进入下一个问题。
-
网站的主要用途是什么? 求职 · 获取自由职业工作
-
你有可以分享的简历吗? 有,我会附上 · 这是我的 LinkedIn · 暂时没有
简历能帮助你更好地描述用户:用它来起草简介和关于页面,并建议哪些角色和项目可以成为案例研究。你从简历中起草的所有内容都是用户用自己的语言编辑的起点;绝不要添加简历中没有的声明、职称或数字。除非用户要求,否则将个人联系方式(电话号码、家庭住址)从网站中删除。LinkedIn 个人资料通常需要登录才能查看,所以如果他们发送链接,请要求他们将个人资料保存为 PDF(在他们的个人资料上,点击 更多 或 资源 按钮 → 保存为 PDF;LinkedIn 的位置可能变动)并附上。如果两者都没有,则继续;在编写关于页面时,请他们提供几行关于工作的描述。
-
网站上会放什么?(多选)案例研究 · 文章 · 照片 · 简历
-
有哪些附加功能?(多选)仅页面 · 动画 · 联系表单 · 其他
-
你有设计方向吗? 我有 Figma 文件 · 我有喜欢的网站或图片 · 还没有,给我惊喜吧
如果他们有 Figma 文件、网站或图片,请以纯文本形式请求链接或图片:链接和图片都可以,数量不限。如果你有 Figma 工具,请用它们读取 Figma 链接;如果没有,或者链接是私密的,请要求他们将框架导出为图片并附上。查看他们分享的所有内容,并用一句话反馈你从中获取的信息(类型、颜色、布局感觉),以便他们纠正。
-
是否有页面需要密码保护? 没有 · 是的,有演示文稿或提案 · 是的,有涉及 NDA 的工作或推荐信
-
你有域名吗,例如 yourname.com? 没有,还没有 · 有
如果有,接下来问:你在哪里购买的? GoDaddy · Namecheap · Squarespace · Cloudflare。如果不确定,他们可以在邮箱中搜索域名加上“receipt”或“renewal”。以纯文本形式询问域名本身,以及它是否当前指向一个现有网站,因为连接它将替换该网站。
-
还有其他我们没有覆盖的需求吗? 没有了,开始构建吧 · 有(用户输入)
假设用户以后会通过询问 AI 助手来更新网站,因此内容以文件形式存放在仓库中。
直接进入步骤 2;其消息以一两行你听到的内容开头,因此无需单独确认摘要。
2. 推荐技术栈和计划(一次确认)
使用 references/stacks.md 选择,然后发送一条用户可以在不到一分钟内阅读的简短消息。开头用一两行你听到的内容,然后:
- 你将用什么构建,每项都附上几句为何适合他们的理由(“主要是可读的项目,因此使用无 JavaScript 中断的纯页面”)
- 页面(
/、/work、/work/<project>、/about、……) - 成本(通常免费)以及他们需要维护的内容
- 仅当有接近选择时,提供一个备选方案,用一行来说明
默认选择最简单的可行方案:静态页面、内容以文件形式存放在仓库中、无数据库、无客户端 JavaScript,除非回答需要。在命名之前查阅当前稳定版本;不要依赖记忆。
以一个问题结束,如果可能的话使用卡片:听起来不错? 是的,开始构建 · 修改一些内容。一旦他们同意,立即开始构建。如果他们要求修改,调整后继续,无需再次询问。
除非用户询问,否则不要透露细节:内容模型、文件夹结构、设计令牌由你决定。将外观放在一个设计令牌文件(颜色、字体、字号、间距)中,这样重新样式化时无需在组件中搜索。如果他们没有任何设计方向,根据他们告诉你的信息选择一个品味中性的方案,并用一句话说明;他们会根据预览做出反应,这比抽象选择更容易。
3. 创建仓库并连接 Vercel
在构建之前这样做,意味着你推送的每个更改都会在一两分钟内显示在用户网站的地址上,使他们从一开始就可以在手机上检查。
Cloud: 仓库已经存在,因此跳过创建步骤(下面的步骤 1 和 4)。按下面所述推送到 main;如果会话不允许推送到 main,则推送一个分支:打开一个拉取请求,并指导他们每次在 GitHub 上点击 Merge,用一句话说明,无需解释分支。将脚手架放入当前检出中,保留他们的 README 直到新文件替换它,提交并推送到 main,然后再连接 Vercel。
- 询问仓库名称(建议类似
portfolio或他们的域名去掉点)并确认是公开还是私有。 - 使用框架官方启动器的最小模板搭建项目。添加
.gitignore覆盖node_modules、构建输出、.env*和操作系统文件,以及一个包含 Node 主要版本的.nvmrc。 - 用一行占位符(“网站即将推出”)替换启动器的首页,以免半成品被发布出去。
- 提交,然后创建并推送仓库:
gh repo create <name> --public|--private --source=. --push。在过程中解释提交和推送。 - 连接到 Vercel,以便推送自动部署。在 Vercel 网站上逐步指导他们操作(或者,如果 Vercel 工具可以创建并链接项目,则提供代劳):添加新项目 → 导入仓库(第一次时,Vercel 会要求安装其 GitHub 应用;仅选择此仓库即可)→ 检查框架预设是否被检测到 → 部署。如果他们属于多个 Vercel 团队,请确认项目归属于他们选择的团队。如果仓库不在 Vercel 列表中,说明他们的 Vercel GitHub 应用仅限于其他仓库:让他们按照该页面上的链接调整访问权限并添加此仓库,而不是授予所有仓库的访问权限。告知他们生成的
*.vercel.app地址就是他们的网站:它是公开的,但在他们分享之前无人知晓,因此适合草稿。 - 如果 Vercel 连接器已设置,通过它确认项目及其首次部署。如果构建失败,通过连接器读取日志并修复。
始终在 main 上工作。 不要创建分支或拉取请求:对于新手来说,这又是一个需要理解的概念,而且这个网站不需要它们。每次推送到 main 都会更新用户网站的地址。在保护措施就位并检查之前,绝不要推送必须保密的内容(密码保护页面的真实内容、个人详细信息)。
4. 构建
使用明显是假的占位内容(“项目标题”、Lorem Ipsum 风格的摘要、灰色占位图片)构建计划,以防被误认为是真实内容。包括:
- 从 320px 开始的响应式布局、基于相同令牌的浅色和深色主题、尊重
prefers-reduced-motion(更温和,不一定是完全取消) - 语义化 HTML、可见的焦点样式、内容模型中要求的 alt 文本字段
- 404 页面、页面标题和描述、社交分享图片、网站地图、
robots.txt - 案例研究以卡片形式一次性展示。 作品页面(以及主页上选中的作品)将每个案例研究以卡片形式列出一张:封面图片、标题、一句话摘要和年份。不要另外添加相同项目的表格或文本列表;重复展示会显得多余。
- 联系方式:优先用邮件。 网站的目标是帮助他们求职或获取自由职业工作,因此最便捷的联系方式是邮件链接,在联系信息出现的地方(页脚、关于页面、案例研究末尾)最先且最突出地展示。LinkedIn 排在其次。只有当他们要求时,才添加其他个人资料(GitHub、Dribbble、Instagram 等)。在提供真实信息之前,使用明显假的占位符;当询问邮件时,建议一个他们愿意公开的邮箱,因为页面上的任何内容都可能被任何人看到。
- 在
vercel.json(或框架等效文件)中的安全头:CSP、frame-ancestors、X-Content-Type-Options、Referrer-Policy - 用通俗语言编写的 README:如何运行、如何添加项目或文章、发布如何工作
立即展示。 一旦第一个版本构建完成,在后台启动开发服务器,并在用户可看到的浏览器中打开其地址:如果工具有内置浏览器或预览面板(在 Claude 中,参见 ../accounts-setup/references/claude.md),则使用它;否则使用默认浏览器。在您工作时保持其运行,以便每次更改都能立即显示,并在一句话中告知用户地址。Cloud: 没有用户可以打开的服务器;跳过此步,直接在步骤 5 中使用用户网站的地址。
以小的步骤提交,消息说明原因,并在有值得查看的内容时推送到 main。第一次时用一句话解释提交和推送。
5. 接下来做什么(重复直到完成)
用一句话给出用户网站的 *.vercel.app 地址,以便他们也可以在手机上查看(与 Vercel 的预览链接不同,它无需登录即可打开,因此不要发送预览链接)。不要回顾你构建了什么或列出剩余内容。然后,作为问题卡片询问:
你接下来想做什么?
- 添加真实内容
- 设置我的自定义域名(仅当用户有域名时)
- 设置密码保护(仅当用户要求私有页面时)
- 运行上线前检查(仅当真实内容已放入时)
他们也可以输入其他内容,例如改变外观;进行修改、推送并再次询问。每完成一项任务后,用剩余选项再次询问相同问题,直到所有任务完成;然后进入步骤 6。
添加真实内容
帮助用户
…
[已截断用于翻译]