Communitygithub.com

jpoindexter/design-case-study-skills

规划、构建、评审、更新或发布一个专业的、基于证据的设计作品集系统。当用户调用 /portfolio;需要作品集定位、项目清单与选择、个人品牌、案例研究、首页/关于/联系文案、信息架构、视觉方向、网站实现、无障碍评审或发布时;或者希望将零散的作品转化为面向特定角色、客户或受众的连贯作品集时使用。

design-case-study-skills 是什么?

该技能帮助用户系统性地构建专业设计作品集,强调以证据为基础,而非单纯追求视觉美观。它支持 Claude Code 等 AI 代理平台,并提供完整的端到端工作流程,从定位、项目清单、选择、信息架构、案例研究撰写、设计实现,到最终的无障碍评审和发布。核心原则是:每个项目声明都应有实际证据支持,防止编造数据,并允许用户将零散的作品整合成一套有说服力的故事。该技能通过一系列模块化路由(如 position、inventory、select、case-study 等)来组织工作,用户可通过 /portfolio 命令直接调用特定模式,从而高效地完成作品集的各个阶段。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jpoindexter/design-case-study-skills/tree/HEAD/skills/portfolio

在你喜欢的 AI 中提问

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

文档

作品集调度器

围绕目标受众必须理解和相信的内容来构建作品集。不要从视觉主题开始,也不要强行让每个项目都讲同一个故事。

解析模式

当存在参数时,将第一个参数解释为模式:

调用结果
/portfolio build运行完整工作流,从证据清单到经过验证的作品集
/portfolio position定义目标受众、承诺、差异化因素和证据要求
/portfolio inventory查找并分类可用的项目、成果、指标和推荐信
/portfolio select对项目打分,选择最小可信的集合
/portfolio architecture创建站点地图、页面层级、标签和内容模型
/portfolio case-study将一个项目路由到 /case-study
/portfolio write草拟或编辑首页、作品索引、关于、简历和联系文案
/portfolio design定义或实现作品集的视觉和交互系统
/portfolio audit测试定位、证据、可查找性、写作、无障碍性和执行
/portfolio ship仅在获得明确发布权限时验证、提交、推送和部署
/portfolio update重新运行清单,替换陈旧或薄弱的证据,无需重建整个作品集

没有模式时默认为 build。如果作品集或项目已存在,在询问无法从文件中恢复的信息之前,先检查它们。

路由已安装库

仅加载活动模式所需的路由。如果已安装 use 调度器,则针对当前阶段运行其清单扫描,以便其他相关技能稍后加入。

需求路由
职业/工作室定位、细分领域、专业信号designbiz
个人品牌、身份、定位、接触点brand
产品、系统或 AI 项目故事case-study
品牌身份项目故事或先例brand-case-studies 配合 case-study
站点地图、标签、项目分类法、可查找性information-architecture-and-navigation
界面方向、设计系统、布局、打磨design
区块级别的图像方向或生成视觉imagegen-frontend-web
消除 AI 写作模式的语调humanizer,在证据和结构稳定之后使用
无障碍和包容性实现accessibility-and-inclusive-design
GitHub 发布github:yeet,仅在用户明确请求发布后使用

将这些视为委派的能力,而非独立的报告。作品集拥有受众、项目集、跨页面层级和证据系统;辅助技能拥有其专业决策。

模式计划

将这些序列视为必需的路由,而非建议:

模式有序计划
buildposition → inventory → select → architecture → 每个被选项目的 case-study → write → design → audit → 本地交接
positiondesignbiz 用于受众/专业策略 → brand 用于个人品牌表达 → 证据要求
inventory检查授权文件和来源 → 证据/许可清单 → 差距列表
select权限门 → PROOF 评分 → 覆盖率/冗余度/深度检查
architectureinformation-architecture-and-navigation → 内容模型 → 站点地图 → 页面简报
case-studycase-study;身份相关工作添加 brand-case-studies
write作品集页面文案 → 证据检查 → humanizer 语调调整
designdesign;仅在需要有意义的新图像时添加 imagegen-frontend-web
audit定位/证据门 → 渲染后可查找性测试 → accessibility-and-inclusive-design → 执行检查
shipaudit 必须通过 → github:yeet → 配置的部署路径
update清单增量 → 替换或修复薄弱证据 → 重新运行受影响的案例研究/页面/审计阶段

不要将 ship 附加到 build。仅在用户明确请求发布时运行 ship。

完整工作流

  1. 目标和定位 — 命名角色、客户或受众;他们的决策;期望的下一步行动;约束条件;以及证据要求。
  2. 清单 — 检查项目、成果、指标、研究、截图、源文件、推荐信和权限。
  3. 选择 — 应用 references/project-selection.md;选择能够证明定位的最小集合,避免重复。
  4. 架构 — 应用 references/page-system.md;在视觉样式之前设计内容模型和站点地图。
  5. 构建故事 — 将每个选定的项目路由到 case-study;不要在此处重复其内部框架。
  6. 撰写连接性文案 — 草拟首页、作品索引、关于页面、项目卡片、简历桥梁和联系路径。
  7. 设计与实现 — 将界面路由到 design;仅在图像具有意义时才生成新图像。
  8. 验证 — 针对实际渲染的作品集应用 references/portfolio-quality-gate.md。
  9. 交接 — 留下一个经过验证的本地工件和一个重新进入的步骤。
  10. 仅在请求时发布 — 仅在用户明确调用或请求发布阶段时才发布。

当用户需要在会话之间保留工件时,使用 assets/portfolio-workbook.md。

证据契约

对于每个项目以及作品集级别的声明:

  • 指明受影响的用户、组织或系统;
  • 说明设计师的实际所有权和合作者;
  • 将成果与决策联系起来,而非装饰;
  • 区分已发布结果与观察、报告和提案;
  • 标记机密、编辑、重建或不可用的证据;
  • 切勿编造研究、指标、推荐信、奖项、雇主、责任或影响。

使用 [evidence needed: …] 标记重大差距。一个视觉上强大的页面不能弥补无依据的主张。

默认输出

返回或创建:

  1. 目标受众和定位声明;
  2. 证据清单;
  3. 评分的项目候选名单;
  4. 作品集站点地图和页面简报;
  5. 案例研究生产队列;
  6. 作品集级别的文案;
  7. 设计/构建方向;
  8. 验证结果和未解决的差距;
  9. 当还有工作要做时的一条下一步行动。

示例

/portfolio build Inspect my project folders and build a portfolio for senior
AI product design roles. Prioritize systems thinking, agent control, and shipped work.

期望结果:技能进行证据清单、选择无重复的项目、定义定位和站点地图、将每个选定的项目路由到 /case-study、通过 /design 构建或指导网站、并报告执行的验证路径,然后才宣布准备就绪。

完成

只有当实际渲染的工件能让目标受众回答以下问题时,作品集才算准备就绪:

  • 这个人是谁?他们做什么工作?为谁做?
  • 哪些项目最能证明这一主张?
  • 他们拥有什么、决定了什么、改变了什么?
  • 哪些证据支持这一结果?
  • 我能否快速在桌面、移动端、键盘和辅助技术上找到合适的深度?
  • 我应该下一步做什么,那个操作有效吗?

相关技能