Back to Details

user-onboarding

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

User Onboarding

用户引导

Scope

范围

Covers
  • Designing the first-time user experience (FTUE) from entry/signup → first value
  • Defining activation / the “aha moment” and reducing time-to-value
  • Creating a “first 30 seconds” experience and a “first mile” plan (milestones to activation)
  • Onboarding mechanics: progressive disclosure, guided setup, empty states, templates, checklists, feedback loops
  • Instrumentation + experiments to improve activation and early retention
When to use
  • “Activation is low” / “users drop during signup/onboarding”
  • “Time-to-value is too long”
  • “The first session doesn’t feel magical”
  • “We need an onboarding redesign / guided setup / empty state improvements”
  • “Define our aha moment and design onboarding to get users there”
  • “Create an onboarding experiment backlog + measurement plan”
When NOT to use
  • You’re onboarding employees, customers to a service process, or running training (not product onboarding).
  • You don’t have a stable value proposition / ICP (use 
    problem-definition
    or 
    measuring-product-market-fit
    first).
  • You need a full retention strategy beyond onboarding (use 
    retention-engagement
    ).
  • You need to validate a prototype with real users (use 
    usability-testing
    after creating a plan here).
涵盖
  • 设计从进入/注册到首次获得价值的首次用户体验（FTUE）
  • 定义用户激活/“aha时刻”，缩短价值获取时间（time-to-value）
  • 打造“首30秒”体验与“首阶段”计划（达成激活的关键里程碑）
  • 用户引导机制：渐进式信息披露、引导式设置、空状态处理、模板、任务清单、反馈循环
  • 埋点与实验，以提升激活率与初期留存率
适用场景
  • “用户激活率低”/“用户在注册/引导流程中流失”
  • “价值获取时间过长”
  • “首次使用体验缺乏吸引力”
  • “我们需要重新设计用户引导/优化引导式设置/改进空状态”
  • “明确我们的aha时刻，并设计引导流程帮助用户达成”
  • “创建用户引导实验待办清单+度量计划”
不适用场景
  • 员工入职引导、客户服务流程培训（非产品用户引导）
  • 产品价值主张/理想客户画像（ICP）尚未稳定（请先使用
    problem-definition
    或
    measuring-product-market-fit
    ）
  • 需要引导流程之外的完整留存策略（请使用
    retention-engagement
    ）
  • 需要用真实用户验证原型（请在此计划完成后使用
    usability-testing
    ）

Inputs

输入

Minimum required
  • Product + ICP/segment(s) (1–2) and the primary job-to-be-done
  • Platform + entry point (web/mobile; where FTUE starts)
  • Best-available baseline metrics (even rough):
    • visit → signup → first key action → activation
    • time-to-value (time or sessions to first value)
    • D1 retention (if available)
  • Current onboarding flow summary (steps/screens) and the biggest drop-off point(s)
  • Constraints: timebox, eng/design capacity, allowed channels (in-app/email/push), privacy/legal/brand limits
Missing-info strategy
  • Ask up to 5 questions from references/INTAKE.md, then proceed.
  • If metrics are missing, proceed with explicit assumptions and label confidence.
  • Do not request secrets or PII; prefer aggregated funnels and redacted screenshots.
最低要求
  • 产品+理想客户画像/用户细分（1–2个），以及核心用户任务
  • 平台+入口点（网页/移动端；首次用户体验的起始位置）
  • 现有基准指标（即使是粗略数据）：
    • 访问→注册→首次关键操作→激活
    • 价值获取时间（达成首次价值所需的时间或会话次数）
    • 次日留存率（D1 retention，若有）
  • 当前用户引导流程概述（步骤/页面）以及最大流失点
  • 约束条件：时间限制、开发/设计资源、允许使用的渠道（应用内/邮件/推送）、隐私/合规/品牌限制
缺失信息处理策略
  • 可从references/INTAKE.md中选取最多5个问题询问，然后推进工作。
  • 若缺少指标，基于明确假设推进，并标注置信度。
  • 不得索要机密信息或个人可识别信息（PII）；优先使用汇总转化漏斗和脱敏截图。

Outputs (deliverables)

输出物（交付成果）

Produce an Onboarding & Activation Pack (Markdown in-chat; or as files if requested) containing:
  1. Context snapshot (goal, segment, constraints, baseline)
  2. Current FTUE map (step-by-step) + friction log
  3. Activation / aha moment spec (behavioral definition + threshold + validation plan)
  4. “First 30 seconds” experience spec (magic moment + success criteria)
  5. “First mile” onboarding plan (milestones to activation; mechanics per milestone)
  6. Experiment backlog (prioritized) + 3–5 experiment cards
  7. Measurement + instrumentation plan (events, properties, dashboards, guardrails)
  8. Rollout/rollback + risk plan
  9. Risks / Open questions / Next steps (always included)
Templates and checklists:
  • references/TEMPLATES.md
  • references/WORKFLOW.md
  • references/CHECKLISTS.md
  • references/RUBRIC.md
产出《用户引导与激活方案包》（聊天内Markdown格式；或按需生成文件），包含：
  1. 上下文快照（目标、用户细分、约束条件、基准数据）
  2. 当前首次用户体验旅程图（分步）+ 摩擦点日志
  3. 用户激活/aha时刻规范（行为定义+阈值+验证计划）
  4. “首30秒”体验规范（惊喜时刻+成功标准）
  5. “首阶段”用户引导计划（达成激活的里程碑；每个里程碑对应的引导机制）
  6. 实验待办清单（已排序）+ 3–5个实验卡片
  7. 度量+埋点计划（事件、属性、仪表盘、防护指标）
  8. 上线/回滚+风险应对计划
  9. 风险/待解决问题/下一步行动（必含）
模板与清单：
  • references/TEMPLATES.md
  • references/WORKFLOW.md
  • references/CHECKLISTS.md
  • references/RUBRIC.md

Workflow (7 steps)

工作流程（7步）

1) Intake + goal framing (activation-first)

1) 需求收集+目标设定（以激活为核心）

  • Inputs: User prompt; references/INTAKE.md.
  • Actions: Define the primary segment and the activation outcome. Make the goal measurable (baseline → target, date). Capture constraints and guardrails (e.g., don’t increase drop-off, don’t add dark patterns).
  • Outputs: Context snapshot + goal statement.
  • Checks: Goal is one sentence with a metric, baseline, target, and date.
  • 输入：用户需求；references/INTAKE.md
  • 行动：明确核心用户细分与激活目标。将目标量化（基准→目标，截止日期）。记录约束条件与防护规则（如：不得提升流失率、不得使用诱导性设计）。
  • 输出：上下文快照+目标声明
  • 检查标准：目标为一句话，包含指标、基准值、目标值与截止日期。

2) Map the current first-time journey (FTUE)

2) 绘制当前首次用户体验旅程图

  • Inputs: Current flow description/screens; funnel + drop-offs; support/sales notes if available.
  • Actions: Create a step-by-step journey map from entry → first value. Log frictions (confusion, time, permissions, empty states, choice overload). Identify the single biggest leak.
  • Outputs: FTUE map table + friction log + primary leak.
  • Checks: Every step has a user goal, product action, and a measurable checkpoint (event or proxy).
  • 输入：当前流程描述/页面截图；转化漏斗+流失点；若有，支持/销售记录
  • 行动：绘制从进入到首次获取价值的分步旅程图。记录摩擦点（困惑、耗时、权限要求、空状态、选择过载）。找出最大的流失漏洞。
  • 输出：首次用户体验旅程表+摩擦点日志+核心流失漏洞
  • 检查标准：每个步骤都包含用户目标、产品操作与可量化检查点（事件或替代指标）。

3) Define the activation / “aha moment” (behavioral)

3) 定义用户激活/“aha时刻”（行为导向）

  • Inputs: Candidate value behaviors; available events; retention definition (if any).
  • Actions: Propose 3–5 candidate “aha” behaviors and pick one activation definition with a threshold (e.g., “creates X and shares Y within 7 days”). Specify how to validate (correlation with D7/D30; holdout if possible).
  • Outputs: Activation/aha moment spec + validation plan + instrumentation needs.
  • Checks: Activation is observable, repeatable, and measurable (not “understands value”).
  • 输入：候选价值行为；现有事件；留存定义（若有）
  • 行动：提出3–5个候选“aha”行为，选定一个带阈值的激活定义（如：“7天内创建X并分享Y”）。明确验证方式（与7日/30日留存的相关性；若可能，使用对照组）。
  • 输出：用户激活/aha时刻规范+验证计划+埋点需求
  • 检查标准：激活是可观察、可重复、可量化的（而非“理解产品价值”）。

4) Design the “first 30 seconds” (make it feel magical)

4) 设计“首30秒”体验（打造吸引力）

  • Inputs: Primary leak + activation spec; constraints.
  • Actions: Specify what the user should see/do/feel in the first 30 seconds:
    • Remove or defer non-essential setup (progressive disclosure).
    • Deliver a fast, native, interactive win (avoid passive carousel “tours”).
    • Provide immediate feedback and a clear next action.
  • Outputs: First 30 seconds spec (screen/script + success criteria).
  • Checks: A new user can reach a meaningful “win” within ~30 seconds (or you document why not and the best proxy).
  • 输入：核心流失漏洞+激活规范；约束条件
  • 行动：明确用户在首30秒内的所见/所做/感受：
    • 移除或延迟非必要设置（渐进式信息披露）
    • 快速交付原生、交互式的正向反馈（避免被动轮播式“教程”）
    • 提供即时反馈与清晰的下一步操作
  • 输出：首30秒体验规范（页面/脚本+成功标准）
  • 检查标准：新用户可在约30秒内获得有意义的“正向反馈”，或需记录无法实现的原因及最佳替代方案。

5) Build the “first mile” plan (milestones → activation)

5) 构建“首阶段”计划（里程碑→激活）

  • Inputs: Activation spec; journey map; UX constraints.
  • Actions: Break activation into 3–6 milestones (the “first mile”). For each milestone, define mechanics (guided setup, defaults, empty states, templates, checklists, feedback, progress). Ensure onboarding is “inside the product,” not detached from real actions.
  • Outputs: First mile onboarding plan + updated journey map.
  • Checks: Each milestone reduces time-to-value and has a leading-indicator metric.
  • 输入：激活规范；旅程图；UX约束条件
  • 行动：将激活目标拆解为3–6个里程碑（“首阶段”）。为每个里程碑定义引导机制（引导式设置、默认值、空状态处理、模板、任务清单、反馈、进度提示）。确保引导流程嵌入产品内，与实际操作紧密结合。
  • 输出：首阶段用户引导计划+更新后的旅程图
  • 检查标准：每个里程碑都能缩短价值获取时间，并包含前置指标。

6) Instrumentation + measurement plan

6) 埋点+度量计划

  • Inputs: Current analytics/events; proposed milestones; guardrails.
  • Actions: Define the minimum event schema and dashboards needed (funnel, time-to-value, activation rate, early retention). Add guardrails (support tickets, cancellations, performance).
  • Outputs: Measurement plan + event list/properties + dashboard outline.
  • Checks: Every experiment and milestone has a primary metric and at least one guardrail metric.
  • 输入：当前分析/事件；拟议的里程碑；防护规则
  • 行动：定义所需的最小事件 schema 与仪表盘（转化漏斗、价值获取时间、激活率、初期留存）。添加防护指标（支持工单、取消订阅、性能）。
  • 输出：度量计划+事件列表/属性+仪表盘大纲
  • 检查标准：每个实验与里程碑都有核心指标及至少一个防护指标。

7) Prioritize experiments + quality gate

7) 实验优先级排序+质量把关

  • Inputs: Candidate interventions; measurement plan; references/CHECKLISTS.md and references/RUBRIC.md.
  • Actions: Convert top opportunities into experiment cards; prioritize (Impact × Confidence ÷ Effort). Add rollout/rollback guidance. Run checklist + score rubric. Always include Risks / Open questions / Next steps.
  • Outputs: Final Onboarding & Activation Pack.
  • Checks: Top 3 experiments are runnable within constraints and have “win/lose/learn” criteria.
  • 输入：候选优化方案；度量计划；references/CHECKLISTS.md与references/RUBRIC.md
  • 行动：将核心机会转化为实验卡片；按（影响力×置信度÷投入）排序。添加上线/回滚指导。执行清单检查+评分。必须包含风险/待解决问题/下一步行动。
  • 输出：最终《用户引导与激活方案包》
  • 检查标准：排名前三的实验可在约束条件下落地，并包含“成功/失败/学习”的判断标准。

Quality gate (required)

质量把关（必填）

  • Use references/CHECKLISTS.md and references/RUBRIC.md.
  • Always include: Risks, Open questions, Next steps.
  • 使用references/CHECKLISTS.md与references/RUBRIC.md
  • 必须包含：风险、待解决问题、下一步行动

Examples

示例

Example 1 (B2B SaaS, guided setup):
“Use 
user-onboarding
. Product: workflow automation tool for SMB ops. Segment: new self-serve admins. Baseline: 42% signup completion, 9% activation within 7 days. Problem: users stall at connecting integrations. Constraint: 3-week sprint, 1 engineer, 1 designer. Output: an Onboarding & Activation Pack with an activation spec, a first-30-seconds + first-mile plan, and a prioritized experiment backlog.”
Example 2 (B2C app, time-to-value):
“Our first session feels flat. Redesign onboarding so users experience value within 30 seconds, define the activation event, and propose 5 experiments with metrics + guardrails.”
Boundary example (not product onboarding):
“Create an employee onboarding program for new hires.”
Response: this skill is for product onboarding; use an HR onboarding/training process instead.
示例1（B2B SaaS，引导式设置）：
“使用
user-onboarding
。产品：面向中小企业运营的工作流自动化工具。用户细分：新自助服务管理员。基准数据：42%注册完成率，7天内激活率9%。问题：用户在连接集成环节停滞。约束条件：3周迭代周期，1名开发，1名设计。输出：包含激活规范、首30秒+首阶段计划、优先级排序的实验待办清单的《用户引导与激活方案包》。”
示例2（B2C应用，价值获取时间）：
“我们的首次使用体验平淡无奇。重新设计用户引导流程，让用户在30秒内获得产品价值，明确激活事件，并提出5个带指标+防护指标的实验方案。”
边界示例（非产品用户引导）：
“为新员工创建入职培训计划。”
回应：本技能适用于产品用户引导；请使用HR入职/培训流程工具。