mcpField
P
product-designer

product-designer

github.com/borghei设计与 UI1.0k4.9k 次安装5 天前更新
代码仓库

关于 product-designer

product-designer 是面向 Agent 的设计技能,涵盖用户研究、UX 与 UI 设计、原型制作和可用性评估。它结合结构化流程与旅程映射、设计评审及可用性评分脚本。

主要功能

  1. 01从发现到交付的结构化流程
  2. 02带情绪曲线的用户旅程图
  3. 03启发式与无障碍设计评审
  4. 04SUS 与任务表现评分
  5. 05原型保真度及设计冲刺指南

适用场景

  1. 01梳理产品旅程中的用户痛点
  2. 02依据可用性启发式检查界面
  3. 03评估 SUS 答案与任务测试数据
  4. 04为设计冲刺规划原型

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/borghei/claude-skills --skill product-designer

安装后在 Claude Code 中输入/product-designer确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

scripts/
design_critique.py
journey_mapper.py
usability_scorer.py

详细介绍

产品设计师

该 Agent 以资深产品设计师的身份开展工作,提供以用户为中心的设计解决方案,涵盖 UX 研究、UI 设计、设计系统、原型制作和可用性测试。

先明确需求

生成设计交付物前,先确定以下输入。若缺少某项或表述含糊,且会影响结果,请询问;若不会影响结果,则采用合理的默认值并说明所用默认值。

  • 目标用户和问题: 谁遇到了问题,以及他们需要完成的工作(影响 Discover 和用户旅程图中的问题陈述)。
  • 交付物类型: 用户旅程图、线框图、可用性测试计划或设计评审(决定适用的工作流和模板)。
  • 保真度和阶段: 探索阶段还是开发交接阶段(决定原型保真度和“完成”的标准)。

针对当前请求,询问最重要的两三项输入,而不是罗列全部问题。如果用户希望立即获得结果,请直接生成,并在顶部说明假设。

工作流

  1. Discover(探索) - 通过访谈、分析数据和竞品分析研究用户需求。创建用户旅程图并找出痛点。检查点:问题陈述至少由 3 个用户数据点验证。
  2. Define(定义) - 将研究发现归纳为清晰的问题陈述和设计要求。构建信息架构(卡片分类、站点地图)。检查点:信息架构已通过卡片分类或树测试验证。
  3. Develop(开发) - 通过草图和线框图构思解决方案。构建适当保真度的原型。检查点:原型覆盖完整的顺畅流程以及一种错误状态。
  4. Test(测试) - 与 5-8 名参与者开展可用性测试。衡量任务完成率、任务耗时、错误率和 SUS 分数。检查点:所有关键可用性问题均已记录并标注严重程度。
  5. Deliver(交付) - 根据测试结果优化设计。准备开发交接材料,包括设计令牌、组件规格和交互文档。检查点:工程团队已确认所有交互均可实现。

设计冲刺(5 天制)

Day活动产出
周一梳理问题、访谈专家挑战地图、目标领域
周二绘制解决方案草图、Crazy 8s解决方案草图
周三做出决策、绘制故事板可测试的假设
周四构建原型逼真的可点击原型
周五与 5 名用户测试已验证/未验证的假设

用户旅程图模板

PERSONA: Sarah, Product Manager, goal: find analytics insights fast

STAGE:      AWARENESS    CONSIDER     PURCHASE     ONBOARD      RETAIN
Actions:    Searches     Compares     Signs up     Configures   Uses daily
Touchpoint: Google       Website      Checkout     Setup wizard App
Emotion:    Frustrated   Curious      Anxious      Hopeful      Satisfied
Pain point: Too many     Hard to      Complex      Slow setup   Missing
            options      compare      pricing                   features
Opportunity: SEO content  Comparison   Simplify     Quick-start  Feature
                         tool         flow         template     education

信息架构

卡片分类方法:

  • 开放式分类:用户自行创建类别
  • 封闭式分类:用户将项目归入预先定义的类别
  • 混合式:结合两种方法

站点地图示例:

Home
+-- Products
|   +-- Category A
|   |   +-- Product 1
|   |   +-- Product 2
|   +-- Category B
+-- About
|   +-- Team
|   +-- Careers
+-- Resources
|   +-- Blog
|   +-- Help Center
+-- Account
    +-- Profile
    +-- Settings

UI 设计基础

设计原则
  1. 层级 - 通过大小、颜色和对比度引导视觉注意力
  2. 一致性 - 复用模式和组件;保持交互可预测
  3. 反馈 - 响应用户的每项操作;显示系统状态和加载状态
  4. 无障碍性 - 最低颜色对比度为 4.5:1,提供焦点指示器和屏幕阅读器支持
设计令牌系统
/* Color tokens */
--color-primary-500: #3b82f6;
--color-primary-600: #2563eb;
--color-gray-50: #f9fafb;
--color-gray-900: #111827;
--color-success: #10b981;
--color-warning: #f59e0b;
--color-error: #ef4444;

/* Typography scale */
--text-sm: 0.875rem;   /* 14px */
--text-base: 1rem;     /* 16px */
--text-lg: 1.125rem;   /* 18px */
--text-xl: 1.25rem;    /* 20px */
--text-2xl: 1.5rem;    /* 24px */

/* Spacing (4px base unit) */
--space-1: 0.25rem;    /* 4px */
--space-2: 0.5rem;     /* 8px */
--space-4: 1rem;       /* 16px */
--space-6: 1.5rem;     /* 24px */
--space-8: 2rem;       /* 32px */

组件结构

Button/
+-- Variants: Primary, Secondary, Tertiary, Destructive
+-- Sizes: Small (32px), Medium (40px), Large (48px)
+-- States: Default, Hover, Active, Focus, Disabled, Loading
+-- Anatomy: [Leading Icon] Label [Trailing Icon]
组件设计令牌(JSON)
{
  "color": {
    "primary": {"50": {"value": "#eff6ff"}, "500": {"value": "#3b82f6"}},
    "semantic": {"success": {"value": "{color.green.500}"}, "error": {"value": "{color.red.500}"}}
  },
  "spacing": {"xs": {"value": "4px"}, "sm": {"value": "8px"}, "md": {"value": "16px"}},
  "borderRadius": {"sm": {"value": "4px"}, "md": {"value": "8px"}, "full": {"value": "9999px"}}
}

示例:可用性测试计划

# Usability Test: New Checkout Flow

## Objectives
- Validate that users can complete purchase in < 3 minutes
- Identify friction points in address and payment steps

## Participants
- 6 users (3 new, 3 returning)
- Mix of desktop and mobile

## Tasks
1. "Find a laptop under $1,000 and add it to your cart" (browse + add)
2. "Complete the purchase using a credit card" (checkout flow)
3. "Change the shipping address on your order" (post-purchase edit)

## Success Criteria
| Task | Completion Target | Time Target |
|------|-------------------|-------------|
| Browse + Add | 100% | < 60s |
| Checkout | 90%+ | < 180s |
| Edit address | 80%+ | < 90s |

## Metrics
- Task completion rate
- Time on task
- Error count per task
- System Usability Scale (SUS) score (target: 68+)

原型保真度指南

保真度用途工具时间安排
纸面快速探索纸、笔几分钟
低保真流程验证Figma、Sketch几小时
中保真可用性测试Figma几天
高保真开发交接、最终测试Figma几天至几周

工具参考

design_critique.py

根据 Nielsen 的 10 项可用性启发式原则和无障碍标准评估 UI 设计。生成结构化的评审报告,其中包含严重程度评级、合规评分和按优先级排序的改进建议。

标志类型默认值说明
--checklist标志-生成空白评估清单
--answers字符串-已填写的清单 JSON 文件路径
--json标志False以 JSON 格式输出
python scripts/design_critique.py --checklist
python scripts/design_critique.py --checklist --json > checklist.json
python scripts/design_critique.py --answers completed_checklist.json
python scripts/design_critique.py --answers completed_checklist.json --json
journey_mapper.py

创建结构化的用户旅程图,包含情绪曲线、痛点识别和机会分析。内置适用于 SaaS、电商和移动应用旅程的模板。

标志类型默认值说明
--template, -t选项-预置模板:saas、ecommerce、mobile_app
--stages, -s字符串-自定义阶段 JSON 文件路径
--json标志False以 JSON 格式输出
python scripts/journey_mapper.py --template saas
python scripts/journey_mapper.py --template ecommerce --json
python scripts/journey_mapper.py --stages custom_journey.json
usability_scorer.py

根据可用性测试数据计算系统可用性量表(SUS)得分和任务表现指标。提供个人和汇总分析,并附有等级解读和基准比较。

标志类型默认值说明
action位置参数-使用 sample 创建示例 CSV 文件
--sus-responses字符串-包含 SUS 回答的 CSV 文件(participant、q1-q10)
--task-data字符串-包含任务数据的 CSV 文件(participant、task、completed、time_seconds、errors)
--json标志False以 JSON 格式输出
python scripts/usability_scorer.py sample
python scripts/usability_scorer.py --sus-responses responses.csv
python scripts/usability_scorer.py --task-data tasks.csv
python scripts/usability_scorer.py --sus-responses responses.csv --task-data tasks.csv --json

故障排查

问题原因解决方案
SUS 得分低于 68(基准值)存在严重的可用性问题首先着重解决 design_critique 中严重程度最高的问题
任务完成率低(<80%)任务流程过于复杂或不清晰简化流程;添加渐进式披露;减少步骤
用户找不到功能信息架构不佳开展卡片分类;重新设计导航;添加搜索功能
表单错误率高验证和引导不足添加行内验证、智能默认值和情境帮助
各屏幕间的设计不一致缺少设计系统或未遵循设计系统使用 design_critique 进行审查;强制使用设计令牌
可用性测试参与者缺乏代表性招募标准不合理筛选符合目标用户画像的参与者;兼顾新用户和回访用户
旅程图中的情绪变化平缓研究数据不足开展更深入的访谈;观察真实使用场景

成功标准

标准目标衡量方式
SUS 得分>68(行业平均值),目标 >80usability_scorer 汇总得分
任务完成率核心流程 >85%usability_scorer 任务指标
任务用时<预期时长的 2 倍usability_scorer avg_time_seconds
设计评审合规率清单通过率 >80%design_critique compliance_score
无障碍合规性所有屏幕均达到 WCAG AAdesign_critique 无障碍部分
旅程图覆盖率绘制所有关键用户画像的旅程图已完成旅程图数量
可用性测试频率每个迭代周期或每次发布都进行测试每季度测试次数

范围与限制

范围内:

  • 启发式评估与设计评审
  • 用户旅程映射与情绪曲线
  • 可用性测试评分(SUS 和任务指标)
  • 设计冲刺引导结构
  • 信息架构规划
  • 原型保真度指导
  • 无障碍检查点评估

范围外:

  • 自动化视觉回归测试(使用 Chromatic/Percy)
  • 实时分析仪表板(使用 Amplitude/Mixpanel)
  • Figma 文件操作或资源导出(使用 Figma API)
  • 眼动追踪或生物特征分析
  • A/B 测试实施(参见 ab-test-setup skill)
  • 设计令牌生成(参见 ui-design-system 或 design-system-lead skills)

集成点

工具 / 平台集成方式用例
Figma将旅程图和评审结果作为设计规范将研究成果转化为设计改进
Maze / UserTesting导出任务数据 CSV,供 usability_scorer 使用为远程测试平台的测试结果评分
Dovetail / Condens导出访谈主题,供 journey_mapper 使用根据研究资料库构建旅程图
Jira / Linear将 design_critique JSON 优先级作为工单在冲刺待办事项中跟踪可用性改进
Notion / Confluence所有工具生成易读的输出记录研究发现和设计决策
Miro / FigJamjourney_mapper JSON 输出协作开展旅程图工作坊

评论

支持 Markdown