跳转到使用指南
ux-researcher-designer作者 Alireza Rezvani

UX Researcher Designer Skill.

Claude Code 和 Codex 的 UX 研究 skill:数据驱动的用户画像、用户旅程地图、可用性测试框架和研究综合。

  • UX & Research
  • 研究文档
alirezarezvani/claude-skills · product-team/skills/ux-researcher-designer/SKILL.mdSKILL.md
--- name: ux-researcher-designer description: UX research and design toolkit for Senior UX Designer/Researcher including data-driven persona generation, journey mapping, usability testing frameworks, and research synthesis. Use when conducting user research, creating personas, mapping user journeys, planning usability tests, or validating designs. --- ## Trigger Terms ## Workflows ## Quick Reference Tables ## Knowledge Base ## Validation Checklist ## Related Skills
从上游文件读取的前置内容和章节标题,2026-09-14 · 完整内容 11,912 字符

01 功能说明

ux-researcher-designer 这个 Skill 在 Claude Code 和 Codex 中的作用

摘要、工作流与产物,均读自该 skill 的 SKILL.md。

来自 SKILL.md读取于 2026-09-14 · 非实际运行记录

以 skill 自身的术语

一套面向高级 UX 设计师或研究员的 UX 研究与设计工具集。它运行四种工作流:生成数据驱动的角色画像、创建用户旅程图、规划可用性测试、综合研究结果,并通过触发词将每个请求路由到对应的工作流。

内置的 persona_generator.py 脚本接收一个 JSON 格式的用户记录数组,返回包含原型、人口统计信息、目标、挫折点、设计启示和置信水平的角色画像,输出为纯文本或 json 格式。快速参考表涵盖了研究方法的选择、按样本量划分的角色画像置信度、可用性问题严重程度和访谈问题类型,验证清单则为每种产物设定了标准。

它产出什么

  • 一份涵盖人口统计学、心理特征、行为、需求与目标、有据可依的挫折点、场景、设计启示和数据要点的角色画像。
  • 根据传入的参数,输出人类可读的角色画像文本,或用于集成的 JSON。
  • 一份用户旅程图,为每个阶段填写了行动、触点、情绪、痛点和机会。
  • 综合的研究结果,以“Y 名参与者中的 X 名”的形式给出频率,并附带证据、业务影响和建议。
查看示例提示词 ↗

工作方式

  1. 01
    选择合适的工作流

    该 skill 分为四个工作流:人物画像生成、用户旅程映射、可用性测试规划和研究综合分析。

  2. 02
    运行人物画像生成器

    人物画像生成是一次脚本调用。不带参数运行可得到便于阅读的输出,传入 json 则可获得便于集成的机器可读输出。

  3. 03
    审查生成的组件

    该工作流提供了一个审查表,用于检查原型是否符合数据模式、目标是否具有可执行性、痛点是否具有频次统计,以及设计影响是否可供设计师采取行动。

  4. 04
    验证人物画像

    生成的人物画像并未完成,你还需要将其反馈给 3-5 位真实用户,询问他们是否觉得贴近自己。

  5. 05
    绘制用户旅程

    用户旅程映射采用典型的 B2B SaaS 阶段,然后在每个阶段填入行为、触点、情绪、痛点和机会。

  6. 06
    对研究数据进行编码与聚类

    原始数据先被标注为 GOAL、PAIN、BEHAVIOR、CONTEXT 和 QUOTE,随后相似的模式会被聚类为带规模标注的分组,最后再从中提炼出结论。

02 找到适合场景

何时使用 ux-researcher-designer Skill

当工作是此类 UX 研究时,在 Claude Code 或 Codex 中使用 ux-researcher-designer skill。以下适用范围和限制来自该 skill 自己的文件。

适合场景

  • 你拥有分析、调查或访谈数据,需要一个有研究支撑的人物画像,而不是凭空猜测。
  • 你需要针对某一特定用户目标,可视化其端到端体验。
  • 你有一个需要真实用户验证的设计,需要一份测试计划。
  • 你手上有大量原始访谈、调查或观察记录,需要从中提炼出可执行的洞察。

了解边界

  • 基于假设而非真实用户数据构建的用户旅程图,无法通过质量检查表。
  • 以指令形式而非真实场景形式编写的可用性任务,无法通过审核。
  • 来自 5-10 名用户的人物画像仅具有探索性,因此小样本成果不应被当作方向依据。

需要提供的信息

  • 以 JSON 形式记录的用户数据工作流 1 需要一个 JSON 数组,每个用户对应一个对象,包含 user_id、age、usage_frequency、features_used、primary_device、usage_context、tech_proficiency 和 pain_points。
  • 用户旅程范围在开始绘制前,先定义人物画像、目标、起始触发条件、结束时的成功标准以及时间范围。
  • 用户旅程数据来源用户旅程各阶段的内容来自访谈、会话录屏、诸如转化路径和流失点之类的分析数据,以及支持工单。
  • 设计方案与你的研究目标可用性工作流从你想验证的设计方案以及模糊的目标出发,然后将其转化为可测试的问题。

03 Skill 内部

ux-researcher-designer Skill 为 Claude Code 和 Codex 设定的规则

SKILL.md 为 Agent 设定的 8 条具体指令、默认值与限制——文件中真正改变结果的部分。

  1. 将模糊目标转化为可验证的问题

    在测试前,把模糊目标改写为可衡量的目标,例如把「是否易用?」改写为「用户能否在 3 分钟内完成结账?」。

  2. 根据所需深度匹配方法

    有主持远程会话默认 5-8 名参与者、时长 45-60 分钟;无主持远程测试默认 10-20 名参与者、时长 15-20 分钟;游击测试默认 3-5 名参与者、时长 5-10 分钟。

  3. 坚持成功指标目标值

    可用性测试要对照固定目标评判:完成率高于 80%,任务耗时不超过预期的 2 倍,错误率低于 15%,满意度高于 5 分中的 4 分。

  4. 将任务写成场景,而非指令

    每个任务包含 SCENARIO(场景)、GOAL(目标)和 SUCCESS(成功标准)三部分,任务顺序依次为热身、核心、次要、边缘情况、自由探索。

  5. 只有达到 31+ 名用户,才能将 Persona 视为可用于生产

    置信度与样本量相关:5-10 名用户为低置信度、探索性;11-30 名为中等置信度、方向性;31+ 名为高置信度、可用于生产。

  6. 达到 Persona 质量标准

    Persona 必须基于至少 20 名用户,并结合至少两个数据来源,兼有定量与定性输入。

  7. 用优先级分数排序

    机会点应通过将频率、严重程度与可解决性相乘来排序,而非凭直觉判断。

  8. 不要在薄弱数据上构建主题

    综合分析的模式必须建立在三个或以上数据点的基础上,才能成为一项发现。

04 投入使用

在 Claude Code 或 Codex 中安装 ux-researcher-designer

一条 npx skills add 命令,然后在你的 Agent 中执行第一个任务和对结果的清单检查。

将 ux-researcher-designer 添加到 Claude Code、Codex 或你的 Agent

在你的项目中运行;安装程序会询问要把它添加到哪个 Agent。

Terminal
npx skills add https://github.com/alirezarezvani/claude-skills --skill ux-researcher-designer

针对 product-team/skills/ux-researcher-designer/SKILL.md 的通用 skills CLI 形式;该仓库可能会记录自己的路径。

给 Skill 第一个 UX 研究任务

按 skill 自身的术语撰写;把括号中的部分换成你的内容。

Starter prompt
Here is our recent research on [product area]: [paste the JSON user data with usage_frequency, features_used and pain_points per user]. Generate a data-driven persona from it and tell me the archetype, the design implications and the confidence level for that sample size. Then map the journey for that persona from [trigger event] to [success criteria] and rank the opportunities so I know what to fix first.

来源:依据 SKILL.md,按 skill 自身的术语撰写。

检查首次结果

SKILL.md 本身如何描述正确的结果:

  • 确认该 Persona 除了 20+ 名用户、两个数据来源、频率统计外,还说明了置信度水平和具体的设计影响。
  • 确认旅程地图的每一层都已填写完整,包括行动、触点和情绪,以及各阶段的痛点和已排序的机会点。
  • 确认该可用性测试具备可验证的研究问题、真实的任务场景、每个设计 5 名以上参与者、明确的成功指标,以及发现中的严重程度评级。
  • 确认该综合分析具有一致编码的数据、建立在 3 个以上数据点上的模式、支撑发现的证据、可执行的建议以及有理有据的优先级排序。
  • 在研究之外验证该 Persona,将其与支持工单和分析数据进行交叉核对。

在 OpenDesign 中通过 SKILL.md 链接导入 ux-researcher-designer:Plugins → Add → Skill → Import from link,然后在顶部栏中选择它。

05 开源、可追溯

来源、许可与验证

本页面事实的来源,以及最后检查时间。

Skill 文件
product-team/skills/ux-researcher-designer/SKILL.md 验证时记录的内容校验和;提交 19392f7
License
MIT 来自 LICENSE。
仓库星标数
25,934 GitHub 快照拍摄于 2026-09-14,针对整个 alirezarezvani/claude-skills 仓库,该仓库在此目录中包含 5 个 skills。不是 ux-researcher-designer 的评分或使用次数。
已由 OpenDesign 验证
2026-09-14 已检查源文件、路径、许可文本和 star 数量。未内置在 OpenDesign 主程序(检查日期 2026-08-28);本页面未记录实际运行。

SKILL.md 内部

  1. 触发词有十二个短语会将请求路由到此处,例如「generate persona from data」或「map user journey」。
  2. 工作流四个工作流,每个都有对应场景、编号步骤、决策表和参考指引。
  3. 工具参考记录 persona_generator.py、其参数、示例输出、四种典型形象及输出组成部分。
  4. 快速参考表方法选择、按样本量划分的画像置信度、可用性问题严重程度以及访谈问题类型。
  5. 知识库列出 references/ 目录下的四份指南及各自内容。
  6. 验证清单针对每类产物的检查清单:用户画像、用户旅程图、可用性测试和综合质量。
  7. 相关 Skill指向 UI 设计系统和产品经理工具包 skill。
Skill 自身的描述
"面向高级 UX 设计师/研究员的 UX 研究和设计工具包,包括数据驱动的用户画像生成、旅程地图、可用性测试框架和研究综合。用于进行用户研究、创建用户画像、绘制用户旅程地图、规划可用性测试或验证设计时使用。"

来自 SKILL.md 的前言描述。完整文件约 11,912 个字符。在 GitHub 上阅读完整文件。

06 安装之前

关于 ux-researcher-designer Skill 的问题

以下回答来自 2026-09-14 读取到的 SKILL.md,而非某次实际运行的记录。

每种研究问题需要多少人参与?

方法选择表将问题类型与方法及样本量配对。想了解用户为何这样做的访谈需要 8-15 名用户,而查看他们做得如何的可用性测试则需要 5-8 名。

它能帮我撰写访谈问题吗?

可以,快速参考给出五种问题类型及示例措辞:背景、行为、目标、痛点和反思。每种类型都对应其用途,例如“你会改变什么?”这类反思问题能激发想法。

我该如何决定先修复哪些可用性问题?

严重程度表将问题从 4 级排到 1 级:严重问题会阻止任务完成,必须立即修复;重大问题造成显著困难,需在发布前修复;轻微问题引起犹豫;外观问题优先级最低。

它是否附带参考文档?

是的,references/ 目录下有四份指南:persona-methodology.md、journey-mapping-guide.md、example-personas.md 和 usability-testing-frameworks.md。示例文件包含 3 个带数据的完整用户画像,可用性指南则涵盖测试规划、任务设计和分析。

UX Researcher Designer

在真实的 UX 研究任务上运行 ux-researcher-designer。

下载 OpenDesign,从其 SKILL.md 链接导入 ux-researcher-designer,粘贴上述提示,并在得到结果前阅读计划。

终端
npx skills add https://github.com/alirezarezvani/claude-skills --skill ux-researcher-designer

OpenDesign 桌面客户端

一套设计系统,让每一次创作都保持品牌一致

在完整的 Vibe Design Workspace 中,用同一套品牌规则生成网页、PPT、可交互原型、数据看板、图像与 HTML 视频。连接本地 Codex、Claude Code、Cursor 等编程助手,即可免费创作。

  • 覆盖网页、PPT、原型、数据看板、图像与视频
  • 140+ 设计系统,以及完整模板与技能库
  • 连接本地 Codex 与 21+ 款编程助手 · 免费使用
免费下载

支持 macOS 与 Windows