Communitygithub.com

hackathonstarterkit

为一个黑客马拉松项目生成独特的、面向招聘人员的作品集网站,即使项目本身不是网页应用(如硬件、机器学习模型、命令行工具或研究项目)。利用 Anthropic 的前端设计技能,为每个项目打造独一无二、非模板化的设计。

hackathonstarterkit 是什么?

该技能旨在将黑客马拉松项目转化为一个专业的、面向招聘人员的一页案例研究网站。它擅长处理非传统项目(硬件、机器学习模型、CLI、移动应用、研究),并确保每个网站都具有独特的设计,避免使用通用模板。技能通过集成 Anthropic 的 `frontend-design` 技能来实现这一点,该技能要求从项目本身的世界观中提取色彩、字体和布局,从而创造出独一无二的视觉风格。技能的工作流程包括:首先确保 `frontend-design` 可用,然后全面收集项目事实(包括来自黑客松的活动照片),接着通过 `frontend-design` 的设计循环进行设计,根据项目类型选择最合适的展示方式(如为硬件项目展示系统图和现场视频,为机器学习模型提供交互式推理小部件),最后构建一个符合搜索引擎优化和可访问性要求的静态网站。此技能适用于 Claude Code、Cursor 和 Codex 等 AI 代理平台,帮助开发者快速制作出能有效打动招聘人员的项目作品集。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/IdkwhatImD0ing/hackathonstarterkit/tree/HEAD/skills/portfolio-builder

在你喜欢的 AI 中提问

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

文档

作品集构建器

为一款黑客马拉松项目打造一页、面向招聘人员的展示网站。即使项目本身并非网页应用(如硬件搭建、机器学习模型、命令行工具或研究项目),该网站也是最终交付物,通过视频、图表、照片和交互式复刻来展示成果。力求达到以下案例网站的水准:dispatchai.art3m1s.me、talktuah.art3m1s.me、slugloop.com 和 adapted.art3m1s.me。每个网站都截然不同,因为每个设计都源于项目自身的世界。这种独特性是核心要点,也是该技能依赖前端设计技能而非固定模板的原因。

第 1 步:让设计引擎可用

设计来源于 Anthropic 的 frontend-design 技能,它能确保最终效果不是千篇一律的 AI 生成页面。在设计任何内容之前,必须使其可用。

这是用户的前提条件,而非代理本身能做到的事,因为代理无法运行斜杠命令。如果 frontend-design 已出现在你可用技能列表中,则已完成准备。如果没有,请要求用户在 Claude Code 中通过运行以下两个命令来安装插件:

/plugin marketplace add anthropics/claude-plugins-official
/plugin install frontend-design@claude-plugins-official

第一行命令仅在尚未添加该市场时才需要。Claude 在处理前端工作时也会自动应用 frontend-design,因此其原则可能已在发挥作用,但仍需请用户确认插件存在,而非假定。第 3 步中的所有设计决策都将通过它进行。

第 2 步:收集事实

先检测,后询问。读取 AGENTS.md、PRD.md、README、package.json 以及仓库中已有的任何照片、截图或图表。然后仅询问缺失的信息:

  • 项目名称和一句能点明利害关系而非技术的标语。
  • 项目类型:网页应用、硬件或 IoT、机器学习模型、CLI 或开发者工具、移动应用、或研究与数据。这决定了你在第 4 步如何展示它。
  • 问题,附带一个真实统计数据及其来源。
  • 功能:三到五项核心能力。
  • 工作原理:足够用来绘制架构图的系统描述。
  • 证据:演示视频(YouTube)、线上地址、Devpost、GitHub、媒体报道,以及任何开源工件(模型、数据集、Figma)。
  • 活动媒体:黑客马拉松现场的随手拍照片和剪辑,仓库中几乎从不包含这些。明确要求提供团队和搭建过程中的照片、演示日或舞台及获奖照片、白板或餐巾纸草图、以及场地,并说明这些文件的位置(手机、共享网盘、Devpost 图库)。这些是让网站显得真实的关键,因此需要主动请求,而不是假定仓库中已有。如果没有任何素材,则退而求其次使用截图、图表和演示视频。
  • 成果:奖项和名次、赛事名称和日期、规模与排名、搭建时长、团队规模,以及任何指标(提交次数、延迟、用户数)。
  • 团队:姓名、角色、GitHub 账号、LinkedIn URL 和头像。

绝不捏造奖项、统计数据、奖品、排名或引文。如果在询问后仍未知晓某事实,则省略该部分,切勿猜测。

第 3 步:通过前端设计进行设计

向 frontend-design 提供基于第 2 步整理的摘要,并运行其完整循环:构思、探索、规划、批评、构建、再批评。其核心规则在此适用:从主题中衍生外观,而非使用默认值。为此项目生成一个紧凑的专属令牌系统:

  • 调色板:4 到 6 个命名的十六进制值,取自项目世界。911 调度员项目读起来应是警示红与琥珀色搭配近乎黑色;语音银行读起来应是信任蓝;UCSC 自行车网格搭建读起来应是陈旧的“野外日志”档案色调。
  • 字体:一个富有特色的展示用字体(适度使用),一个互补的正文字体,以及一个用于数据的实用或等宽字体,需有意搭配,而非每个项目都用相同的字体家族。
  • 布局:遵循第 5 步框架的滚动叙事式单页。
  • 动效:一个服务于主题的精心编排的动效时刻,例如由滚动触发的架构揭示或遥测回放。分散的动效看起来像是 AI 生成的,因此将动效集中在一点。这区别于第 6 步中关于减少动效的可访问性基线。
  • 标志:整个网站中最令人难忘的单一元素,体现该项目。Dispatch 有一个嵌入的、运行在种子数据上的交互式操作控制台;Slugloop 有“接收器不再 ping”的档案框架;AdaptEd 有编号的学习循环。

frontend-design 带来的两条防护措施:

  • 避免默认的 AI 外观,除非项目的世界确实需要: (1) 奶油色背景配高对比度衬线字体和赭石色点缀,(2) 近乎黑色背景配单一酸绿色或朱红色点缀,(3) 宽版报纸风格的发际线规则、零边框半径和密集列。如果你的调色板和字体计划不经思考就落入了其中一种,请修改并说明原因。
  • 结构即信息。 仅当编号标记、标题和分隔符编码了真实内容(如真实序列——AdaptEd 的循环)时才使用它们,切忌作为装饰。第 5 步框架中的编号是创作清单,而非强制性的视觉处理方式。

分区标签本身也是设计的一部分。框架是底层结构;将其标题改写为项目的语气(例如“现场日志”替代“展示”,一句符合项目世界观的话替代“坦诚的局限”,如果适合主题则编号为 01 到 0N)。在构建之前先运行“规划-然后-批评”的关卡:如果任何选择看起来像是你会为任何类似项目生成的设计,则进行修改。只有当计划确实针对此摘要时,才开始构建。

第 4 步:选择展示方式

无论项目是什么类型,网站都应展示其成果。通用的最低标准是演示视频加上项目的核心工件,无论是素材、照片、遥测回放、评估图表还是终端回放。然后根据项目类型选择主要的展示手段:

  • 网页应用:嵌入一个运行在种子数据上的交互式小部件或控制台(如 Dispatch 的操作控制台),仅在无法实现交互性时才退而使用只读视图。
  • 硬件或 IoT:搭建照片、接线图或系统图、现场素材、以及地图或遥测回放(Slugloop)。
  • ML 模型:交互式推理小部件或对比图,加上评估数据和 Hugging Face 链接。
  • CLI 或开发者工具:终端回放(asciinema 风格)或动画命令序列。
  • 移动应用:带设备边框的视频或可点击的界面流程。
  • 研究或数据:关键图表、图表和方法论图。

演示可以不止一个。在合适的情况下提供两种模式(如被动浏览加交互模式 —— TalkTuah),或者将早期原型片段与最终现场片段配对以展示迭代过程(Slugloop)。仅当真实后端无法在静态网站上运行时才模拟复刻;模拟时,需用真实数据填充并清晰标记为复刻。基于真实现场素材构建的硬件网站不需要模拟,也无需此类标签。

如果项目获得了真实的媒体报道,将其视为增加可信度的工具:将剪报渲染为卡片或出处标志,并附上引文和来源(Slugloop),而不是只给裸链接。

第 5 步:案例研究框架

单页滚动,面向招聘人员。将其视为一个菜单:仅在事实存在时才包含某个部分,并将其标题改写为项目的语气(见第 3 步)。此处的编号是创作清单,而非强制性的视觉风格。

  1. 英雄区(核心论点):以项目最具特色的元素作为开场,加上标语和主要行动号召(演示、Devpost、GitHub)。保持最高奖项或资质可见。
  2. 可信度条:名次、奖项、排名、领域规模。
  3. 问题:利害关系和一个有来源的统计数据。
  4. 功能:核心能力。能力卡片可以深层链接或滚动锚定到架构部分的相应位置,将“是什么”与“怎么做”联系起来(TalkTuah)。
  5. 工作原理:架构图或系统图,展示工程深度。
  6. 展示:第 4 步中选择的手段(交互式小部件、视频或视频集、照片、遥测回放)。在适用的情况下允许双视频或迭代视频块。
  7. 数据说话:一个由大幅数字和简短标签组成的醒目统计数据网格。可以将团队规模、搭建时间、提交次数和排名融合成一个标志性区块(Slugloop:4 名学生,36 小时,500 多次提交,前十名)。排名也可能出现在可信度条中。
  8. 媒体报道(可选):真实报道以剪报卡片或出处标志加引文和来源的形式呈现。
  9. 团队:简介,包括角色、GitHub 和 LinkedIn。
  10. 坦诚的局限:说明周末搭建项目的现状和局限性。说明权衡取舍体现的是成熟,而非弱点。
  11. 链接与来源:GitHub、Devpost、YouTube、模型或数据集、媒体报道。
  12. 页脚:在多少小时内于某某赛事中搭建,包含仓库和线上链接。

第 6 步:构建

  • 构建一个独立的单页网站,可静态导出并能在 Vercel 上部署,默认使用 Next.js(App Router)。如果项目已有技术栈,则与其匹配。将其放在独立文件夹(site/ 或 portfolio/)或单独的仓库中,以免与产品代码混淆。
  • 全程使用真实内容;无需 Lorem Ipsum。遵循 frontend-design 的写作指导:平实、具体、从读者的角度出发。
  • 保持一个无需声明的质量标准:响应式适配移动端、可见的键盘焦点、以及尊重减少动效的设置。
  • 涵盖 SEO 基础:包含关键词感知的标题和描述、规范 URL、Open Graph 图片、恰好一个 h1,以及语义化的分区。
  • 使用真实截图、照片和图表,包括第 2 步收集的活动媒体,放置于展示、团队和数据说话部分;如果发布了模拟复刻,请标记;演示视频使用 YouTube 海报。
  • 渲染后再次进行批评,按照 frontend-design 的指示:截图页面,重新提问“我是否会对一个不相关的项目也做出同样的外观?”,并通过删减一个不为项目目标服务的装饰元素来移除一件配件。

验证

  • 确保 frontend-design 确实被使用,且最终效果不像是通用的 AI 默认值,也未落入三种默认外观之一。在构建后应用其自我批评机制:你是否会对一个不相关的项目也做出同样的外观?
  • 只有一个 h1、语义化标题、移动端响应式、可见的焦点状态、遵守减少动效设置。
  • 每个奖项和统计数据均为真实,任何模拟复刻都已标记,每个链接都能正常跳转,演示视频已嵌入。
  • 在本地构建并预览;如果可行,检查 Core Web Vitals 或进行一次 Lighthouse 测试。

最终输出

  1. 网站:路径或路由,以及如何运行。
  2. 设计系统:调色板、字体搭配、动效时刻和标志性元素,并各用一句话说明为何适合此项目。
  3. 展示手段:你使用了哪一种及其原因(适合项目类型)。
  4. 使用与省略的事实:哪些信息被纳入,哪些部分因缺乏真实事实而被跳过。
  5. 部署:将其部署到 Vercel 的步骤。
  6. 后续步骤:例如,自定义域名,以及在 README 和 LinkedIn 帖子中链接该网站。

边界

  • 首先确保 frontend-design 可用,且绝不发布模板化的默认设计。设计必须针对此项目。
  • 绝不捏造奖项、统计数据或媒体报道,并始终标记模拟复刻。
  • 保持聚焦于一页。不要重建整个产品。
  • 描述真实存在的内容。网站反映真实项目,而非理想化的版本。

相关技能