关于 product-designer
product-designer 是面向 Agent 的设计技能,涵盖用户研究、UX 与 UI 设计、原型制作和可用性评估。它结合结构化流程与旅程映射、设计评审及可用性评分脚本。
主要功能
- 01从发现到交付的结构化流程
- 02带情绪曲线的用户旅程图
- 03启发式与无障碍设计评审
- 04SUS 与任务表现评分
- 05原型保真度及设计冲刺指南
适用场景
- 01梳理产品旅程中的用户痛点
- 02依据可用性启发式检查界面
- 03评估 SUS 答案与任务测试数据
- 04为设计冲刺规划原型
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ borghei/ claude-skills --skill product-designer安装后在 Claude Code 中输入/product-designer确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
scripts/design_critique.pyjourney_mapper.pyusability_scorer.py详细介绍
产品设计师
该 Agent 以资深产品设计师的身份开展工作,提供以用户为中心的设计解决方案,涵盖 UX 研究、UI 设计、设计系统、原型制作和可用性测试。
先明确需求
生成设计交付物前,先确定以下输入。若缺少某项或表述含糊,且会影响结果,请询问;若不会影响结果,则采用合理的默认值并说明所用默认值。
- 目标用户和问题: 谁遇到了问题,以及他们需要完成的工作(影响 Discover 和用户旅程图中的问题陈述)。
- 交付物类型: 用户旅程图、线框图、可用性测试计划或设计评审(决定适用的工作流和模板)。
- 保真度和阶段: 探索阶段还是开发交接阶段(决定原型保真度和“完成”的标准)。
针对当前请求,询问最重要的两三项输入,而不是罗列全部问题。如果用户希望立即获得结果,请直接生成,并在顶部说明假设。
工作流
- Discover(探索) - 通过访谈、分析数据和竞品分析研究用户需求。创建用户旅程图并找出痛点。检查点:问题陈述至少由 3 个用户数据点验证。
- Define(定义) - 将研究发现归纳为清晰的问题陈述和设计要求。构建信息架构(卡片分类、站点地图)。检查点:信息架构已通过卡片分类或树测试验证。
- Develop(开发) - 通过草图和线框图构思解决方案。构建适当保真度的原型。检查点:原型覆盖完整的顺畅流程以及一种错误状态。
- Test(测试) - 与 5-8 名参与者开展可用性测试。衡量任务完成率、任务耗时、错误率和 SUS 分数。检查点:所有关键可用性问题均已记录并标注严重程度。
- 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 设计基础
设计原则
- 层级 - 通过大小、颜色和对比度引导视觉注意力
- 一致性 - 复用模式和组件;保持交互可预测
- 反馈 - 响应用户的每项操作;显示系统状态和加载状态
- 无障碍性 - 最低颜色对比度为 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(行业平均值),目标 >80 | usability_scorer 汇总得分 |
| 任务完成率 | 核心流程 >85% | usability_scorer 任务指标 |
| 任务用时 | <预期时长的 2 倍 | usability_scorer avg_time_seconds |
| 设计评审合规率 | 清单通过率 >80% | design_critique compliance_score |
| 无障碍合规性 | 所有屏幕均达到 WCAG AA | design_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 / FigJam | journey_mapper JSON 输出 | 协作开展旅程图工作坊 |
评论
支持 Markdown