用途
impeccable-onboard 是 impeccable.style /onboard 工作流的纯技能（skills-only）等价版本，用于在仅支持技能的环境中运行原始的 Impeccable /onboard 流程。它面向需要设计或改进产品新手引导（onboarding）流程、空状态（empty states）和首次使用体验的场景，帮助用户快速理解、采纳并成功使用产品。
该技能将前端设计原则作为基础护栏，把用户提到的命令参数视为范围提示，并在上下文缺失时提出澄清问题。
主要能力
评估引导需求
技能会引导梳理以下问题：
- 识别挑战：用户想完成什么？当前体验中什么令人困惑或不清晰？用户在哪里卡住或流失？我们希望用户到达的"顿悟时刻"是什么？
- 理解用户：用户的经验水平如何（新手、高级用户、混合）？动机是什么（兴奋探索、工作需要）？愿意投入多少时间（5 分钟、30 分钟）？他们了解哪些替代方案（来自竞品、品类新手）？
- 定义成功：用户成功所需学习的最小内容是什么？希望用户采取的关键行动是什么（第一个项目、第一次邀请）？如何判断引导有效（完成率、价值实现时间）？
关键点：引导应尽快让用户获得价值，而不是尽可能多地教学。
引导原则
- 展示而非说教：用可运行的示例演示，而非仅描述；在引导中提供真实功能，而非独立的教程模式；使用渐进式披露，一次只教一件事。
- 尽可能可选：让有经验的用户跳过引导；不要阻断产品访问；提供"跳过"或"我自己探索"选项。
- 价值实现时间：尽快让用户到达"顿悟时刻"；把最重要的概念前置；教授带来 80% 价值的 20% 内容；高级功能留待情境化发现。
- 情境优于仪式：在用户需要时教授功能，而非一开始就全部灌输；空状态是引导机会；在使用的当下提供工具提示和提示。
- 尊重用户智力：不要居高临下或过度解释；简洁清晰；假设用户能理解标准模式。
设计引导体验
初始产品引导：
- 欢迎屏幕：清晰的价值主张（这是什么产品）、用户将学到/完成什么、诚实的时间预估、为有经验用户提供跳过选项。
- 账户设置：最小必填信息（后续再收集更多）、解释为何索取每项信息、尽可能使用智能默认值、适当时提供社交登录。
- 核心概念介绍：介绍 1-3 个核心概念（而非全部）、使用简单语言和示例、尽可能交互（做而非只读）、显示进度（第 1 步，共 3 步）。
- 首次成功：引导用户完成真实任务、预填示例或模板、庆祝完成（但不过度）、给出清晰的下一步。
功能发现与采纳：
- 空状态：不要留白，而应展示这里将出现什么（描述 + 截图/插图）、为什么有价值、创建第一项的清晰 CTA、示例或模板选项。示例："还没有项目。项目帮助你组织工作并与团队协作。[创建你的第一个项目] 或 [从模板开始]"。
- 情境化工具提示：在相关时刻出现（用户首次看到该功能时）、直接指向相关 UI 元素、简短说明 + 好处、可关闭（含"不再显示"选项）、可选"了解更多"链接。
- 功能公告：在发布新功能时突出显示、展示新内容及为何重要、让用户立即尝试、可关闭。
- 渐进式引导：在用户遇到功能时教授、在新/未使用功能上显示徽章或指示器、逐步解锁复杂度（不要立即显示所有选项）。
引导式导览与走查：
- 何时使用：功能繁多的复杂界面、现有产品的重大变更、需要领域知识的行业专用工具。
- 如何设计：聚光特定 UI 元素（调暗页面其余部分）、保持步骤简短（每次导览最多 3-7 步）、允许用户自由点击浏览、包含"跳过导览"选项、可重播（帮助菜单）。
- 最佳实践：交互优于被动（让用户点击真实按钮）、聚焦工作流而非功能（"创建项目"而非"这是项目按钮"）、提供示例数据以便操作可运行。
交互式教程：
- 何时使用：用户需要动手练习、概念复杂或不熟悉、高风险（最好在安全环境中练习）。
- 如何设计：带示例数据的沙盒环境、清晰目标（"创建一张按地区显示销售额的图表"）、分步指导、验证（确认操作正确）、毕业时刻（你准备好了！）。
文档与帮助：
- 产品内帮助：界面各处的上下文帮助链接、键盘快捷键参考、可搜索的帮助中心、复杂工作流的视频教程。
- 帮助模式：复杂功能旁的 ? 图标、工具提示中的"了解更多"链接、键盘快捷键提示（搜索框上显示 ⌘K）。
空状态设计
每个空状态都需要：
- 这里将出现什么："你最近的项目将出现在这里"。
- 为什么重要："项目帮助你组织工作并与团队协作"。
- 如何开始：[创建项目] 或 [从模板导入]。
- 视觉趣味：插图或图标（而非空白页上的纯文本）。
- 上下文帮助："需要帮助入门？[观看 2 分钟教程]"。
空状态类型：
- 首次使用：从未用过此功能（强调价值，提供模板）。
- 用户清空：有意删除了一切（轻触，易于重建）。
- 无结果：搜索或筛选无返回（建议不同查询，清除筛选）。
- 无权限：无法访问（解释原因及如何获取访问权）。
- 错误状态：加载失败（解释发生了什么，提供重试选项）。
实现模式
技术方案：
- 工具提示库：Tippy.js、Popper.js
- 导览库：Intro.js、Shepherd.js、React Joyride
- 模态模式：焦点陷阱、背景遮罩、ESC 关闭
- 进度跟踪：用 LocalStorage 记录"已看过"状态
- 分析：跟踪完成率、流失点
存储模式：
// Track which onboarding steps user has seen
localStorage.setItem('onboarding-completed', 'true');
localStorage.setItem('feature-tooltip-seen-reports', 'true');
重要：不要两次显示同一引导（令人厌烦）。跟踪完成情况并尊重关闭操作。
应避免的做法
- 在用户能使用产品前强制走完冗长引导。
- 用显而易见的解释居高临下地对待用户。
- 反复显示同一工具提示（尊重关闭操作）。
- 导览期间阻断所有 UI（让用户探索）。
- 创建与真实产品脱节的独立教程模式。
- 一开始就用信息淹没用户（应渐进式披露！）。
- 隐藏"跳过"或使其难以找到。
- 忘记回访用户（不要再次显示初始引导）。
验证引导质量
用真实用户测试：
- 完成时间：用户能否快速完成引导？
- 理解度：用户完成后是否理解？
- 行动：用户是否采取期望的下一步？
- 跳过率：是否太多用户跳过？（也许太长/无价值）
- 完成率：用户是否完成？（若低，则简化）
- 价值实现时间：用户多久获得首次价值？
使用方式
该技能以纯技能形式运行原始的 Impeccable /onboard 工作流。用户可提供命令参数作为范围提示；当上下文缺失时，技能会提出澄清问题。具体安装命令与调用方式在所提供的资料中暂未提供。
适用场景
- 设计或改进产品的新手引导流程。
- 设计空状态与首次使用体验。
- 设计引导式导览、交互式教程与产品内帮助。
- 评估现有引导流程的质量与流失点。
限制
- 资料中未提供具体的安装命令、调用方式、收费或价格信息。
- 资料中未提供支持的平台或运行环境信息。
- 资料中未提供实际效果或性能数据。