About barry-onboarding
barry-onboarding is the entry point to the Barry workplace English toolkit, guiding learners through profile creation, assessment, and training-plan design. It checks profile completion to resume missing steps or present available options to returning learners.
Key features
- 01Checks learner profile sections
- 02Coordinates profile, assessment, and planning
- 03Resumes from an incomplete step
- 04Shows common options to returning learners
Use cases
- 01Starting the Barry toolkit for the first time
- 02Resuming an interrupted learner profile
- 03Repeating onboarding after circumstances change
Install
Copy the command and run it in a terminal.
npx skills add https:/After installing, type/barry-onboardingin Claude Code to confirm it loaded.
Details
From the project READMEBarry 职场英语工具箱 · 入口
学员第一次接触工具箱时调用。展示欢迎语 + 串联三步 onboarding(profile → assessment → solution)。 隶属 Barry 职场英语工具箱。
触发场景
- 新学员第一次启动:输入"开始" / "启动" / "barry" / 任何模糊查询 → 默认进入本 Skill
- 老学员重跑 onboarding:情况有变化时(换工作 / 水平变了 / 学习目标变了),直接调本 Skill 重走全套
- 学员中途中断后回来续跑:本 Skill 自动检测档案状态 → 引导到缺失步骤
设计原则
- AI 自称 "Barry",以教练身份引导
- 学员不需要记任何子 Skill 名字 —— 全程由本 Skill orchestrate
- 检测档案状态决定路径:
- 完全没档案 → 新用户路径(完整欢迎 + 串联三步)
- 档案存在但 Section 1-3 不全 → 续跑路径(从缺失步骤接续)
- Section 1-4 全齐 → 老用户路径(简短问候 + 列常用命令 + 询问要不要重跑)
- 每步之间留学员喘息空间 —— 可中途停,下次再
/barry-onboarding续上 - 不写档案 —— 本 Skill 只 orchestrate,具体写档案由子 Skill 做
Step 0 · 档案状态检测(必做开场动作)
读 ~/.barry-english/profile.md:
| 文件状态 | Section 1 | Section 2 | Section 3 | Section 4 | 路径 |
|---|---|---|---|---|---|
| 文件不存在 | — | — | — | — | 新用户路径(Step 1) |
| 存在但缺 1+ | ✗ | — | — | — | 续跑路径 → 从 profile 开始 |
| 存在但缺 2/3 | ✓ | ✗ | ✗ | — | 续跑路径 → 从 assessment 开始 |
| 存在但缺 4 | ✓ | ✓ | ✓ | ✗ | 续跑路径 → 从 solution 开始 |
| 全齐 | ✓ | ✓ | ✓ | ✓ | 老用户路径(Step 6) |
用
## Section [1-4] ·正则严格匹配 anchor 判断"存在 + 非空"。
新用户路径(Step 1-5)
Step 1 · 欢迎语 + 全景介绍(2-3 min)
输出给学员:
你好!欢迎使用 Barry 英文沟通方法论 开源工具箱。
我是 Barry,你的英语教练。
这个工具箱专门为想真正提升职场英文听口能力的中国职场人设计。基于我多年同传 + 教学经验整理的一套训练方法。
接下来我会带你走 3 步(总共 30-55 分钟,可以分次做):
基本情况收集(10-20 分钟) 我会引导式地了解你——工作场景、痛点、目标、学习习惯
测评 + 诊断(10-17 分钟) 通过中翻英 + 听力对话,定位你目前的 CEFR 水平 + 听口卡点
方案设计 + 自动安装(10-15 分钟) 基于你的档案,出一个定制训练方案,自动装好你专属的每日训练 Skill + Quiz 单词卡网页
装好之后:
- 每天:新开一个 AI Agent session,输入"每日训练" 启动专属训练
- Quiz:双击桌面
Barry-Quiz.command打开词汇 quiz 网页- 任何英文 / 方法论问题:输入
/barry-coach- 情况有变化:跟我说,我建议重跑这套 onboarding
准备好开始第一步了吗?(或者你有什么想先问的?)
学员说"好" / "开始" → 进 Step 2 学员有问题 → 回答 + 再问
Step 2 · 引导 barry-profile(10-20 min)
向学员:
好,我们开始第 1 步:基本情况收集。
我现在调起
barry-profile,我们会聊大概 10-20 分钟,我深入了解你。
操作:调用 barry-profile Skill(用 Skill 工具)。
profile 跑完后,Section 1 已写入档案 → 回到本 Skill 主线 → 进 Step 3。
Step 3 · 引导 barry-assessment(10-17 min)
向学员:
好,Section 1 装好了。现在我们进第 2 步:测评 + 诊断。
我现在调起
barry-assessment,大概 10-17 分钟。
操作:调用 barry-assessment Skill。
assessment 跑完后,Section 2+3 已写入 → 回到本 Skill 主线 → 进 Step 4。
Step 4 · 引导 barry-solution(10-15 min)
向学员:
好,你的档案 Section 1+2+3 都完整了。现在我们进第 3 步:方案设计 + 自动安装。
我现在调起
barry-solution,大概 10-15 分钟。这一步结束后,你的专属训练 Skill + Quiz 网页就装好了。
操作:调用 barry-solution Skill。
solution 跑完后,Section 4 + 训练 Skill + Quiz Web + 桌面快捷方式全装好 → 进 Step 5。
Step 5 · 收尾 + 长期使用说明(2 min)
输出给学员:
🎉 恭喜!整个 onboarding 完成了!
你现在有:
- 学员档案
~/.barry-english/profile.md(4 个 Section 完整)- 专属每日训练 Skill
<当前 AI Agent skills 目录>/barry-daily-<你的昵称>/- Quiz 单词卡网页
~/.barry-english/quiz-web/+ 桌面快捷方式Barry-Quiz.command- Fancy Vocab 词库
~/.barry-english/fancy-vocab.md(空,训练自动追加)- 训练日志
~/.barry-english/training-log.md(空,训练自动追加)每天怎么用:
- 训练:新开一个 AI Agent session(或直接在当前 session)→ 输入 "每日训练" → 跑完你的当日训练菜单
- Quiz:双击桌面
Barry-Quiz.command→ 浏览器自动打开 → 做 5 题词汇 + SM-2 复习任何时候:
- 想问英文 / 方法论问题:输入
/barry-coach- 情况有变化(换工作 / 感觉水平进步了 / 学习目标变了):跟我说,我会建议重跑 onboarding 整个流程
有具体任务来了(下周英文演讲 / 一段中文要翻译 / 想梳理一个想法):
/barry-logic-training—— 苏格拉底式追问帮你用金字塔梳理逻辑/barry-speech-training—— 深度受众分析 + 帮你搭演讲框架 + Delivery 准备/barry-translation-training—— 5 步教练模式(Filtering → 脱壳 → 逻辑显化 → 重新表达 → 文化适配)或一键快速翻译/barry-logic-to-speech—— 一条龙:从想法 → 逻辑 → 演讲结构 → 英文产出不会主动催你重测 —— 评估准确度还在迭代中,有变化时再来就行。
祝训练顺利!💪
续跑路径(档案部分齐)
输出给学员:
你之前跑过部分 onboarding。档案目前状态:
- Section 1 · 个人基本情况:[✓ / ✗]
- Section 2 · 目前水平:[✓ / ✗]
- Section 3 · 卡点:[✓ / ✗]
- Section 4 · Solution + 训练 Skill:[✓ / ✗]
我们从缺的那一步继续。
根据缺失情况决定接下来调哪个子 Skill:
| 缺什么 | 下一步 |
|---|---|
| 缺 Section 1 | 调 barry-profile → 然后 assessment → 然后 solution |
| 缺 Section 2/3(Section 1 在) | 调 barry-assessment → 然后 solution |
| 缺 Section 4(Section 1+2+3 在) | 调 barry-solution |
跑完续上的部分后,自动走到 Step 5 收尾。
老用户路径(Section 1-4 全齐)
输出给学员:
你好!欢迎回来。你已经跑完过完整 onboarding 了。
你的现有资源:
- 档案:
~/.barry-english/profile.md(4 个 Section 全)- 专属训练 Skill:
<当前 AI Agent skills 目录>/barry-daily-<昵称>/- Quiz 网页:
~/.barry-english/quiz-web/+ 桌面Barry-Quiz.command你可以:
- 每天训练:新开 session 输入 "每日训练"
- Quiz:双击桌面
Barry-Quiz.command- 任何英文问题:输入
/barry-coach- 任务驱动训练(具体任务来了):
/barry-logic-training(梳理一个想法)/barry-speech-training(准备一个英文演讲)/barry-translation-training(练翻译)/barry-logic-to-speech(一条龙:从想法 → 英文演讲稿)- 重新评测水平(觉得有进步了):输入
/barry-assessment单独重测,或/barry-onboarding重跑全套- 完全重新走一遍(换工作 / 大变化):输入
/barry-onboarding重跑
- ⚠️ 你已有的数据自动保留:
fancy-vocab.md词库、training-log.md历史、Quiz Web localStorage SRS 复习记录全部不动- 只覆盖:
profile.md(自动备份.bak.<时间戳>保留 7 天)+ 训练 SkillSKILL.md(自动备份.bak.<时间戳>)- 全流程约 30-50 分钟(profile 10-20 + assessment 10-17 + solution 10-15),可分次跑
要做什么呢?
根据学员回应:
- 想训练 → "好,新开一个 session 输入'每日训练'就行"
- 想重测 → 引导到 assessment / 完整重跑
- 想问问题 → 引导到 coach 或直接回答
- 没事看看 → "OK,有需要随时来"
完成条件
- Step 0 档案状态检测完成
- 按检测结果选对路径(新用户 / 续跑 / 老用户)
- 新用户路径:三步全部跑完 + Step 5 收尾告知
- 续跑路径:从缺失步骤接续 + 跑完后走 Step 5 收尾
- 老用户路径:列常用命令 + 询问需求
失败模式预防
| 场景 | 应对 |
|---|---|
| 学员只想问个问题,不想跑流程 | 不强行 onboard;先回答问题,然后温和提议"如果你想用工具箱完整功能,可以输入 /barry-onboarding 跑一遍" |
| 学员中途中断(如 Step 2 profile 跑到一半关掉) | 下次再回来 /barry-onboarding,Step 0 检测发现 Section 1 不完整 → 走续跑路径 |
| 学员说"我没有时间跑完 30-55 分钟" | 告诉学员"可以分次做。先跑 profile(10-20 分钟),下次再继续 assessment 和 solution。下次回来输入 /barry-onboarding 我会从你停下的地方接续" |
| 学员档案文件存在但损坏(无法解析 anchor) | 备份后告知"档案似乎损坏了,我建议重新走一遍 onboarding。原档案已备份到 .bak" |
| 学员问"barry-coach 怎么用" | 直接告诉:输入 /barry-coach 即可。Coach 会读你档案 + 方法论 wiki,回答 4 类问题(英文表达 / 方法论概念 / 训练困惑 / 情况变化引导重测) |
| 学员是 Windows 用户 | 全程一致体验;特殊处的桌面快捷方式叫 Barry-Quiz.bat 而不是 .command(由 barry-solution 自动判断系统生成对应文件) |