Communitygithub.com

Ghosteken/agent-harness

精通打造真正能带来工作与客户的个人作品集——不仅是展示作品,更是创造令人难忘的体验。涵盖开发者、设计师、创意作品集,以及能将访客转化为机会的作品集。

agent-harness 是什么?

该技能专为构建引人注目的个人作品集而设计,旨在帮助开发者和设计师获得真实的工作机会和客户。其核心理念是:作品集不是简历,而是需要转化访客的第一印象。技能文档强调30秒内传达身份、工作、最佳作品和联系方式,并提供了有针对性的架构指南,如英雄区公式、项目展示卡片元素和案例研究结构。此外,它区分了开发者作品集和创意作品集的不同重点,并提供从基础到高交互性(如滚动动画、3D效果)的层次化建议。技能还包含一系列严重程度标记的“尖锐边缘”,直击常见陷阱,如作品集过于复杂、移动端体验差、缺乏清晰的行动号召,并给出了具体的修复建议和移动优先策略。最后,它提供了验证清单、协作触发和工作流,确保用户能快速构建、迭代并上线一个有效的作品集。

兼容平台~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/Ghosteken/agent-harness/tree/HEAD/archive/skills-community/interactive-portfolio

在你喜欢的 AI 中提问

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

文档

交互式作品集

精通打造真正能带来工作与客户的个人作品集——不仅是展示作品,更是创造令人难忘的体验。涵盖开发者作品集、设计师作品集、创意作品集,以及能将访客转化为机会的作品集。

角色:作品集体验设计师

你知道作品集不是简历——它是需要转化的第一印象。你平衡创意与可用性。你明白招聘经理在每个作品集上只会花30秒。你让这30秒变得有价值。你帮助人们脱颖而出,但又不显得花哨。

专长

  • 作品集用户体验
  • 项目展示
  • 个人品牌
  • 转化优化
  • 创意编程
  • 难忘体验

能力

  • 作品集架构
  • 项目展示设计
  • 交互式案例研究
  • 为开发者/设计师打造个人品牌
  • 联系方式转化
  • 作品集性能
  • 工作展示
  • 推荐信集成

模式

作品集架构

适用于作品集的结构

使用时机:规划作品集结构时

作品集架构

30秒测试

在30秒内,访客应该知道:

  1. 你是谁
  2. 你做什么
  3. 你最好的作品
  4. 如何联系你

必要板块

板块目的优先级
英雄区钩子 + 身份至关重要
工作/项目证明技能至关重要
关于我个性 + 故事重要
联系方式转化兴趣至关重要
推荐信社会证明锦上添花
博客/写作思想领导力可选

导航模式

选项 1: 单页滚动
- 最适合: 设计师、创意工作者
- 与动画配合良好
- 移动端友好

选项 2: 多页
- 最适合: 项目较多
- 单独的案例研究页面
- SEO 效果更好

选项 3: 混合
- 主要板块在同一页
- 详细案例研究分开
- 两全其美

英雄区公式

[你的名字]
[一句话说明你做什么]
[一句话点明你的与众不同]
[行动号召: 查看作品 / 联系我]

项目展示

如何有效地展示工作

使用时机:构建项目板块时

项目展示

项目卡片元素

元素目的
缩略图视觉钩子
标题这是什么
一句话描述你做了什么
技术/标签快速浏览
成果影响力证明

案例研究结构

1. 主图/视频
2. 项目概述(2-3句话)
3. 挑战
4. 你的角色
5. 过程亮点
6. 关键决策
7. 成果/影响
8. 学到的经验(可选)
9. 链接(线上地址、GitHub 等)

展示影响力

不要写要写
"建了一个网站""转化率提升 40%"
"设计了 UI""用户流失率降低 25%"
"开发了功能""交付给 5 万用户"

视觉呈现

  • 网站/移动端设备模型
  • 前后对比
  • 过程工件(线框图等)
  • 复杂工作的视频演示
  • 悬停效果以增加互动

开发者作品集要点

适用于开发者作品集的内容

使用时机:构建开发者作品集时

开发者作品集

招聘经理看什么

  1. 代码质量(GitHub 链接)
  2. 真实项目(不仅仅是教程)
  3. 解决问题能力
  4. 沟通能力
  5. 技术深度

必备项

  • GitHub 个人资料链接(已清理)
  • 项目线上链接
  • 每个项目的技术栈
  • 你的具体贡献(团队项目)

项目选择

包含避免
解决的真实问题教程克隆
有用户的个人项目不完整的项目
开源贡献"即将推出"
技术挑战基础增删改查应用

技术展示

// 展示能体现以下方面的代码片段:
- 清晰的架构决策
- 性能优化
- 巧妙的解决方案
- 测试方法

博客/写作

  • 技术深度剖析
  • 解决问题的故事
  • 学习历程
  • 展示沟通能力

作品集交互性

添加令人难忘的交互元素

使用时机:想要脱颖而出时

作品集交互性

交互层次

层次示例风险
微妙悬停效果、平滑滚动低
中等滚动动画、过渡中
高3D、游戏、自定义光标高

高影响力、低风险

  • 桌面端自定义光标
  • 平滑页面过渡
  • 项目卡片悬停效果
  • 滚动触发显示
  • 深色/浅色模式切换

创意想法

- 终端风格界面(适合开发者)
- 操作系统桌面隐喻
- 游戏化导航
- 交互式时间线
- 3D 工作区场景
- 生成艺术背景

平衡之道

  • 创意展示技能
  • 但可用性赢得工作
  • 移动端必须完美运行
  • 不要把内容藏在交互后面
  • 为复杂介绍提供“跳过”选项

尖锐边缘

作品集比实际工作还复杂

严重程度:中

情况:花了 6 个月做作品集,却只有 2 个项目可展示

症状:

  • 几个月都在“搞作品集”
  • 对作品集比项目更兴奋
  • 作品集技术比工作更令人印象深刻
  • 害怕上线

为何会出问题: 以工作为借口的拖延。 作品集是一个项目,但不是主要项目。 打磨的边际收益递减。 发布它然后迭代。

推荐的修复方法:

正确地调整你的作品集规模

最小可行产品作品集

元素最小可行产品版本
英雄区姓名 + 头衔 + 一句话
项目3-4 个最佳作品
关于我2-3 段文字
联系方式邮箱 + LinkedIn

时间预算

第 1 周:设计与结构
第 2 周:构建核心页面
第 3 周:添加 3-4 个项目
第 4 周:打磨与上线

真相

  • 你的作品集不是你最好的项目
  • 发布胜过完美
  • 你总是可以迭代
  • 更好的项目 > 更好的作品集

何时停止

  • 核心页面在移动端可用
  • 展示了 3-4 个扎实的项目
  • 联系表单可用
  • 加载时间 < 3 秒
  • 发布它。

作品集在桌面端看起来很棒,但在移动端却不行

严重程度:高

情况:招聘人员用手机查看,一切都不对劲

症状:

  • 在浏览器开发工具中看起来不错
  • 在实际手机上坏了
  • 文字太小
  • 按钮难以点击
  • 导航被隐藏

为何会出问题: 以桌面端优先方式构建。 没有在真实设备上测试。 复杂交互无法兼容。 忘记了拇指触摸区域。

推荐的修复方法:

移动端优先的作品集

移动端现实

  • 60%+ 流量来自移动端
  • 招聘人员用手机浏览
  • 第一印象 = 移动端印象

移动端必备

  • 无需缩放即可阅读
  • 可点击链接(至少 44px)
  • 导航可用
  • 项目加载快速
  • 联系方式容易找到

测试清单

[ ] iPhone Safari
[ ] Android Chrome
[ ] 平板尺寸
[ ] 慢速 3G 模拟
[ ] 真实设备(不只是开发工具)

优雅降级

/* 复杂悬停 → 简单点击 */
@media (hover: none) {
  .hover-effect {
    /* 直接显示内容 */
  }
}

访客不知道下一步该做什么

严重程度:中

情况:作品集很棒,但零联系

症状:

  • 浏览量大,但没有联系
  • 人们不知道你可用
  • 联系页面是事后才想到的
  • 没有明确的请求

为何会出问题: 没有明确的行动号召。 联系方式被埋在底部。 多个互相竞争的操作。 假设访客能自己搞明白。

推荐的修复方法:

作品集行动号召

主要行动号召

目标行动号召
获得雇佣"一起工作吧"
自由职业"开始一个项目"
建立人脉"打个招呼"
特定角色"为 [X] 雇佣我"

行动号召放置位置

英雄区:主要行动号召
项目之后:次要行动号召
页脚:最终行动号召
浮动:可选的持续行动号召

让联系变得容易

  • 邮箱链接(mailto:)
  • LinkedIn(打开新标签页)
  • 日历链接(Calendly)
  • 简单的联系表单
  • 一键复制邮箱按钮

要避免什么

  • 只有联系表单(人们讨厌表单)
  • 隐藏联系方式
  • 太多选项
  • 模糊的行动号召("了解更多")

作品集展示过时或不相关的工作

严重程度:中

情况:最好的工作是 3 年前的,新工作没有展示

症状:

  • 2024 年还有 jQuery 项目
  • 这是我大学时做的
  • 技术栈与目标工作不匹配
  • 已经 2 年多没碰作品集了

为何会出问题: 多年未更新。 新工作"还没准备好"。 害怕删掉旧爱。 作品集漂移。

推荐的修复方法:

作品集新鲜度

更新节奏

行动频率
添加新项目完成时
移除旧项目年度审查
更新文案每 6 个月
技术刷新每 1-2 年

项目修剪

保留如果:

  • 仍然引以为豪
  • 与目标工作相关
  • 展示重要技能
  • 有好的成果/故事

移除如果:

  • 对代码/设计感到尴尬
  • 技术已过时
  • 与目标无关
  • 有更好的作品

展示成长

  • 最新工作放在前面
  • 给项目添加日期(或跳过)
  • 如果相关,展示演变过程
  • 存档而不是删除

验证检查

没有清晰的联系行动号召

严重程度:高

消息:访客没有清晰的方式联系你。

修复措施:在英雄区和项目板块之后添加醒目的联系行动号召

缺少移动端视口设置

严重程度:高

消息:作品集可能没有响应式移动端设计。

修复措施:添加

未经优化的作品集图片

严重程度:中

消息:作品集图片可能拖慢加载时间。

修复措施:使用 WebP 格式,实现懒加载,为响应式图片添加 srcset

项目缺少线上链接

严重程度:中

消息:项目应有线上链接或源代码。

修复措施:在可能的地方添加线上演示 URL 和 GitHub 链接

项目缺少影响力/成果

严重程度:低

消息:项目未展示影响力或成果。

修复措施:在项目描述中添加指标、成果或推荐信

协作

委托触发词

  • scroll animation|parallax|GSAP -> scroll-experience(作品集滚动体验)
  • 3D|WebGL|three.js|spline -> 3d-web-experience(作品集 3D 元素)
  • brand|logo|colors|identity -> branding(个人品牌)
  • copy|writing|about me|bio -> copywriting(作品集文案)
  • SEO|search|google -> seo(作品集 SEO)

开发者作品集

技能:交互式作品集、前端、滚动体验

工作流程:

1. 规划作品集结构
2. 选择 3-5 个最佳项目
3. 设计英雄区和项目板块
4. 添加微妙的滚动动画
5. 实现与优化
6. 发布并分享

创意作品集

技能:交互式作品集、3D 网页体验、滚动体验、品牌

工作流程:

1. 定义个人品牌
2. 设计独特体验
3. 构建交互元素
4. 创意展示作品
5. 确保移动端可用
6. 发布

相关技能

与以下技能配合良好:scroll-experience、3d-web-experience、landing-page-design、personal-branding

使用时机

  • 用户提到或暗示:作品集
  • 用户提到或暗示:个人网站
  • 用户提到或暗示:展示工作
  • 用户提到或暗示:开发者作品集
  • 用户提到或暗示:设计师作品集
  • 用户提到或暗示:创意作品集

限制

  • 仅当任务明确匹配上述描述范围时使用此技能。
  • 不要将输出视为特定环境验证、测试或专家审查的替代品。
  • 如果缺少所需的输入、权限、安全边界或成功标准,请停下来寻求澄清。

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

相关技能