Back to Details

log-onboarding-issues

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

/log-onboarding-issues

/log-onboarding-issues

Run onboarding audit and create GitHub issues for all findings.
执行新用户引导（onboarding）审计，并为所有检查结果创建GitHub issues。

What This Does

功能说明

  1. Invoke 
    /check-onboarding
    to audit new user experience
  2. Parse findings by priority (P0-P3)
  3. Check existing issues to avoid duplicates
  4. Create GitHub issues for each finding
This is an issue-creator. It creates work items, not fixes. Use 
/fix-onboarding
to fix issues.
  1. 调用/check-onboarding技能来审计新用户体验
  2. 按优先级（P0-P3）解析检查结果
  3. 检查现有issues以避免重复创建
  4. 为每个检查结果创建GitHub issues
这是一个issue创建工具，它仅创建工作项，不修复问题。如需修复问题，请使用/fix-onboarding。

Process

执行流程

1. Run Primitive

1. 调用基础技能

Invoke 
/check-onboarding
skill to get structured findings.
调用/check-onboarding技能以获取结构化的检查结果。

2. Check Existing Issues

2. 检查现有Issues

bash
gh issue list --state open --label "domain/onboarding" --limit 50
bash
gh issue list --state open --label "domain/onboarding" --limit 50

3. Create Issues

3. 创建Issues

For each finding:
bash
gh issue create \
  --title "[P0] No onboarding flow - users dropped into empty app" \
  --body "$(cat <<'EOF'
针对每个检查结果执行以下操作：
bash
gh issue create \
  --title "[P0] No onboarding flow - users dropped into empty app" \
  --body "$(cat <<'EOF'

Problem

Problem

After signup, users land on an empty dashboard with no guidance. They don't know what to do first.
After signup, users land on an empty dashboard with no guidance. They don't know what to do first.

Impact

Impact

  • High drop-off after signup
  • Users never experience core value
  • Support tickets asking "how do I start?"
  • Lost users who never return
  • High drop-off after signup
  • Users never experience core value
  • Support tickets asking "how do I start?"
  • Lost users who never return

Suggested Fix

Suggested Fix

Run 
/fix-onboarding
or implement:
  1. First-run detection:
typescript
const isNewUser = !user.hasCompletedOnboarding;
if (isNewUser) redirect('/onboarding');
  1. Onboarding wizard:
  • Welcome screen
  • First action prompt
  • Success celebration
  1. Empty state with CTA: "Create your first X to get started"
Created by 
/log-onboarding-issues
EOF )"
--label "priority/p0,domain/onboarding,type/enhancement"
undefined
Run 
/fix-onboarding
or implement:
  1. First-run detection:
typescript
const isNewUser = !user.hasCompletedOnboarding;
if (isNewUser) redirect('/onboarding');
  1. Onboarding wizard:
  • Welcome screen
  • First action prompt
  • Success celebration
  1. Empty state with CTA: "Create your first X to get started"
Created by 
/log-onboarding-issues
EOF )"
--label "priority/p0,domain/onboarding,type/enhancement"
undefined

4. Issue Format

4. Issue格式规范

Title: 
[P{0-3}] Onboarding issue
Labels:
  • priority/p0
    | 
    priority/p1
    | 
    priority/p2
    | 
    priority/p3
  • domain/onboarding
  • type/enhancement
    | 
    type/bug
Body:
markdown
undefined
标题： 
[P{0-3}] Onboarding issue
标签：
  • priority/p0
    | 
    priority/p1
    | 
    priority/p2
    | 
    priority/p3
  • domain/onboarding
  • type/enhancement
    | 
    type/bug
正文：
markdown
undefined

Problem

Problem

What's broken in new user experience
What's broken in new user experience

Impact

Impact

Effect on activation and retention
Effect on activation and retention

Suggested Fix

Suggested Fix

Code snippet, pattern, or skill to run
Created by 
/log-onboarding-issues
undefined
Code snippet, pattern, or skill to run
Created by 
/log-onboarding-issues
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
Retention hooks missingP3
问题缺口优先级
无新用户引导流程P0
授权回调失败P0
体验核心价值前出现付费墙P0
无空状态提示P1
无首次操作引导P1
初始表单过于复杂P1
无加载状态提示P1
无渐进式信息披露P2
无提示框/提示信息P2
无引导 tour 选项P2
缺少用户留存钩子P3

Output

输出结果

After running:
Onboarding Issues Created:
- P0: 1 (no onboarding flow)
- P1: 4 (empty states, guidance, forms)
- P2: 3 (progressive disclosure, hints)
- P3: 2 (notifications, email capture)

Total: 10 issues created
View: gh issue list --label domain/onboarding
运行完成后会返回如下内容：
Onboarding Issues Created:
- P0: 1 (no onboarding flow)
- P1: 4 (empty states, guidance, forms)
- P2: 3 (progressive disclosure, hints)
- P3: 2 (notifications, email capture)

Total: 10 issues created
View: gh issue list --label domain/onboarding

Related

相关技能

  • /check-onboarding
    - The primitive (audit only)
  • /fix-onboarding
    - Fix onboarding issues
  • /cro
    - Conversion optimization
  • /groom
    - Full backlog grooming
  • /check-onboarding
    - 基础审计技能（仅审计）
  • /fix-onboarding
    - 修复新用户引导问题的技能
  • /cro
    - 转化率优化技能
  • /groom
    - 完整待办事项梳理技能