Back to Details

i-onboard

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

MANDATORY PREPARATION

必备准备

Invoke /impeccable — it contains design principles, anti-patterns, and the Context Gathering Protocol. Follow the protocol before proceeding — if no design context exists yet, you MUST run /impeccable teach first. Additionally gather: the "aha moment" you want users to reach, and users' experience level.
Create or improve onboarding experiences that help users understand, adopt, and succeed with the product quickly.
调用 /impeccable —— 它包含设计原则、反模式以及上下文收集协议。在继续操作前请遵循该协议，如果还没有设计上下文，你必须先运行 /impeccable teach。此外还需要收集：你希望用户达成的"aha moment"，以及用户的经验水平。
创建或优化新手引导体验，帮助用户快速理解产品、上手使用并取得成功。

Assess Onboarding Needs

评估新手引导需求

Understand what users need to learn and why:
  1. Identify the challenge:
    • What are users trying to accomplish?
    • What's confusing or unclear about current experience?
    • Where do users get stuck or drop off?
    • What's the "aha moment" we want users to reach?
  2. Understand the users:
    • What's their experience level? (Beginners, power users, mixed?)
    • What's their motivation? (Excited and exploring? Required by work?)
    • What's their time commitment? (5 minutes? 30 minutes?)
    • What alternatives do they know? (Coming from competitor? New to category?)
  3. Define success:
    • What's the minimum users need to learn to be successful?
    • What's the key action we want them to take? (First project? First invite?)
    • How do we know onboarding worked? (Completion rate? Time to value?)
CRITICAL: Onboarding should get users to value as quickly as possible, not teach everything possible.
明确用户需要学习的内容以及背后的原因：
  1. 识别挑战：
    • 用户想要完成什么目标？
    • 当前体验中哪些部分令人困惑或不够清晰？
    • 用户会在哪些环节卡住或流失？
    • 我们希望用户达成的"aha moment"是什么？
  2. 了解用户：
    • 用户的经验水平如何？（新手、资深用户、混合？）
    • 用户的动机是什么？（出于好奇探索？工作要求？）
    • 用户可投入的时间有多少？（5分钟？30分钟？）
    • 用户了解哪些同类替代产品？（从竞品迁移而来？首次接触该类产品？）
  3. 定义成功标准：
    • 用户要取得成功最少需要学习哪些内容？
    • 我们希望用户采取的核心动作是什么？（创建第一个项目？发送第一个邀请？）
    • 我们如何判断新手引导生效了？（完成率？价值交付耗时？）
重要提示：新手引导应该让用户尽可能快地获得价值，而不是教给用户所有内容。

Onboarding Principles

新手引导原则

Follow these core principles:
遵循以下核心原则：

Show, Don't Tell

展示而非告知

  • Demonstrate with working examples, not just descriptions
  • Provide real functionality in onboarding, not separate tutorial mode
  • Use progressive disclosure - teach one thing at a time
  • 通过可运行的示例演示，而非仅靠文字描述
  • 在新手引导中提供真实功能，而非独立的教程模式
  • 使用渐进式披露机制——一次只教一个知识点

Make It Optional (When Possible)

尽可能设置为可选

  • Let experienced users skip onboarding
  • Don't block access to product
  • Provide "Skip" or "I'll explore on my own" options
  • 允许经验丰富的用户跳过新手引导
  • 不要阻断产品的正常访问
  • 提供"跳过"或"我将自行探索"选项

Time to Value

价值交付时效

  • Get users to their "aha moment" ASAP
  • Front-load most important concepts
  • Teach 20% that delivers 80% of value
  • Save advanced features for contextual discovery
  • 尽快让用户到达他们的"aha moment"
  • 把最重要的概念放在最前面
  • 教授能带来80%价值的20%核心内容
  • 把高级功能留到上下文场景中再让用户发现

Context Over Ceremony

上下文优先而非流程形式

  • Teach features when users need them, not upfront
  • Empty states are onboarding opportunities
  • Tooltips and hints at point of use
  • 在用户需要的时候再教授功能用法，不要一开始就全部灌输
  • 空状态是很好的新手引导机会
  • 在使用位置提供工具提示和提示信息

Respect User Intelligence

尊重用户的智力

  • Don't patronize or over-explain
  • Be concise and clear
  • Assume users can figure out standard patterns
  • 不要高人一等的说教或者过度解释
  • 保持简洁清晰
  • 假设用户能够理解标准交互模式

Design Onboarding Experiences

设计新手引导体验

Create appropriate onboarding for the context:
结合上下文设计合适的新手引导：

Initial Product Onboarding

初始产品引导

Welcome Screen:
  • Clear value proposition (what is this product?)
  • What users will learn/accomplish
  • Time estimate (honest about commitment)
  • Option to skip (for experienced users)
Account Setup:
  • Minimal required information (collect more later)
  • Explain why you're asking for each piece of information
  • Smart defaults where possible
  • Social login when appropriate
Core Concept Introduction:
  • Introduce 1-3 core concepts (not everything)
  • Use simple language and examples
  • Interactive when possible (do, don't just read)
  • Progress indication (step 1 of 3)
First Success:
  • Guide users to accomplish something real
  • Pre-populated examples or templates
  • Celebrate completion (but don't overdo it)
  • Clear next steps
欢迎页：
  • 清晰的价值主张（这个产品是做什么的？）
  • 用户将学到什么/完成什么
  • 预估耗时（如实告知需要投入的时间）
  • 跳过选项（供经验丰富的用户使用）
账号设置：
  • 仅收集最少的必要信息（后续再补充更多信息）
  • 解释索要每一项信息的原因
  • 尽可能提供智能默认值
  • 合适的情况下支持社交登录
核心概念介绍：
  • 介绍1-3个核心概念（不要全部介绍）
  • 使用简单的语言和示例
  • 尽可能采用交互形式（动手操作，而非仅阅读）
  • 进度提示（第1步，共3步）
首次成功操作：
  • 引导用户完成真实的操作
  • 预填充的示例或模板
  • 庆祝完成（但不要过度）
  • 清晰的下一步指引

Feature Discovery & Adoption

功能发现与上手

Empty States: Instead of blank space, show:
  • What will appear here (description + screenshot/illustration)
  • Why it's valuable
  • Clear CTA to create first item
  • Example or template option
Example:
No projects yet
Projects help you organize your work and collaborate with your team.
[Create your first project] or [Start from template]
Contextual Tooltips:
  • Appear at relevant moment (first time user sees feature)
  • Point directly at relevant UI element
  • Brief explanation + benefit
  • Dismissable (with "Don't show again" option)
  • Optional "Learn more" link
Feature Announcements:
  • Highlight new features when they're released
  • Show what's new and why it matters
  • Let users try immediately
  • Dismissable
Progressive Onboarding:
  • Teach features when users encounter them
  • Badges or indicators on new/unused features
  • Unlock complexity gradually (don't show all options immediately)
空状态：不要展示空白区域，而是展示：
  • 这里会展示什么内容（描述+截图/插图）
  • 它的价值是什么
  • 清晰的CTA按钮来创建第一个条目
  • 示例或模板选项
示例：
No projects yet
Projects help you organize your work and collaborate with your team.
[Create your first project] or [Start from template]
上下文工具提示：
  • 在相关时机出现（用户第一次看到该功能时）
  • 直接指向对应的UI元素
  • 简短的说明+价值点
  • 可关闭（提供"不再显示"选项）
  • 可选的"了解更多"链接
功能公告：
  • 新功能发布时进行高亮展示
  • 说明新增内容以及其价值
  • 让用户可以立即试用
  • 可关闭
渐进式引导：
  • 用户遇到功能时再教授用法
  • 新的/未使用的功能上添加徽章或提示标识
  • 逐步开放复杂功能（不要立即展示所有选项）

Guided Tours & Walkthroughs

引导式游览与操作演示

When to use:
  • Complex interfaces with many features
  • Significant changes to existing product
  • Industry-specific tools needing domain knowledge
How to design:
  • Spotlight specific UI elements (dim rest of page)
  • Keep steps short (3-7 steps max per tour)
  • Allow users to click through tour freely
  • Include "Skip tour" option
  • Make replayable (help menu)
Best practices:
  • Interactive > passive (let users click real buttons)
  • Focus on workflow, not features ("Create a project" not "This is the project button")
  • Provide sample data so actions work
适用场景：
  • 功能繁多的复杂界面
  • 现有产品发生重大变更
  • 需要领域知识的行业特定工具
设计方法：
  • 高亮特定UI元素（其余页面变暗）
  • 保持步骤简短（每次游览最多3-7步）
  • 允许用户自由点击游览流程
  • 包含"跳过游览"选项
  • 支持重播（放在帮助菜单中）
最佳实践：
  • 交互>被动（让用户点击真实按钮）
  • 聚焦工作流，而非功能（"创建一个项目"而非"这是项目按钮"）
  • 提供示例数据保证操作可正常执行

Interactive Tutorials

交互式教程

When to use:
  • Users need hands-on practice
  • Concepts are complex or unfamiliar
  • High stakes (better to practice in safe environment)
How to design:
  • Sandbox environment with sample data
  • Clear objectives ("Create a chart showing sales by region")
  • Step-by-step guidance
  • Validation (confirm they did it right)
  • Graduation moment (you're ready!)
适用场景：
  • 用户需要动手实践
  • 概念复杂或陌生
  • 风险较高（最好在安全环境中练习）
设计方法：
  • 带有示例数据的沙箱环境
  • 清晰的目标（"创建一个展示各区域销售额的图表"）
  • 分步指引
  • 校验机制（确认用户操作正确）
  • 结业时刻（你已经准备就绪！）

Documentation & Help

文档与帮助

In-product help:
  • Contextual help links throughout interface
  • Keyboard shortcut reference
  • Search-able help center
  • Video tutorials for complex workflows
Help patterns:
  • ?
    icon near complex features
  • "Learn more" links in tooltips
  • Keyboard shortcut hints (
    ⌘K
    shown on search box)
产品内帮助：
  • 整个界面中都有上下文帮助链接
  • 快捷键参考
  • 可搜索的帮助中心
  • 复杂工作流的视频教程
帮助模式：
  • ?
    图标位于复杂功能附近
  • 工具提示中的"了解更多"链接
  • 快捷键提示（搜索框上显示 
    ⌘K
    ）

Empty State Design

空状态设计

Every empty state needs:
每个空状态都需要包含：

What Will Be Here

这里将展示什么内容

"Your recent projects will appear here"
"你的近期项目将展示在这里"

Why It Matters

它的价值是什么

"Projects help you organize your work and collaborate with your team"
"项目可以帮你整理工作，并和团队协作"

How to Get Started

如何开始

[Create project] or [Import from template]
[创建项目] 或 [从模板导入]

Visual Interest

视觉吸引力

Illustration or icon (not just text on blank page)
插图或图标（不要仅在空白页面上放文字）

Contextual Help

上下文帮助

"Need help getting started? [Watch 2-min tutorial]"
Empty state types:
  • First use: Never used this feature (emphasize value, provide template)
  • User cleared: Intentionally deleted everything (light touch, easy to recreate)
  • No results: Search or filter returned nothing (suggest different query, clear filters)
  • No permissions: Can't access (explain why, how to get access)
  • Error state: Failed to load (explain what happened, retry option)
"需要入门帮助？[观看2分钟教程]"
空状态类型：
  • 首次使用：从未使用过该功能（强调价值，提供模板）
  • 用户清空：用户主动删除了所有内容（轻量提示，便于重新创建）
  • 无结果：搜索或筛选没有返回结果（建议其他查询词，清空筛选条件）
  • 无权限：无法访问（解释原因，说明如何获取权限）
  • 错误状态：加载失败（解释发生了什么，提供重试选项）

Implementation Patterns

实现模式

Technical approaches:

技术方案：

Tooltip libraries: Tippy.js, Popper.js Tour libraries: Intro.js, Shepherd.js, React Joyride Modal patterns: Focus trap, backdrop, ESC to close Progress tracking: LocalStorage for "seen" states Analytics: Track completion, drop-off points
Storage patterns:
javascript
// Track which onboarding steps user has seen
localStorage.setItem('onboarding-completed', 'true');
localStorage.setItem('feature-tooltip-seen-reports', 'true');
IMPORTANT: Don't show same onboarding twice (annoying). Track completion and respect dismissals.
NEVER:
  • Force users through long onboarding before they can use product
  • Patronize users with obvious explanations
  • Show same tooltip repeatedly (respect dismissals)
  • Block all UI during tour (let users explore)
  • Create separate tutorial mode disconnected from real product
  • Overwhelm with information upfront (progressive disclosure!)
  • Hide "Skip" or make it hard to find
  • Forget about returning users (don't show initial onboarding again)
工具提示库：Tippy.js, Popper.js 游览库：Intro.js, Shepherd.js, React Joyride 模态框模式：焦点捕获、背景蒙层、ESC关闭 进度追踪：LocalStorage存储"已查看"状态 数据分析：追踪完成率、流失节点
存储模式：
javascript
// Track which onboarding steps user has seen
localStorage.setItem('onboarding-completed', 'true');
localStorage.setItem('feature-tooltip-seen-reports', 'true');
重要提示：不要重复展示相同的新手引导（会引起反感）。追踪完成状态，尊重用户的关闭操作。
绝对不要：
  • 在用户可以使用产品前强制完成冗长的新手引导
  • 用显而易见的解释说教，冒犯用户
  • 重复展示相同的工具提示（尊重关闭操作）
  • 游览过程中阻断所有UI交互（允许用户探索）
  • 创建和真实产品脱节的独立教程模式
  • 一开始就灌输过多信息（要渐进式披露！）
  • 隐藏"跳过"按钮或者让它很难找到
  • 忽略回访用户（不要再次展示初始新手引导）

Verify Onboarding Quality

验证新手引导质量

Test with real users:
  • Time to completion: Can users complete onboarding quickly?
  • Comprehension: Do users understand after completing?
  • Action: Do users take desired next step?
  • Skip rate: Are too many users skipping? (Maybe it's too long/not valuable)
  • Completion rate: Are users completing? (If low, simplify)
  • Time to value: How long until users get first value?
Remember: You're a product educator with excellent teaching instincts. Get users to their "aha moment" as quickly as possible. Teach the essential, make it contextual, respect user time and intelligence.
用真实用户测试：
  • 完成耗时：用户能否快速完成新手引导？
  • 理解程度：用户完成后是否理解相关内容？
  • 行动转化：用户是否采取了预期的下一步操作？
  • 跳过率：是否有太多用户选择跳过？（可能是引导太长/没有价值）
  • 完成率：用户是否完成了引导？（如果完成率低，要简化）
  • 价值交付耗时：用户获得首次价值需要多长时间？
记住：你是拥有出色教学直觉的产品教育者。要尽可能快地让用户到达他们的"aha moment"。教授核心内容，结合上下文场景，尊重用户的时间和智力。