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 moment”并缩短价值获取时间（time-to-value）
  • 打造“首30秒”体验和“首里程”计划（达成激活的关键里程碑）
  • 引导机制：渐进式信息披露、引导式设置、空状态、模板、清单、反馈循环
  • 埋点与实验，以提升激活率和早期留存
适用场景
  • “激活率偏低” / “用户在注册/引导流程中流失”
  • “价值获取时间过长”
  • “首次使用体验缺乏吸引力”
  • “我们需要重新设计引导流程 / 优化引导式设置 / 改进空状态”
  • “明确我们的Aha moment，并设计引导流程帮助用户达成”
  • “创建引导实验待办清单 + 衡量计划”
不适用场景
  • 你需要的是员工入职引导、客户服务流程引导或培训计划（而非产品用户引导）。
  • 产品尚未有稳定的价值主张 / 理想客户画像（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个理想客户画像（ICP）/ 用户细分群体，以及核心用户任务
  • 平台与入口（网页/移动端；FTUE的起始点）
  • 现有基准指标（即使是粗略数据）：
    • 访问 → 注册 → 首次关键操作 → 激活
    • 价值获取时间（达成首次价值所需的时间或会话数）
    • 次日留存（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. 当前FTUE旅程图（分步） + 摩擦点日志
  3. 激活 / Aha moment规范（行为定义 + 阈值 + 验证计划）
  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) 绘制当前首次用户旅程（FTUE）

  • 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).
  • 输入：当前流程描述/页面；转化漏斗 + 流失点；若有可用的支持/销售记录
  • 行动：绘制从进入到首次获得价值的分步旅程图。记录摩擦点（困惑、耗时、权限要求、空状态、选择过载）。找出最大的流失漏洞。
  • 输出：FTUE旅程图表格 + 摩擦点日志 + 核心流失漏洞
  • 检查项：每个步骤都包含用户目标、产品操作和可衡量的检查点（事件或替代指标）。

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

3) 定义激活 / “Aha moment”（行为导向）

  • 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”）。明确验证方式（与D7/D30留存的相关性；若可能使用对照组）。
  • 输出：激活/Aha moment规范 + 验证计划 + 埋点需求
  • 检查项：激活行为可观测、可重复、可衡量（而非“理解产品价值”这类主观描述）。

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入职/培训流程工具替代。