Back to Details

check-onboarding

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

/check-onboarding

/check-onboarding

Audit user onboarding experience. Output findings as structured report.
审计用户引导体验，输出结构化检查报告。

What This Does

功能说明

  1. Check first-run experience
  2. Measure time to "aha moment"
  3. Identify friction points
  4. Check empty states
  5. Check progressive disclosure
  6. Output prioritized findings (P0-P3)
This is a primitive. It only investigates and reports. Use 
/log-onboarding-issues
to create GitHub issues or 
/fix-onboarding
to fix.
  1. 检查首次启动体验
  2. 测算“核心价值体验”时长
  3. 识别流程摩擦点
  4. 检查空状态展示
  5. 检查渐进式信息披露设计
  6. 输出按优先级划分的检查结果（P0-P3）
这是一个基础工具，仅负责调研和输出报告。如需创建问题请使用
/log-onboarding-issues
，如需修复问题请使用
/fix-onboarding
。

Process

审计流程

1. First-Run Experience Check

1. 首次启动体验检查

bash
undefined
bash
undefined

Onboarding flow exists?

Onboarding flow exists?

find . -path "onboarding" -name ".tsx" 2>/dev/null | head -5 find . -path "welcome" -name ".tsx" 2>/dev/null | head -5
find . -path "onboarding" -name ".tsx" 2>/dev/null | head -5 find . -path "welcome" -name ".tsx" 2>/dev/null | head -5

New user detection?

New user detection?

grep -rE "isNewUser|firstVisit|hasCompletedOnboarding|onboardingComplete" --include=".ts" --include=".tsx" . 2>/dev/null | grep -v node_modules | head -5
grep -rE "isNewUser|firstVisit|hasCompletedOnboarding|onboardingComplete" --include=".ts" --include=".tsx" . 2>/dev/null | grep -v node_modules | head -5

Tour/walkthrough?

Tour/walkthrough?

grep -rE "tour|Tour|walkthrough|Walkthrough|shepherd|driver.js|intro.js" --include=".tsx" --include=".ts" . 2>/dev/null | grep -v node_modules | head -5
undefined
grep -rE "tour|Tour|walkthrough|Walkthrough|shepherd|driver.js|intro.js" --include=".tsx" --include=".ts" . 2>/dev/null | grep -v node_modules | head -5
undefined

2. Authentication Flow Check

2. 认证流程检查

bash
undefined
bash
undefined

Auth callback handling?

Auth callback handling?

find . -path "callback" -o -path "auth" -name "*.tsx" 2>/dev/null | head -5
find . -path "callback" -o -path "auth" -name "*.tsx" 2>/dev/null | head -5

Post-signup redirect?

Post-signup redirect?

grep -rE "signUp.redirect|afterSignUp|signUpUrl" --include=".ts" --include="*.tsx" . 2>/dev/null | grep -v node_modules | head -5
grep -rE "signUp.redirect|afterSignUp|signUpUrl" --include=".ts" --include="*.tsx" . 2>/dev/null | grep -v node_modules | head -5

Profile completion?

Profile completion?

grep -rE "completeProfile|setupProfile|profile.setup" --include=".tsx" . 2>/dev/null | grep -v node_modules | head -5
undefined
grep -rE "completeProfile|setupProfile|profile.setup" --include=".tsx" . 2>/dev/null | grep -v node_modules | head -5
undefined

3. Empty States Check

3. 空状态检查

bash
undefined
bash
undefined

Empty state components?

Empty state components?

grep -rE "empty|Empty|no.found|NoResults|EmptyState" --include=".tsx" components/ 2>/dev/null | head -5
grep -rE "empty|Empty|no.found|NoResults|EmptyState" --include=".tsx" components/ 2>/dev/null | head -5

Placeholder content for new users?

Placeholder content for new users?

grep -rE "placeholder|getStarted|Get Started|Create.first" --include=".tsx" . 2>/dev/null | grep -v node_modules | head -5
grep -rE "placeholder|getStarted|Get Started|Create.first" --include=".tsx" . 2>/dev/null | grep -v node_modules | head -5

Loading states?

Loading states?

grep -rE "loading|Loading|skeleton|Skeleton|shimmer" --include="*.tsx" components/ 2>/dev/null | head -5
undefined
grep -rE "loading|Loading|skeleton|Skeleton|shimmer" --include="*.tsx" components/ 2>/dev/null | head -5
undefined

4. Friction Point Detection

4. 摩擦点检测

bash
undefined
bash
undefined

Required fields on first interaction?

Required fields on first interaction?

grep -rE "required|isRequired|*.required" --include=".tsx" . 2>/dev/null | grep -v node_modules | head -10
grep -rE "required|isRequired|*.required" --include=".tsx" . 2>/dev/null | grep -v node_modules | head -10

Form complexity?

Form complexity?

form_fields=$(grep -rE "<input|<Input|<TextField" --include="*.tsx" . 2>/dev/null | grep -v node_modules | wc -l | tr -d ' ') echo "Form fields count: $form_fields"
form_fields=$(grep -rE "<input|<Input|<TextField" --include="*.tsx" . 2>/dev/null | grep -v node_modules | wc -l | tr -d ' ') echo "Form fields count: $form_fields"

Payment wall before value?

Payment wall before value?

grep -rE "subscribe.*before|payment.*required|upgrade.to" --include=".tsx" . 2>/dev/null | grep -v node_modules | head -5
undefined
grep -rE "subscribe.*before|payment.*required|upgrade.to" --include=".tsx" . 2>/dev/null | grep -v node_modules | head -5
undefined

5. Progressive Disclosure Check

5. 渐进式信息披露检查

bash
undefined
bash
undefined

Tooltips for guidance?

Tooltips for guidance?

grep -rE "tooltip|Tooltip|hint|Hint" --include="*.tsx" components/ 2>/dev/null | head -5
grep -rE "tooltip|Tooltip|hint|Hint" --include="*.tsx" components/ 2>/dev/null | head -5

Feature discovery?

Feature discovery?

grep -rE "new.*feature|beta|coming.soon|tip|Tip" --include=".tsx" . 2>/dev/null | grep -v node_modules | head -5
grep -rE "new.*feature|beta|coming.soon|tip|Tip" --include=".tsx" . 2>/dev/null | grep -v node_modules | head -5

Contextual help?

Contextual help?

grep -rE "help|Help|info|Info|learn.more|LearnMore" --include=".tsx" components/ 2>/dev/null | head -5
undefined
grep -rE "help|Help|info|Info|learn.more|LearnMore" --include=".tsx" components/ 2>/dev/null | head -5
undefined

6. Aha Moment Path

6. 核心价值体验路径

Analyze the path to core value:
bash
undefined
分析用户抵达核心价值的路径：
bash
undefined

Main action identification

Main action identification

grep -rE "create|Create|add|Add|import|Import|generate|Generate" --include="*.tsx" app/ 2>/dev/null | head -10
grep -rE "create|Create|add|Add|import|Import|generate|Generate" --include="*.tsx" app/ 2>/dev/null | head -10

Steps to first success?

Steps to first success?

Check for multi-step forms, wizards, or complex setup

Check for multi-step forms, wizards, or complex setup

grep -rE "step|Step|wizard|Wizard|progress|Progress" --include="*.tsx" . 2>/dev/null | grep -v node_modules | head -5
undefined
grep -rE "step|Step|wizard|Wizard|progress|Progress" --include="*.tsx" . 2>/dev/null | grep -v node_modules | head -5
undefined

7. Retention Hooks

7. 留存钩子检查

bash
undefined
bash
undefined

Notification permissions?

Notification permissions?

grep -rE "Notification|push|Push|notification" --include="*.tsx" . 2>/dev/null | grep -v node_modules | head -5
grep -rE "Notification|push|Push|notification" --include="*.tsx" . 2>/dev/null | grep -v node_modules | head -5

Email capture?

Email capture?

grep -rE "email|newsletter|subscribe" --include="*.tsx" . 2>/dev/null | grep -v node_modules | head -5
grep -rE "email|newsletter|subscribe" --include="*.tsx" . 2>/dev/null | grep -v node_modules | head -5

Save progress?

Save progress?

grep -rE "draft|Draft|autosave|Autosave|save.progress" --include=".tsx" . 2>/dev/null | grep -v node_modules | head -5
undefined
grep -rE "draft|Draft|autosave|Autosave|save.progress" --include=".tsx" . 2>/dev/null | grep -v node_modules | head -5
undefined

Output Format

输出格式

markdown
undefined
markdown
undefined

Onboarding Audit

用户引导审计

P0: Critical (Users Immediately Lost)

P0：严重级别（用户立即流失）

  • No onboarding flow - Users dropped into empty app
  • Auth callback broken - Users stuck after signup
  • Required payment before seeing product value
  • 无引导流程 - 用户直接进入空应用
  • 认证回调失效 - 用户注册后陷入停滞
  • 查看产品价值前需完成付费

P1: Essential (Activation Blockers)

P1：必要级别（激活阻碍）

  • No empty states - Blank screens confuse new users
  • No guidance on first action
  • Complex form on first interaction (15+ fields)
  • No loading states (user thinks app is broken)
  • 无空状态展示 - 空白界面令新用户困惑
  • 无首次操作引导
  • 首次交互表单过于复杂（15个以上字段）
  • 无加载状态（用户误以为应用已崩溃）

P2: Important (Friction Reducers)

P2：重要级别（减少摩擦）

  • No progressive disclosure (all features visible immediately)
  • No tooltips/hints for new users
  • No tour/walkthrough option
  • Post-signup redirect goes to generic dashboard
  • 无渐进式信息披露（所有功能立即全部展示）
  • 无面向新用户的提示框/指引
  • 无引导 tour/分步指引选项
  • 注册后重定向至通用仪表盘

P3: Retention Enhancers

P3：留存增强级别

  • No notification permission request
  • No email capture for non-logged-in users
  • No "save progress" for long workflows
  • No "welcome back" experience
  • 未请求通知权限
  • 未捕获非登录用户的邮箱
  • 长流程无“保存进度”功能
  • 无“欢迎回来”体验

Onboarding Metrics (Estimated)

引导流程指标（估算）

  • Steps to first value: 5+ (target: 2-3)
  • Required fields before value: 8 (target: 0-2)
  • Time to "aha": Unknown (add analytics)
  • 抵达核心价值的步骤数：5步以上（目标：2-3步）
  • 抵达价值前的必填字段数：8个（目标：0-2个）
  • 核心价值体验时长：未知（需添加埋点分析）

Current Status

当前状态

  • First-run flow: Missing
  • Empty states: Partial
  • Progressive disclosure: None
  • Friction level: High
  • 首次启动流程：缺失
  • 空状态展示：部分覆盖
  • 渐进式信息披露：无
  • 摩擦程度：高

Summary

总结

  • P0: 1 | P1: 4 | P2: 4 | P3: 3
  • Recommendation: Add empty states and reduce first-action friction
undefined
  • P0：1项 | P1：4项 | P2：4项 | P3：3项
  • 建议：补充空状态展示，减少首次操作摩擦
undefined

Priority Mapping

优先级映射

GapPriority
No onboarding flowP0
Broken auth callbackP0
Paywall before valueP0
No empty statesP1
No first-action guidanceP1
Complex initial formsP1
No loading statesP1
No progressive disclosureP2
No tooltips/hintsP2
No tour optionP2
Notification captureP3
Email captureP3
问题优先级
无引导流程P0
认证回调失效P0
价值体验前需付费P0
无空状态展示P1
无首次操作引导P1
初始表单过于复杂P1
无加载状态P1
无渐进式信息披露P2
无提示框/指引P2
无引导选项P2
未捕获通知权限P3
未捕获邮箱P3

Related

相关工具

  • /log-onboarding-issues
    - Create GitHub issues from findings
  • /fix-onboarding
    - Fix onboarding issues
  • /cro
    - Conversion rate optimization
  • /log-onboarding-issues
    - 基于检查结果创建GitHub问题
  • /fix-onboarding
    - 修复引导流程问题
  • /cro
    - 转化率优化