跳转到使用指南
user-research作者 Anthropic

User Research Skill.

Claude Code 和 Codex 的 UX 研究 skill:规划、执行和综合用户访谈、调研和可用性测试。

  • UX & Research
  • 研究文档
anthropics/knowledge-work-plugins · design/skills/user-research/SKILL.mdSKILL.md
--- name: user-research description: Plan, conduct, and synthesize user research. Trigger with "user research plan", "interview guide", "usability test", "survey design", "research questions", or when the user needs help with any aspect of understanding their users through research. --- ## Research Methods ## Interview Guide Structure ## Analysis Framework ## Deliverables
前置元数据和章节标题读取自上游文件,时间 2026-09-14 · 完整内容 1,751 字符

01 功能说明

user-research Skill 在 Claude Code 和 Codex 中的作用

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

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

以 skill 自身的术语

一份用于规划、执行和综合用户研究的操作手册。开篇是一个六种方法的对比表——用户访谈、可用性测试、问卷调查、卡片分类、日记研究、A/B 测试——每种方法都配有其最适用场景、典型样本量和持续时间。

由此展开,它规定了一份分五部分、附带时间分配的访谈指南、四种分析框架,以及一项研究应产出的四类交付物。适合需要选择方法、撰写指南,或将会话记录转化为主题与建议的设计师和开发者。

它产出什么

  • 涵盖目标、方法、时间线和参与者的研究计划。
  • 包含问题、追问和活动的访谈指南。
  • 来自各场会话中关键引言和观察的精华合集。
查看示例提示词 ↗

工作方式

  1. 01
    先选方法,再定计划

    该 skill 从方法而非文档出发,因此样本量和时间安排是刻意决定的,而不是随意漂移的。

  2. 02
    按五段式议程进行访谈

    暖场环节建立信任,随后依次是背景了解、深入探讨、反馈与总结,每部分都有各自的时间分配。

  3. 03
    用命名框架进行分析

    分析框架被明确列出;旅程图(journey mapping)用于呈现用户体验随时间的变化,而不是堆砌观察结果。

  4. 04
    以标准产物收尾

    一项研究应以研究计划、访谈指南、综合报告和精彩片段合集结尾,其中综合报告承载主题、洞察与建议。

02 找到适合场景

何时使用 user-research Skill

当任务是此类 UX 研究时,在 Claude Code 或 Codex 中使用 user-research skill。适用范围和限制取自该 skill 自己的文件。

适合场景

  • 你有一个具体的设计或流程要评估,想在 1-2 周内找 5-8 名参与者进行测试。
  • 你正在做信息架构方面的决策,可以招募 15-30 人进行约一周的卡片分类。
  • 你需要观察一段时间内的行为,而不是单次会话,可以在 2-8 周内安排 10-15 名参与者。

    需要提供的信息

    • 你在研究中所处的阶段,以及你想了解什么该 skill 的定位是在任何阶段——规划、执行或综合——都能提供帮助,因此请说明你处于哪个阶段,以及研究的主题是什么。

    03 Skill 内部

    user-research Skill 为 Claude Code 和 Codex 设定的规则

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

    1. 访谈为 5-8 人,持续 2-4 周

      用户访谈的范围是深入理解需求与动机,样本量为 5-8 人,时间窗口为两到四周。

    2. 调查问卷需要 100 人以上的受访者

      调查问卷用于量化态度与偏好,规模为 100 人以上,在 1-2 周内完成。

    3. 不要为 A/B 测试固定人数

      A/B 测试这一行按统计显著性而非固定数字来确定样本量,并为比较具体设计选择留出 1-4 周时间。

    4. 把最大的时间份额留给深入探讨环节

      在访谈的五个环节中,深入探讨占用 20 分钟,是背景了解和反馈环节的两倍。

    5. 始终询问是否有遗漏

      会话结束时预留 5 分钟,让参与者补充任何认为被遗漏的内容,随后表达感谢。

    6. 将需求框定为「待完成的工作」

      四个分析框架之一是「待完成的工作」(jobs to be done):理解用户「雇用」产品去完成什么任务。

    04 投入使用

    在 Claude Code 或 Codex 中安装 user-research

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

    将 user-research 添加到 Claude Code、Codex 或您的 Agent

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

    Terminal
    npx skills add https://github.com/anthropics/knowledge-work-plugins --skill user-research

    用于 design/skills/user-research/SKILL.md 的通用 skills CLI 形式;仓库可能记录了自己的路径。

    给 Skill 第一个 UX 研究任务

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

    Starter prompt
    I'm evaluating [the new onboarding flow] and want to run usability testing. Write me a research plan with objectives, timeline and participants, then a guide with questions and probes for 5-8 sessions across 1-2 weeks. Once the sessions are done I'll paste in the notes and you can turn them into a synthesis report.

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

    检查首次结果

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

    • 访谈指南应以 5 分钟的热身开场,建立信任并说明本次会话的安排。
    • 反应环节应持续 10 分钟,用于展示概念或原型。
    • 应使用影响/成本矩阵对发现进行优先级排序,而不仅是罗列。
    • 在撰写任何洞察之前,应通过相似性分组将观察归纳为主题。

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

    05 开源、可追溯

    来源、许可与验证

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

    Author
    Anthropic
    Skill 文件
    design/skills/user-research/SKILL.md 验证时记录的内容校验和;提交 8f877b6
    License
    Apache-2.0 来自 LICENSE。
    仓库星标数
    24,012 GitHub 快照拍摄于 2026-09-14,针对整个 anthropics/knowledge-work-plugins 仓库,其中包含此目录中的 7 个 skills。不是 user-research 的评分或使用次数。
    已由 OpenDesign 验证
    2026-09-14 已检查源文件、路径、许可文本和 star 数量。未内置在 OpenDesign 主程序(检查日期 2026-08-28);本页面未记录实际运行。

    SKILL.md 内部

    1. 研究方法六种方法在最佳适用场景、样本量与时间上的对比。
    2. 访谈指南结构从热身到收尾的五个计时环节。
    3. 分析框架将观察转化为主题与优先级的四种框架。
    4. 产出物一项完整研究应产出的四类产物。
    Skill 自身的描述
    "规划、执行和综合用户研究。通过「user research plan」、「interview guide」、「usability test」、「survey design」、「research questions」触发,或当用户需要帮助通过研究了解其用户的任何方面时触发。"

    来自 SKILL.md 的 front-matter 描述。完整文件约 1,751 个字符。在 GitHub 上阅读完整文件。

    06 安装之前

    关于 user-research skill 的常见问题

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

    我可以带着哪些需求来使用它?

    任何与通过研究理解用户相关的需求都可以。其描述会在出现「用户研究计划」「访谈指南」「可用性测试」「问卷设计」「研究问题」等关键词时触发,或者任何你需要在理解用户的某个方面获得帮助的请求都适用。

    我该如何比较可选的各种方法?

    这些方法以单张表格呈现,共四列——方法、最佳适用场景、样本量与时间——便于你根据目标和可用时间匹配合适的方法。

    User Research

    在真实的 UX 研究任务上运行 user-research。

    下载 OpenDesign,从其 SKILL.md 链接导入 user-research,粘贴上述提示,在结果前阅读计划。

    终端
    npx skills add https://github.com/anthropics/knowledge-work-plugins --skill user-research

    OpenDesign 桌面客户端

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

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

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

    支持 macOS 与 Windows