Barry Learner Profile · Section 4 (Solution) + Automatic Generation of a Personalized Daily Training Skill

10–15 minutes, based on learner profile Section 1+2+3 + [[Four-Strands-训练方法工具箱]], design the Section 4 training plan + automatically install
<current AI Agent skills directory>/barry-daily-<nickname>/
. Part of the Barry Workplace English Toolkit.

Trigger Scenarios

New learner's first run: Invoked by the
```
barry-onboarding
```
orchestrator as step 3 of the workflow, after
```
barry-assessment
```
.
Returning learner invokes it directly: Re-generate the plan after updating profile Section 2/3; or, after the learner reports a change in circumstances, such as a new job or a change in proficiency, complete profile + assessment again before invoking this Skill.

Target Outputs

Write or Update File 1: Learner Profile Section 4

Section 4 · Solution in

~/.barry-english/profile.md

(see the schema for details).

Output File 2: Personalized Daily Training Skill

Write

<current AI Agent skills directory>/barry-daily-<lowercase-nickname-without-spaces>/SKILL.md

and automatically install it after obtaining the learner's authorization.

Output File 3: Training Log (empty placeholder)

~/.barry-english/training-log.md

, for the subsequent training Skill to append to.

Output Folder 4: Quiz Web Code (local vocabulary-bank quiz)

~/.barry-english/quiz-web/

, containing the Quiz-related code extracted from the Barry dashboard (

server.js

+ the Quiz section of

index.html

Writing the profile or SKILL must follow the profile-writing rules in
Step 3
below: backup + strict anchor matching + full-file overwrite + verification. This Skill is self-contained; the writing procedure is inline and does not depend on external files.

Design Principles (Must Be Followed Throughout)

The AI calls itself “Barry” and guides the learner in the role of a coach.
Execution is only allowed with a complete profile: if any of Section 1+2+3 is missing, refuse execution immediately and instruct the learner to run the prerequisite Skills first. Partial execution is not allowed.
The toolbox is the SoT: all training methods, allocation ratios, chunk-screening thresholds, and FD embedding logic must come from [[Four-Strands-训练方法工具箱]]. Do not invent alternatives.
FD is excluded from the allocation table: Section 4 only lists MFI / MFO / LFL as three equal pillars, with A/B/C all set to 1:1:1. FD is implemented by marking “includes FD pressure drill” within the MFI retelling and MFO Mini-Pre training items, with an appropriate level for B and mandatory use for C.
Chunk-screening thresholds adapt to the learner's level: the Skill's criteria for adding chunks to the vocabulary bank must dynamically adjust according to the learner's overall CEFR level. A C1 learner must not collect basic vocabulary.
Do not proactively schedule reassessment reminders: the training Skill must not include reminders such as “three months have passed; please take another assessment.” When the learner proactively reports a change in circumstances, such as a new job, a change in proficiency, or a change in goals, proactively recommend rerunning the entire onboarding workflow.
Use the training duration entered by the learner: read the number under “Daily Available Time” in Section 1 directly; do not replace it with a fixed archived value. ⚠️ Do not cut the three core training actions. Determine FD pressure drills according to the available time:
- All learners complete the three core training actions (retelling + sight translation + Mini-Pre). Do not cut core training because the available time is short. Empirical confirmation shows that these three actions are important at every level, and removing any of them leaves the training incomplete.
- Detailed chunk explanations are not a separate training action. They are knowledge supplements attached to feedback during retelling and sight translation and do not take time from a separate activity.
- FD pressure drills (4-3-2) depend on available time + level:
  - Daily time ≥ 35 minutes + B/C level → enable FD by default, with Mini-Pre running two 4-3-2 rounds.
  - Daily time < 35 minutes → do not add FD automatically; it becomes optional, and the learner may add it manually if time allows. It is not mandatory.
  - Level A → do not add FD because it is not feasible at the foundational stage.
- Typical time allocations:
  - 30 min → three core training actions, approximately 10 min each, without FD pressure drills
  - 35–40 min → three core training actions + FD pressure drills for B/C levels
  - 45+ min → three core training actions + FD pressure drills + chunk expansion / second round
Training frequency is daily: allow at most 1–2 rest days per week, without mandating weekends as rest days. Lightweight repeat checks are allowed, such as noting that the learner has already trained today without blocking the session.
Profile writing is a background action: do not display a progress bar or a field table.
Automatic installation requires learner authorization: Step 4 must obtain explicit consent to install before writing to
```
<current AI Agent skills directory>/
```
.

Prerequisites (Hard Constraints)

When invoking barry-solution, first verify that the following file exists and that Section 1+2+3 have all been written across the four profile sections:

~/.barry-english/profile.md
  ├─ ## Section 1 · 个人基本情况  (by barry-profile)    ← 必须存在
  ├─ ## Section 2 · 目前水平       (by barry-assessment) ← 必须存在
  └─ ## Section 3 · 卡点           (by barry-assessment) ← 必须存在

If any section is missing, refuse execution immediately and display:

“Creating a plan requires a complete profile. You are currently missing Section <X> (<corresponding step>).

Please enter the following first:
/barry-profile
(collect basic information)
/barry-assessment
(assess proficiency and diagnose blockers)
Return after completing them and enter
/barry-solution
again.”

Assessment Workflow (5 Steps, 10–15 min)

Step 1 · 档案完整性检查        (1 min)   验证 Section 1+2+3 → 失败即终止
Step 2 · 档案回顾 + Section 4 设计 (5-8 min) 复述确认 + 按工具箱设计 + 学员 review
Step 3 · 写档案 Section 4      (1 min)   遵守写入约定
Step 4 · 生成 + 自动安装专属训练 Skill (3-5 min)
   4A · 取学员授权
   4B · 模板填空生成 SKILL.md
   4C · 自动安装到 <当前 AI Agent skills 目录>/barry-daily-<昵称>/
   4D · 复制 dashboard Quiz 代码到 ~/.barry-english/quiz-web/
   4E · 启动指引
Step 5 · 收尾 + 学员引导       (1 min)

Step 1 · Profile Integrity Check (1 min)

Operations:

Read
```
~/.barry-english/profile.md
```
. If the Read output is truncated, read the complete file in segments using offset/limit.
Parse it using the
```
## Section [1-4] · 
```
regular expression and verify that the Section 1+2+3 anchors all exist and contain non-empty content.
If any section is missing, output the refusal message from the “Prerequisites” section and terminate execution.
If everything is present, proceed to Step 2.

Opening message for an independent invocation or first entry:

Hi, I'm Barry, your English coach. I can see that you have completed profile + assessment and that your profile is complete. Over the next 10–15 minutes, we'll finalize your training plan, and then I'll install the daily training tool for you.

Opening message during orchestrator chaining:

Great, your profile is complete. Let's start designing the training plan.

Step 2 · Profile Review + Section 4 Design (5–8 min)

2A · Briefly Summarize the Profile for Learner Confirmation

Let me quickly summarize your situation so you can confirm that I understood it correctly:

You are [Section 1 position], and primarily use English in [Section 1 context]

Overall CEFR [Section 2 overall] (speaking [X] / listening [Y])

Main blockers: listening [Section 3 stage], pronunciation [status], grammar [status]

Learning objective: [Section 1 short-term objective]

Daily available time: [Section 1 duration]

Is that correct? Is there anything you would like to add or correct?

2B · Design the Section 4 Fields According to the Toolbox

See the “Section 4 Field-Filling Rules” section below for the logic behind each field.

Do not present a complete plan table directly to the learner. Review the items one by one in a conversational format:

“I suggest setting the training objective as follows: [move from X to Y within three months / perform W in scenario Z]. Does that work for you?”
“You marked [training prerequisite] in Section 3, so we will focus on resolving that during the first one to two weeks. Does that work?”
“Following your methodology, the Four Strands allocation gives MFI / MFO / LFL equal thirds of the available time. FD (fluency development) will not receive a separate time slice; I will embed it as pressure drills in the retelling and Mini-Pre activities. Does this arrangement work?”
“For your daily [Section 1 duration] minutes, I plan to allocate the time as follows...” (list the daily menu)
“For training materials, I suggest...” (provide specific sources)
“For stage milestones, my initial estimates are...” (one week / one month / three months)

After the learner says “yes” to an item or finishes adjusting it, remember that the profile must not be written yet. Wait until all six items are complete, then write it once during Step 3.

2C · Final Learner Review

Here is the complete plan: [Complete Section 4 content]

Does this plan work for you? Would you like to make any adjustments?

If the learner says OK → proceed to Step 3. If the learner requests changes → make the changes and obtain confirmation again.

Step 3 · Write Profile Section 4 (1 min)

Follow this five-step profile-writing procedure:

1. 备份 profile.md → .bak.<timestamp>
2. 读全文(若 Read 截断,offset/limit 分段读完整再合并)
3. 解析按 ## Section N · 严格匹配 anchor;插入或替换 Section 4
4. 用 Write 整文件覆写
5. 验证 4 个 section heading 仍能匹配 → 通过则删 7 天前 .bak

See the “Section 4 Field-Filling Rules” section below for the writing format.

Step 4 · Generate + Automatically Install the Personalized Training Skill (3–5 min)

4A · Obtain Learner Authorization (Required)

Next, I need to do two things:
Install a personalized daily training Skill named
barry-daily-<your-nickname>
in the current AI Agent's skills directory. — You can enter “daily training” each day to invoke it and complete that day's training.
Copy the Quiz flashcard web code to
~/.barry-english/quiz-web/
. — After launching the desktop shortcut, the browser opens automatically. The system selects the port, with 3456 as the default. You can run a five-question daily vocabulary test and SM-2 review.
Do you agree to the installation? If you do not, I will paste the SKILL.md content here so you can copy it manually.

If the learner explicitly says “agree,” “OK,” or “install it” → proceed to 4B. If the learner declines → fallback: output the SKILL.md content, provide manual copy-path instructions, skip 4C/4D, and proceed to Step 5.

4B · Generate the Personalized Training Skill Content

🔒 Pre-check (required): Before generation, scan the learner profile at

~/.barry-english/profile.md

and verify that Section 2 contains an IPA preference field (British / American). If it is missing, as may be the case for profiles generated before v0.4, ask the learner immediately:

Before installing the training Skill, I need to confirm one detail. The Skill annotates vocabulary with IPA transcriptions. Which pronunciation would you like?

A. British (British, RP) — for example, schedule = /ˈʃedjuːl/ and car = /kɑː/ (without r)

B. American (American, GA) — for example, schedule = /ˈskedʒuːl/ and car = /kɑːr/ (with r)

C. Either is fine — default to British

Which option would you like?

After the learner answers, append

IPA preference: British

IPA preference: American

to Section 2 of the profile; use “British” for option C. Then continue the 4B generation workflow.

Generate the complete SKILL.md according to the “Personalized Training Skill Generation Specification” section below.

Key variable replacements:

```
{{昵称}}
```
← Section 1 nickname, exactly as written
```
{{昵称-slug}}
```
← lowercase nickname with spaces and special characters removed, for use in paths and Skill names

{{综合CEFR}}

{{口语CEFR}}

{{听力CEFR}}

← Section 2

{{听力卡点}}

{{口语卡点}}

{{发音状态}}

{{语法状态}}

← Section 3

```
{{训练前置依赖}}
```
← training prerequisite in Section 3
```
{{每日时长}}
```
← daily available time from Section 1, using the learner's number directly
```
{{Four Strands 配比}}
```
← MFI/MFO/LFL at one third each, with minutes calculated as total time ÷ 3
```
{{每日训练菜单}}
```
← complete copy of the daily training menu in Section 4
```
{{词库门槛级别}}
```
← {{综合CEFR}}, used for chunk screening
```
{{音标偏好}}
```
← Section 2 IPA preference field, British / American; the Pre-check ensures that this field exists
```
{{今日日期}}
```
← YYYY-MM-DD

4C · Automatically Install into the Current AI Agent Skills Directory

First locate

ACTIVE_SKILLS_DIR

; do not hardcode a Claude path. Search in order and select the first existing or most plausible directory:

The user-level skills directory of the currently running Agent:
- General
```
npx skills
```
  directory:
```
~/.agents/skills
```
  (preferred)
- Claude Code:
```
~/.claude/skills
```
- Codex:
```
~/.codex/skills
```
- Cursor:
```
~/.cursor/skills
```

The current project's skills directory:

```
.agents/skills
```
```
.codex/skills
```
```
.cursor/skills
```

If it cannot be determined, ask the learner: “Which are you currently using: Claude Code, Codex, or Cursor?” and then select the corresponding directory.

Installation workflow:

1. 确保 ACTIVE_SKILLS_DIR 存在；不存在则 mkdir -p

2. 扫描 ACTIVE_SKILLS_DIR 下已有 barry-daily-* 目录(可能是学员之前用别的昵称跑过 onboarding 留下的残留)
   - 若返回 0 个 → 跳到 3
   - 若返回 1 个，且就是当前 <昵称-slug> → 跳到 3(走"已存在"分支)
   - 若返回 1+ 个其他 slug，或多个 → 进入 cleanup 询问：

   告诉学员:
   > "我看到你之前装过这些训练 Skill:
   >  - barry-daily-mike-wang(旧)
   >  - barry-daily-laowang(旧)
   >
   > 现在要装的新 Skill 是:barry-daily-<当前-slug>
   >
   > 旧的怎么处理?
   > A. 全部删除(推荐，避免触发"每日训练"时当前 AI Agent 不知道用哪个)
   > B. 保留(我会留着，但你新 Skill 装好后可能会跟旧的冲突)
   > C. 我自己挑(列出来一个一个问)"

   - 选 A → rm -rf 所有不是当前 slug 的 barry-daily-*
   - 选 B → 不动
   - 选 C → 逐个询问

3. 检查 ACTIVE_SKILLS_DIR/barry-daily-<昵称-slug>/ 是否已存在
   - 已存在 → 询问学员是否覆盖(可能是重跑 onboarding 后重生)
     - 同意 → 备份旧 SKILL.md 为 SKILL.md.bak.<YYYYMMDD-HHMMSS> 再覆写
     - 不同意 → 中断流程，告诉学员"那就保留旧版，这次 solution 不写入"
   - 不存在 → mkdir

4. Write SKILL.md 到 ACTIVE_SKILLS_DIR/barry-daily-<昵称-slug>/SKILL.md

5. Write 空文件 ~/.barry-english/training-log.md(若不存在)
   - 内容: "# <昵称> 的英语训练日志\n\n> 由 barry-daily-<昵称-slug> Skill 每天追加。\n"
   - 若已存在 → 不动(避免覆盖学员历史训练日志)

6. Write 空文件 ~/.barry-english/fancy-vocab.md(若不存在)
   - 内容: "# <昵称> 的 Fancy Vocab 词库\n\n> 由 barry-daily-<昵称-slug> + barry-coach 训练时自动追加。\n"
   - 若已存在 → 不动(保留学员积累的词汇)

4D · Copy the Dashboard Quiz Code to

~/.barry-english/quiz-web/

+ Generate a Desktop Shortcut

Step 1: Detect Node.js + Obtain Installation Authorization if Missing

bash

node --version

If Node.js is detected → proceed to Step 2.
If it is not detected → inform the learner and obtain installation authorization:

“I found that Node.js is not installed on your computer. The Quiz web app requires Node.js to run. It is a JavaScript runtime that is free and open source.

I recommend installing it because it is a required dependency for the Quiz web app.

Would you like to: A. Open the Chinese Node.js download page for you (https://nodejs.org/zh-cn/) and install it yourself (recommended; about three minutes) B. Skip the Quiz Web installation (the training Skill will still work, but you will not be able to use the flashcard quiz)

Which option, A or B?”

If the learner chooses A → run
```
open https://nodejs.org/zh-cn/
```
on Mac or
```
start https://nodejs.org/zh-cn/
```
on Windows, and provide clear installation instructions:
“On the official download page, select the LTS version—the green button on the left, or the recommended stable release:
- Mac M series (M1/M2/M3/M4): select macOS Installer (arm64)
- Mac Intel (before 2020): select macOS Installer (x64)
- Windows: select Windows Installer (.msi) (x64)
- Not sure which Mac you have? Click the Apple icon in the upper-left corner → About This Mac → check the “Chip” line. Apple M1/M2/M3/M4 = arm64, while Intel = x64.
Let me know when the installation is complete, and I will check again.”
After the learner says “installed,” check again and proceed to Step 2.
If the learner chooses B → skip the Quiz Web step. During Step 5, explain that Quiz Web was not installed and that they can return to
```
/barry-solution
```
after installing Node.js to complete it.

Step 2: Copy the quiz-web Resources to the Learner's Home Directory

Quiz Web: The source code has already been sanitized and shipped with the toolkit as a

quiz-web/

subdirectory of the

barry-solution

Skill. It is installed along with

barry-solution

when the learner uses

npx skills

First locate

QUIZ_SOURCE

, checking these locations in order and using the first that exists:

The
```
quiz-web/
```
directory under the current
```
barry-solution
```
Skill directory

Common installation paths:

~/.agents/skills/barry-solution/quiz-web

<current AI Agent skills directory>/barry-solution/quiz-web

~/.claude/skills/barry-solution/quiz-web

```
~/.codex/skills/barry-solution/quiz-web
```

~/.cursor/skills/barry-solution/quiz-web

The current project's
```
.agents/skills/barry-solution/quiz-web
```

If it cannot be found, do not rebuild the web app yourself. Ask the learner to rerun:
```
npx -y skills add InterpreterBarry/barry-english-toolkit -g --all
```

Example copy commands:

bash

mkdir -p ~/.barry-english
rm -rf ~/.barry-english/quiz-web
cp -R "$QUIZ_SOURCE" ~/.barry-english/quiz-web

The Methodology wiki is not installed here. It is installed with the
barry-methodology
resource Skill. barry-solution does not need to copy it again.

Design clarification: Quiz Web does not implement “automatic difficulty adjustment.” The Quiz is an SRS review tool for vocabulary that the learner adds personally. If the learner is expected to know how to spell a word they added, SM-2 automatically marks it for review if they cannot spell it correctly; reviewing it several times is part of SM-2's intended behavior. The actual level control occurs when words are added, as specified by the “Chunk-Screening Thresholds Increase Monotonically with Level” rule in the Four-Strands Training Methodology Toolbox. Settings still retain difficulty radio buttons so the learner can adjust it manually.

Key details (

server.js

already implements these; do not modify them):

parseFancyVocab()

parseFancyVocabSessions()

have been implemented.

The

FANCY_VOCAB

path is set to

path.join(os.homedir(), '.barry-english', 'fancy-vocab.md')

At startup, the server automatically: ① first reads the
```
QUIZ_PORT
```
environment variable, or otherwise uses
```
findAvailablePort
```
to find an available port starting from 3456; ② writes the actual port to
```
~/.barry-english/.quiz-port
```
as plain text containing one numeric line; and ③ also outputs
```
QUIZ_PORT=<n>\n
```
to stdout.
The server binds to
```
127.0.0.1
```
(IPv4 only). The startup script must use
```
http://127.0.0.1:<port>
```
rather than
```
localhost:<port>
```
to avoid IPv6 port conflicts caused by other services on the learner's machine.

Step 3: Generate the Desktop Shortcut (Mac / Windows)

Detect the operating system using Node.js

process.platform

(Mac =

'darwin'

, Windows =

'win32'

), not shell

uname

, because native Windows cmd does not include

uname

The startup script must sleep for one second to allow the server to write
.quiz-port
, then read the port from that file and use
open
or
start
to launch the browser.

Mac → Desktop

Barry-Quiz.command

Write the file

~/Desktop/Barry-Quiz.command

, then run

chmod +x

bash

#!/bin/bash
# =============================================
#  Barry Quiz - 桌面快捷启动
# =============================================

WORKDIR="$HOME/.barry-english/quiz-web"
PORT_FILE="$HOME/.barry-english/.quiz-port"

echo ""
echo "  📚 Barry Quiz"
echo "  ──────────────"
echo ""

# Check Node.js
if ! command -v node &> /dev/null; then
    echo "  ❌ 未找到 Node.js"
    echo ""
    echo "  请先安装 Node.js:"
    echo "  https://nodejs.org/"
    echo ""
    echo "  按任意键退出..."
    read -n 1
    exit 1
fi

# If quiz already running, just reopen browser using last known port
if [ -f "$PORT_FILE" ]; then
    LAST_PORT=$(cat "$PORT_FILE")
    if lsof -i :"$LAST_PORT" -sTCP:LISTEN &>/dev/null; then
        echo "  ✅ Quiz 已在运行(端口 $LAST_PORT),正在打开浏览器..."
        open "http://127.0.0.1:$LAST_PORT"
        echo "  按任意键退出此窗口..."
        read -n 1
        exit 0
    fi
fi

# Start server
echo "  🚀 启动 Quiz Web..."
cd "$WORKDIR" || exit 1
node server.js &
SERVER_PID=$!

# Wait up to 5s for server to write .quiz-port
ACTUAL_PORT=""
for i in 1 2 3 4 5; do
    sleep 1
    if [ -f "$PORT_FILE" ] && kill -0 $SERVER_PID 2>/dev/null; then
        ACTUAL_PORT=$(cat "$PORT_FILE")
        break
    fi
done

if [ -z "$ACTUAL_PORT" ] || ! kill -0 $SERVER_PID 2>/dev/null; then
    echo "  ❌ 服务器启动失败"
    echo "  按任意键退出..."
    read -n 1
    exit 1
fi

open "http://127.0.0.1:$ACTUAL_PORT"

echo "  ✅ Quiz 已启动!"
echo "  🌐 地址: http://127.0.0.1:$ACTUAL_PORT"
echo ""
echo "  关闭方式:关闭此终端窗口 或按 Ctrl+C"

wait $SERVER_PID

Windows → Desktop

Barry-Quiz.bat

Write the file

%USERPROFILE%\Desktop\Barry-Quiz.bat

bat

@echo off
REM ===========================================
REM   Barry Quiz - Desktop launcher
REM ===========================================

set WORKDIR=%USERPROFILE%\.barry-english\quiz-web
set PORT_FILE=%USERPROFILE%\.barry-english\.quiz-port

echo.
echo   Barry Quiz
echo   ----------
echo.

REM Check Node.js
where node >nul 2>nul
if errorlevel 1 (
    echo   [ERROR] Node.js not found
    echo.
    echo   Please install Node.js: https://nodejs.org/
    echo.
    pause
    exit /b 1
)

REM If quiz already running, reopen browser using last known port
if exist "%PORT_FILE%" (
    set /p LAST_PORT=<"%PORT_FILE%"
    netstat -ano | findstr :!LAST_PORT! | findstr LISTENING >nul
    if not errorlevel 1 (
        echo   Quiz already running on port !LAST_PORT!, opening browser...
        start http://127.0.0.1:!LAST_PORT!
        pause
        exit /b 0
    )
)

echo   Starting Quiz Web...
cd /d "%WORKDIR%"
start /b node server.js

REM Wait up to 5s for server to write .quiz-port
set ACTUAL_PORT=
for /l %%i in (1,1,5) do (
    timeout /t 1 /nobreak >nul
    if exist "%PORT_FILE%" (
        set /p ACTUAL_PORT=<"%PORT_FILE%"
        goto :got_port
    )
)
:got_port

if "%ACTUAL_PORT%"=="" (
    echo   [ERROR] Server failed to start
    pause
    exit /b 1
)

start http://127.0.0.1:%ACTUAL_PORT%
echo   Quiz started on port %ACTUAL_PORT%
echo   Close this window to stop.
pause

Key constraints:

The Mac and Windows flows must be exactly equivalent, providing a consistent learner experience.
Path handling: Mac uses
```
$HOME
```
; Windows uses
```
%USERPROFILE%
```
.
Browser launch: Mac uses
```
open
```
; Windows uses
```
start
```
.
The port is read from
```
~/.barry-english/.quiz-port
```
, which is written by
```
server.js
```
; do not hardcode 3456.

Step 4: Write Empty Training Support Files

~/.barry-english/training-log.md → 内容:"# <昵称> 的英语训练日志\n\n> 由 barry-daily-<昵称-slug> Skill 每天追加。\n"
~/.barry-english/fancy-vocab.md → 内容:"# <昵称> 的 Fancy Vocab\n\n> 由每日训练 Skill 自动追加,按 H3 日期 session 分组。\n"

4E · Startup Instructions

Everything is installed. Here is how to use it:
The personalized training Skill is installed at
barry-daily-<nickname-slug>/SKILL.md
in the current AI Agent skills directory. To use it, open a new AI Agent session and enter “daily training” or
/barry-daily-<nickname-slug>
.
The Quiz web app is installed at
~/.barry-english/quiz-web/
, and a desktop shortcut has been generated:
Mac: double-click
Barry-Quiz.command
on the desktop
Windows: double-click
Barry-Quiz.bat
on the desktop
Double-clicking it automatically starts the server and opens the browser at
http://127.0.0.1:<actual-port>
. The server writes the port to
~/.barry-english/.quiz-port
; 3456 is the default, and another port is selected automatically if it is occupied.
Fancy Vocab vocabulary bank:
~/.barry-english/fancy-vocab.md
(appended automatically after daily training and grouped by date session) Training log:
~/.barry-english/training-log.md
(appended automatically after daily training)

⭐ Preview of the First Day of Training Tomorrow

Core principles:

All levels complete the three core training actions (retelling + sight translation + Mini-Pre). They must not be removed because the learner's proficiency is low or the available time is short.
The AI adjusts difficulty through source-material complexity + scoring leniency, not by removing training actions.
Level A Mini-Pre means “speak 3–5 simple English sentences,” not a two-minute speech. Only levels B/C use one minute of planning plus a two-minute speech.
A level A Retell task must provide a specific material link, selected from the recommended-source list below, so the learner does not have to search for it.

Level A Learner (A1/A2) Sample

Here is what your first training day will look like tomorrow so that you know what to expect:

Step 1 · 听一段简单英文 + 中文复述(10 分钟)
  AI 推荐慢速英文素材给你(下面"A 级 Retell 推荐源清单"挑):
  - VOA Learning English (https://learningenglish.voanews.com/)
  - BBC Learning English (https://www.bbc.co.uk/learningenglish/)
  - English Class 101 (A1/A2 课程)
  - ESL Pod
  - 60-90 秒短片段,生词不多 / 语速慢 / 句式简单
  你听完 → 用中文跟我说大概讲了什么(英文复述等以后)
  AI 把关键英文小短语整理出来(配中文意思 + 例句)

Step 2 · 中翻英 1 句(10 分钟)
  AI 给你 1 句简单工作场景中文(比如"我每周开 2 次部门会议")
  你翻英文,翻得磕巴 / 不完整都没事
  AI 给标准版本 + 每个英文词都配中文意思 + 解释为什么这样翻

Step 3 · Mini-Pre(7-10 分钟,A 级降难度版)
  AI 出一个简单题目(比如 "Tell me 3-5 sentences about your work")
  你用最简单的英文讲 3-5 句完整的(不是 2 分钟演讲,3-5 句够)
  AI 鼓励为主 + 把你想说没说出来的地道表达给你(不打击)

Step 4 · 收尾(2 分钟)— 这是写日志,不是训练
  今日新词写入你的词库(明天打开 Quiz 自动复习)
  今日感受 1 句话写训练日志

Three core training actions plus the wrap-up take approximately 30 minutes per day. You are at the starting stage. Your goal is to build the feeling that “I can speak,” rather than pursuing speed or volume.

Level B Learner (B1/B2) Sample

Here is what your first training day will look like tomorrow:

Step 1 · 听力 + 复述(8-10 分钟)
  AI 推荐英文 podcast 片段(按你工作行业挑,2-3 分钟原速)
  你听完 → 用英文复述大意(允许中文 fallback 关键词)
  AI 给反馈 + 把生词块存进 fancy-vocab(按你美音/英音偏好标 IPA)

Step 2 · 中翻英 1-2 句视译(8-10 分钟)
  AI 给你 1-2 句中文(关联你工作场景)
  你翻英文(允许停顿、改、说错)
  AI 给地道版本对照 + 标关键词块

Step 3 · 即兴 Mini-Pre 1 题(8-12 分钟)
  AI 出题:1 分钟构思 + 2 分钟英文演讲(关联你工作)
  你讲完 → AI 评分 + 反馈
  时长 ≥ 35 min → 默认加 FD 加压(再压缩到 90 秒讲一遍)
  时长 < 35 min → FD 加压可选(学员有余力手动加)

Step 4 · 收尾(2 分钟)— 写日志,不是训练
  今日新词块写入 fancy-vocab(明天 Quiz 自动复现)
  今日感受 1 句话写训练日志

Three core training actions plus the wrap-up take approximately 30–35 minutes per day.

Level C Learner (C1+) Sample

The same as level B, except:

Step 1 Retelling must emphasize both structure and detail.

Step 2 uses longer and more complex sentences for sight translation; level B uses shorter sentences.

Step 3 Mini-Pre must use the 4-3-2 FD pressure drill: two minutes → 90 seconds → 60 seconds. Content is compressed, not spoken faster.

Recommended duration: 35–45 minutes.

Rules for Actual Generation

All levels complete the three core training actions (retelling + sight translation + Mini-Pre). They must not be cut.
The AI adjusts difficulty through materials + scoring leniency, not by removing training actions.
Required wording for a level A sample: describe Mini-Pre as “speak 3–5 simple English sentences,” not “give a two-minute speech.” Retell must provide a specific link from the recommended-source list below.
Determine FD pressure drills from the Section 1 duration: 30 min → three training actions without FD; 35–40 min → three training actions + the B/C 4-3-2 FD pressure drill; 45+ min → three training actions + FD + chunk expansion / second round.

⭐ Level A Retell Recommended-Source List (Material Library for the Daily Skill)

Retell is the only level A training activity that requires external audio material. Sight translation and Mini-Pre can both be generated directly by the AI. The daily Skill must proactively select a specific clip from the list below for the learner rather than asking the learner to search.

Source	URL	Suitable Level	Features
VOA Learning English	https://learningenglish.voanews.com/	A1–B1	Slow speed (~90 wpm), controlled vocabulary through the 1,500 most frequent words, 1–3-minute clips, and a transcript for every article
BBC Learning English	https://www.bbc.co.uk/learningenglish/	A2–B1	Includes a Lower Intermediate section, transcripts, and word explanations
English Class 101	https://www.englishclass101.com/	A1–A2	Absolute Beginner and Beginner courses, slow conversations, and short scenarios
ESL Pod	https://www.eslpod.com/	A2–B1	Slow speed, explanations, and transcripts
English with Lucy (YouTube)	https://www.youtube.com/@EnglishwithLucy	A2–B1	British pronunciation, slow pronunciation lessons, and suitable for British-accent learners
Speak English With Vanessa (YouTube)	https://www.youtube.com/@SpeakEnglishWithVanessa	A2–B1	American pronunciation and suitable for American-accent learners
Rachel's English (YouTube)	https://www.youtube.com/@rachelsenglish	A1–B1	American pronunciation, slow speed, and mouth-position demonstrations

Rules for the daily Skill when recommending materials to level A learners:

Choose according to the learner's IPA preference: British → BBC / English with Lucy; American → VOA / Speak English With Vanessa / Rachel's English.
Choose according to the learner's work context: sales → ESL Pod's business series; manufacturing → VOA Learning English's daily-life series.
Provide a specific clip link + title + duration, not only the main-site URL, such as “VOA Learning English: ‘How to Ask About Work’ (2:30).”
Rotate materials: do not recommend the same clip to the same learner within one week, because excessive familiarity reduces the training value.

Step 5 · Wrap-Up + Learner Guidance (1 min)

🎉 The entire onboarding process is complete. Here is how to proceed:

Every day, according to your schedule:
Open a new AI Agent session → enter “daily training” → run the personalized training Skill and complete that day's training.
After training, double-click
Barry-Quiz.command
on the desktop on Mac or
Barry-Quiz.bat
on Windows to launch the Quiz web app and complete five vocabulary questions + an SM-2 review.
For any questions about English or methodology: enter
/barry-coach
.
If your circumstances change (new job, perceived improvement, changed learning objective), tell me directly. I will recommend that you rerun the entire onboarding workflow (profile + assessment + solution).

I will not proactively pressure you to retest. The accuracy of the assessment is still being refined, so periodic retesting has limited value. Return when something changes.

Good luck with your training! 💪

Section 4 Field-Filling Rules (Based on [[Four-Strands-训练方法工具箱]])

Training Objective

Input: Section 1 short-term objective + Section 2 overall CEFR + Section 3 main blockers Output format (2–3 sentences):

Within three months: [specific achievable milestone tied to the learner's pain-point scenario] Example: “Within three months, I can follow most of what my manager says in one-on-one English phone meetings and respond spontaneously at key decision points.”

Key constraints:

The objective must be achievable and must not make unrealistic promises. Estimate it using the methodology's European Framework hours, where 30 minutes per day corresponds to approximately 180 hours over six months.
It must be tied to a real Section 1 scenario, not a vague goal such as “improve my English.”

Training Prerequisites

Input: training prerequisite from Section 3 Output: Copy it directly and convert it into a “focus during the first one to two weeks” training plan:

If pronunciation “seriously affects communication” → “During the first one to two weeks: one 1-to-1 pronunciation-correction lesson per week + 10 minutes of Shadowing every day.”
If grammar is “seriously deficient” → “During the first two weeks: targeted study of sentence components + the three-step intensive-reading method for 15 minutes every day. Do not begin sight translation yet.”
If everything is normal → “No prerequisites. Begin training directly according to the plan on Day 1.”

Four Strands Allocation

Always set MFI / MFO / LFL to three equal pillars at one third each, regardless of A/B/C level.

Exclude FD from the allocation table. Implement it by marking FD within the MFI Retelling and MFO Mini-Pre training items:

Level A: no FD marker
Level B: mark “includes light FD pressure drill” in Retelling and Mini-Pre
Level C: mark “includes 4-3-2 pressure drill” in Retelling and Mini-Pre

Daily Training Menu

Total duration = the learner's daily time from Section 1, used directly. Time per Strand = total duration ÷ 3, with an allowed adjustment of approximately ±2–3 minutes.

Rules for selecting a specific training method for each Strand (see toolbox sections 1.1–4.1):

MFI (Meaning-Focused Input) — Total Time ÷ 3

Learner Level	Recommended Combination (Random Rotation / Weekly Allocation)
A	Graded reading (AI-generated workplace content) + graded listening + Retelling (VOA Special English / BBC Learning English / VOA Learning English)
B	Graded reading + graded listening + Retelling (YouTube / TED Talk / TED-Ed) · includes light FD pressure drill
C	Graded reading (higher difficulty) + graded listening + Retelling (fast native content) · includes 4-3-2 pressure drill

MFO (Meaning-Focused Output) — Total Time ÷ 3

Learner Level	Recommended Combination
A	Conversation / speaking corner (AI voice tutor) + Mini Presentation (simple topics)
B	Conversation / speaking corner + Mini Presentation (workplace topics) · includes light FD pressure drill
C	Conversation / speaking corner + Mini Presentation (C1 topics) · includes 4-3-2 pressure drill + writing (optional, based on personal preference)

LFL (Language-Focused Learning) — Total Time ÷ 3

Learner Level	Recommended Combination
A	Quiz flashcards (SM-2) + Chinese-to-English written translation (simple sentences) + four-step dictation (short sentences) + basic grammar (simple and compound sentences)
B	Quiz flashcards + Chinese-to-English sight translation (paragraphs) + four-step dictation + advanced grammar (subject, predicate, object, attributive and complement clauses, subordinate clauses) + three-step intensive reading
C	Quiz flashcards (advanced screening) + Chinese-to-English sight translation (complex paragraphs) + three-step intensive reading + complex-sentence grammar

Additional items for all levels (embedded without allocating separate time):

Pronunciation: When the Step 4 training Skill starts, proactively ask once whether pronunciation is ever difficult for others to understand. If the learner says yes, mark “recommend finding a 1-to-1 pronunciation-correction teacher.”
Chunk accumulation (Cross-cutting mandatory): Automatically append chunks to
```
fancy-vocab.md
```
after each training activity, applying the learner's CEFR screening threshold.

Training Material Types + Recommended Sources

Provide specific sources according to the learner's level:

Type	Level A	Level B	Level C
Listening	VOA Special English / BBC Learning English	TED-Ed / YouTube talks / Steven Bartlett / Lex Fridman	Fast native conversation / industry interviews / 60 Minutes
Reading	AI-generated foundational workplace content	Simplified business news / short HBR articles	The Economist / HBR / industry white papers
Chinese-to-English Materials	AI-generated simple workplace scenarios	AI-generated complex workplace scenarios	AI-generated C1 abstract topics

Stage Milestones

One week: Complete training on 5–6 days + accumulate X chunks + complete the first Mini Presentation One month: [specific measurable goal, such as “understand at least 80% of BBC 6 Minute English and use X new collocations in Chinese-to-English translation”] Three months: [specific scenario ability aligned with the Section 1 short-term learning objective]

Do not impose scheduled reassessment checkpoints. According to the methodology, language proficiency changes noticeably only every three to six months, so scheduled retesting has limited value.

Personalized Training Skill Generation Specification

File Structure

<当前 AI Agent skills 目录>/barry-daily-<昵称-slug>/
└── SKILL.md  (单文件,自包含,不依赖其他 Skill)

Complete SKILL.md Template

Generate according to the following structure and replace the variables using the 4B rules:

markdown

---
name: barry-daily-<昵称-slug>
description: <昵称> 的专属每日英语训练 Skill。基于 Barry MCES 方法论 + 你的档案
            (CEFR <综合CEFR>,主要卡点 <主要卡点描述>) 定制,每天 <每日时长> 分钟。
            训练后自动追加词块到 Fancy Vocab + 写训练日志。
            触发词:每日训练 / daily training / barry training / 开始训练。
---

# <昵称> 的每日英语训练

> Powered by Barry Workplace English Toolkit · 基于 <今日日期> 档案定制
> 档案:`~/.barry-english/profile.md` · 训练日志:`~/.barry-english/training-log.md`
> Fancy Vocab:`~/.barry-english/fancy-vocab.md` · Quiz Web:`~/.barry-english/quiz-web/`

## 启动检查(1 min)

1. 读 `~/.barry-english/profile.md` —— verify 档案存在;不存在则提示"档案丢了,先跑 `/barry-onboarding` 重建",本 Skill 退出
2. 读 `~/.barry-english/training-log.md` —— lightweight 检查今天是否已训练:
   - 若有 → 友好提示"你今天已经训练过了。要再来一次吗?"(不阻拦,学员说"是"就继续)
   - 若无 → 进训练流程

## 你的档案速览

- **CEFR**:综合 <综合CEFR> · 口语 <口语CEFR> · 听力 <听力CEFR>
- **主要卡点**:
  - 听力:<听力卡点阶段> + <子表现>
  - 发音:<发音状态>
  - 语法支撑:<语法状态>
- **训练前置依赖**:<训练前置依赖>(若有)
- **每日时长**:<每日时长> 分钟
- **音标偏好**:<音标偏好>(英 / 美)
- **词库门槛**:只收 <词库门槛级别>+ 难度的词,跳过基础词

## 今日训练菜单

按 MFI / MFO / LFL 三足鼎立(各约 <每日时长 ÷ 3> 分钟),FD 嵌入复述 + Mini-Pre 加压。

| # | 时长 | Strand | 训练方法 | 备注 |
|---|---|---|---|---|
<动态生成的菜单行,基于学员档案 + 工具箱方法选择>

逐项执行,每项做完简短反馈,然后进下一项。

---

## 训练方法库(5 个标准方法 — 严格执行,不要改写)

> ⚠️ 下列 5 个方法是完整训练库。运行时按"今日训练菜单"对应行去执行某个方法,**完整保留步骤 + 反馈格式 + 评分要求**,不要省略、不要自己改写"灵活版"。
> ⚠️ 所有词汇表统一 5 列:`Expression | IPA(<音标偏好>) | Chinese | English Meaning | Example`。
> ⚠️ **IPA** 必须按学员档案 Section 2 的 `<音标偏好>` 输出(英音 = 无 r 卷舌、用 /ɒ/ 不用 /ɑː/;美音 = 带 r、用 /ɑː/)。
> ⚠️ **Example 必须中英双语**,格式 `English example sentence here.<br>中文翻译在这里。`(用 `<br>` 换行,这样低级别学员读起来不费劲)。

---

### 方法 1 · 分级听力 + 复述(MFI)

1. **选素材**:
   - A 级:推荐 [VOA Special English / BBC Learning English] 当中一段 3-5 分钟内容,或学员自己找简单内容
   - B/C 级:学员提供 [YouTube / TED / Steven Bartlett / Lex Fridman] 等的视频链接(3-5 分钟内一段),AI 抓 transcript 用(优先 `youtube_transcript_api`;字幕拿不到时回退到本地音频转写工具如 Whisper)
2. **学员听完一遍**(可用语音转文字 APP 如 Typeless / 闪电说做 backup)
3. **学员复述大意 + 关键论点**(英文优先,中文也接受)
4. **AI 反馈 + 评分(1-5,必给,综合 Completeness/Accuracy/Structure)**:

Retelling Feedback — Score: X/5

行文逻辑可视化(必含)

[脑图 / 缩进列表展示原文的主论点 → 分论点 → 论据 → 过渡 → 结论 + 论证手法标注:myth-busting / personal anecdote / contrast / callback 等]

评分维度(综合打分)

Completeness:主论点 / 分论点 / 例子是否覆盖全
Accuracy:内容是否与原文一致,有无误听 / 误解
Structure:复述逻辑线是否清晰

整理本次值得记的词块(按 <词库门槛级别>+ 难度筛,跳过基础词)

Expression	IPA(<音标偏好>)	Chinese	English Meaning	Example


5. **B/C 级:FD 加压**(若菜单标了"含 FD 加压"):
> "现在请用一半时间(<原时长÷2> 分钟)再讲一遍。"
再打一次分,对比第一轮看流利度提升。

⚠️ **评分必须附在反馈标题后(`## Retelling Feedback — Score: X/5`),不能省略。**

---

### 方法 2 · 中→英笔译 / 视译(LFL)

1. **AI 出题**:按学员级别 + Section 1 工作场景生成 **2 段中文**(每段 3-5 句,商务 / 职场场景,如汇报、谈判、跨部门协调、绩效、战略等)
- A 级:笔译(学员可以打字慢慢翻)
- B/C 级:视译(学员限时口头说出 / 打字一气呵成)
2. **学员翻译两段**

> ⚠️ **英文输出标点硬约束** — 所有 AI 给出的英文翻译(标准版本 + 逐句反馈里的"标准表达"列)**必须含标准标点**(逗号 / 句号 / 问号 / 感叹号);单句超过 25 词**必须拆句或加逗号**。**禁止输出无标点长段。**

3. **AI 反馈格式**(每段必按以下顺序含 4 板块,缺一不可):

Paragraph A — [主题]: X/5

你的版本:

[学员原文完整引用]

标准版本:

[完整段落,不是逐句碎片]

逐句反馈:

#	你的表达	问题	标准表达
1	...	...	...


⚠️ **绝对不能只给逐句反馈表而省略标准版本。**学员需要看到完整标准译文对照学习。

4. **🔒 Step 收尾(强制,不要等学员提醒)**:从 **2 段标准版本**(不是学员译文)中抽取地道表达。
- ✅ 抽:地道短语动词、商务 / 职场术语、形象 idiom、register 高的连接表达
- ❌ 跳过:学员译文里已自然产出过的 / 太基础的通用词(react quickly / important / compensation 等)/ fancy-vocab.md 已有的(先 Grep 确认)

**先展示候选清单给学员过目**,再保存:

📋 候选列表 — 标准版本中的地道表达

From Paragraph A ([主题])

#	Expression	Chinese	Why it's worth saving
1	push back on	反对、推回	比 complain 专业;职场最高频

From Paragraph B ([主题])

#	Expression	Chinese	Why it's worth saving


学员确认要存的项后,写入 `~/.barry-english/fancy-vocab.md`,按段落分两个 H3 子节:

YYYY-MM-DD — Translation Standard Expressions (Para A: [主题])

Expression	IPA(<音标偏好>)	Chinese	English Meaning	Example

YYYY-MM-DD — Translation Standard Expressions (Para B: [主题])

Expression	IPA(<音标偏好>)	Chinese	English Meaning	Example


- **IPA 按学员 `<音标偏好>` 输出**(英 → British IPA;美 → American IPA)
- **Example 必须中英双语**(格式 `English sentence.<br>中文翻译。`),英文优先用标准版本里的原句

---

### 方法 3 · Mini Presentation(MFO)

1. **AI 出题**(交替使用):
- 关联型:与当天听力 / 阅读内容延伸的讨论题
- 随机职场型:团队管理 / 沟通 / 决策 / 职业发展等开放题
- 难度:学员能在 1 分钟内构思框架
2. **学员 1 分钟构思 + 2 分钟英文演讲**
3. **AI 反馈 + 评分(1-5,必给,综合 Structure/Fluency/Vocabulary/Depth)**:

Impromptu Speaking Feedback — Score: X/5

Structure

[开头-论点-论据-总结是否完整]

Content Feedback

[观点深度、例子是否具体]

Language Corrections

#	你的表达	修正	说明

Delivery Notes

[流利度、停顿、重复对理解的影响]


评分维度说明:
- **Structure**:开头-论点-论据-总结是否完整
- **Fluency**:表达是否流畅,停顿 / 重复是否影响理解
- **Vocabulary**:用词是否精准、多样,是否有高级表达
- **Depth**:观点是否有深度,是否只停留在表面

4. **B/C 级:FD 加压**(若菜单标了):
> "用 1.5 分钟再讲一遍,挑同样的主线。"

⚠️ **评分必须附在反馈标题后,不能省略。**

---

### 方法 4 · 英→中视译 / 听写(LFL)

1. **学员自己找素材**(AI 没法直接生成听力片段,学员上 YouTube / TED 找;A/B 级重点做听写)
2. **听写四步法**(精听):
- 第 1 步:**盲听复述大意** — 整段听一遍,口头复述大意
- 第 2 步:**断句听写** — 每句不超过 4 遍,听到什么写什么
- 第 3 步:**重听核对** — 不看文字再听一遍,核对自己写的
- 第 4 步:**校对总结** — 对照 transcript 找错,归类:① 单词不认识 / ② 认识但没听出 / ③ 总是听不出
3. **学员把听写结果发给 AI** → AI 反馈错误类型(对应上面 ①②③)
4. **AI 整理词块入库**(5 列:`Expression | IPA(<音标偏好>) | Chinese | English Meaning | Example`)

---

### 方法 5 · 精读(LFL,翻译三步走)

1. **AI 临场生成一个英文复杂句**(按学员级别难度匹配,从 Section 1 场景延伸)
2. **学员做翻译三步走**:
- 第 1 步:**理解意思** → 翻成中文
- 第 2 步:**拆分成分** → 找主句、划分主谓宾、找从句
- 第 3 步:**切分意群 + 顺句驱动** → 按英文语序口头视译
3. **AI 反馈 + 教对应的语法点**(按 <综合CEFR> 级别:A 基础句 / B 从句 / C 复杂句)
4. **如有值得记的词块,5 列入库**(同上)

---

## 训练后(必做)

1. **词块积累**(Cross-cutting 总原则):
- **筛选门槛**:按 <词库门槛级别>+ 难度,**跳过基础词**(如 C1 学员不收 take / make / work 这种)
- **标准 5 列格式**:`Expression | IPA(<音标偏好>) | Chinese | English Meaning | Example`
- **IPA 必须按学员 `<音标偏好>` 输出**(英音 = 无 r 卷舌 + /ɒ/;美音 = 带 r + /ɑː/)
- **Example 必须中英双语**(格式 `English sentence.<br>中文翻译。`),低级别学员靠中文 scaffolding,不能省
- **写入** `~/.barry-english/fancy-vocab.md`,按 H3 日期 session 分组:
  ```
  ### <今日日期> — <今日训练主题概括>
  | Expression | IPA(<音标偏好>) | Chinese | English Meaning | Example |
  |---|---|---|---|---|
  | sample | /ˈsɑːmpl/ | 例子 | 含义说明 | We took a small sample.<br>我们取了一小份样品。 |
  ```

2. **训练日志**:追加到 `~/.barry-english/training-log.md`:

YYYY-MM-DD

时长:实际 X 分钟(计划 <每日时长> 分钟)
完成训练:<列出今天做的训练项 + 各自评分>
词块产出:N 个(已同步到 Fancy Vocab)
学员主观感受:<可选>
异常 / 触发信号:<可选>


3. **同步 Quiz 网页**:
- 启动:**双击桌面 `Barry-Quiz.command`(Mac)/ `Barry-Quiz.bat`(Windows)**
- 浏览器自动打开:`http://127.0.0.1:<实际端口>`(端口在 `~/.barry-english/.quiz-port`)
- 点 "🔄 更新题库" → 今天新词块进入 quiz 池
- 做 Daily Quiz(5 题 4 选 1)+ 复习本(SM-2 到期项)

4. **询问学员**:
- "今天训练感觉怎样?"(可选写入主观感受)
- "有没有异常?(发音特别卡 / 听力进步 / 卡点变了 / 工作场景变了 / 等)"
- **若学员说情况有变化**:
  主动建议:"听起来你的档案和现状有出入了。要不要**重新走一遍 onboarding**(`/barry-onboarding`)?"

## 失败模式

| 场景 | 应对 |
|---|---|
| `~/.barry-english/profile.md` 不存在 | 提示"档案丢了,先输入 `/barry-onboarding` 重建",本 Skill 退出 |
| 学员说"我累了不想训练" | 接受,可减时长或跳过当日;**仍要写训练日志注明"skipped: tired"**(留痕)|
| 学员说"我今天只有 X 分钟"(短于 Section 1 计划)| 按 X 分钟重新分配 MFI/MFO/LFL(各 X÷3),只做 1-2 项,其余跳过;日志注明 |
| 学员说情况变了 | 立即建议 `/barry-onboarding` 重跑;不强行继续训练 |
| 学员长时间没训练(超 7 天)| 不强提醒;启动时温和告知"上次训练是 N 天前,继续吗?"|
| 词库 / 训练日志 Markdown 写入失败 | 立即从 .bak 恢复,告知学员"写入失败,本次产出未入库;可截图手动保存"|
| Quiz Web 没启动 | 不阻拦训练;训练后提示"今天的词块已入库,启动 Quiz 时点'🔄 更新题库'即可同步"|

Generation Detail Constraints

Nickname-slug rule: convert to lowercase and remove spaces and special characters, such as “Mike Wang” → “mike-wang,” for use in the Skill name and path.
The training menu must select concrete methods according to the learner's CEFR level, rather than placing every method from the toolbox into the menu.
The specific coaching language for each training item must be copied directly from the corresponding toolbox section; do not use placeholders.

Completion Criteria

The completeness of Section 1+2+3 has been verified
Section 4 has been designed and approved through learner review
Profile Section 4 has been written successfully, including backup + verification
The learner has explicitly authorized installation

The personalized training Skill has been written to

<current AI Agent skills directory>/barry-daily-<nickname-slug>/SKILL.md

The
```
~/.barry-english/training-log.md
```
placeholder has been created
The
```
~/.barry-english/fancy-vocab.md
```
placeholder has been created
The Quiz code has been copied to
```
~/.barry-english/quiz-web/
```
and sanitization is complete
Startup instructions have been provided, including opening a new AI Agent session, the training Skill trigger words, and how to launch Quiz Web
The learner has been reminded to report any changes in circumstances

Internal Tracking Checklist (For the AI)

Step 1: Section 1+2+3 verification ✓ / termination if any section is missing ✓
Step 2: Profile summary and learner confirmation ✓ / all six Section 4 fields reviewed individually ✓ / final learner approval ✓
Step 3: Five-step profile-writing workflow completed (backup / full read / parsing / full-file overwrite / verification) ✓
Step 4A: Explicit learner consent to install ✓
Step 4B: All variables replaced ✓ / training menu selected according to the learner's level ✓ / no placeholders remaining ✓
Step 4C: Skill written + overwrite confirmation requested for repeated installations ✓
Step 4D: Quiz code sanitization complete (Feishu credentials removed ✓ / business sections removed ✓ / FANCY_VOCAB path changed to ~/.barry-english/ ✓)
Step 4E: Startup instructions complete (new-session prompt + training Skill trigger words + Quiz Web launch method) ✓
Step 5: All three topics covered (daily training / Q&A / changed circumstances) + reminder that no proactive reassessment pressure will be applied ✓

Failure-Mode Prevention

Risk	Response
Any of profile Section 1+2+3 is missing	Terminate immediately and direct the learner to run barry-profile / barry-assessment first; partial execution is not allowed
The learner refuses automatic installation in Step 4	Fallback: output the complete SKILL.md content and provide manual copy-path instructions. Continue writing Section 4 to the profile. Skip Quiz Web as well, which can be installed manually later
`<current AI Agent skills directory>/barry-daily-<nickname-slug>/` already exists from a previous installation	Ask “Overwrite the old version?” because the learner may be rerunning onboarding after a profile change. If the learner agrees, back up the old SKILL.md as `.bak.<timestamp>` before overwriting it
The learner says their current Agent cannot write local Skills but wants to see the plan	Still write Section 4 to the profile. In Step 4, output the SKILL.md content for manual copying and explain that it can be used after switching to an Agent that supports local Skills. Also provide the Quiz Web startup instructions, which depend only on Node.js
The learner rejects every item during the Section 4 design	Do not force the plan. Ask “What would you like to adjust?” and adapt based on feedback. If the learner has no idea, propose running the methodology's default configuration for one week and then adjust it
The Section 1 time is very short, such as five minutes	Allocate Section 4 across five minutes, with one to two minutes for each of MFI/MFO/LFL. The menu must contain only one or two items. Explain that five minutes provides limited training value and recommend increasing the duration to 30+ minutes when possible
The profile CEFR is A1 or close to A1	Simplify the Section 4 training menu: focus on LFL, including basic chunks and simple-sentence translation. Use the simplest content for MFI/MFO, such as VOA Special English or simple generated sentences. Do not use Mini-Pre or complex sight translation
The profile CEFR is C1+ / C2	The LFL share may be reduced because the learner already has a strong foundation. Focus on MFO with dense output and 4-3-2 pressure drills, and use high-difficulty content for MFI
The dashboard source code is not in an expected location	Explain that Quiz Web cannot be copied automatically and that the Quiz code must be manually extracted from the Barry dashboard. Provide the extraction scope specified in 4D
The learner asks “What is an intonation unit / MCES / sight translation?”	Do not introduce methodology terminology proactively. If asked, explain it in plain language and suggest entering `/barry-coach` for details, as that Skill is ready
The AI lacks permission to write to the current AI Agent's skills directory	Explain that automatic installation may have failed because of a permissions issue and provide the complete SKILL.md content for manual copying

barry-solution

NPX Install

Tags

SKILL.md Content (Chinese)

Barry Learner Profile · Section 4 (Solution) + Automatic Generation of a Personalized Daily Training Skill

Trigger Scenarios

Target Outputs

Write or Update File 1: Learner Profile Section 4

Output File 2: Personalized Daily Training Skill

Output File 3: Training Log (empty placeholder)

Output Folder 4: Quiz Web Code (local vocabulary-bank quiz)

Design Principles (Must Be Followed Throughout)

Prerequisites (Hard Constraints)

Assessment Workflow (5 Steps, 10–15 min)

Step 1 · Profile Integrity Check (1 min)

Step 2 · Profile Review + Section 4 Design (5–8 min)

2A · Briefly Summarize the Profile for Learner Confirmation

2B · Design the Section 4 Fields According to the Toolbox

2C · Final Learner Review

Step 3 · Write Profile Section 4 (1 min)

Step 4 · Generate + Automatically Install the Personalized Training Skill (3–5 min)

4A · Obtain Learner Authorization (Required)

4B · Generate the Personalized Training Skill Content

4C · Automatically Install into the Current AI Agent Skills Directory

4D · Copy the Dashboard Quiz Code to ~/.barry-english/quiz-web/ + Generate a Desktop Shortcut

Step 1: Detect Node.js + Obtain Installation Authorization if Missing

Step 2: Copy the quiz-web Resources to the Learner's Home Directory

Step 3: Generate the Desktop Shortcut (Mac / Windows)

Mac → Desktop Barry-Quiz.command

Windows → Desktop Barry-Quiz.bat

Step 4: Write Empty Training Support Files

4E · Startup Instructions

⭐ Preview of the First Day of Training Tomorrow

Level A Learner (A1/A2) Sample

Level B Learner (B1/B2) Sample

Level C Learner (C1+) Sample

Rules for Actual Generation

⭐ Level A Retell Recommended-Source List (Material Library for the Daily Skill)

Step 5 · Wrap-Up + Learner Guidance (1 min)

Section 4 Field-Filling Rules (Based on [[Four-Strands-训练方法工具箱]])

Training Objective

Training Prerequisites

Four Strands Allocation

Daily Training Menu

MFI (Meaning-Focused Input) — Total Time ÷ 3

MFO (Meaning-Focused Output) — Total Time ÷ 3

LFL (Language-Focused Learning) — Total Time ÷ 3

Training Material Types + Recommended Sources

Stage Milestones

Personalized Training Skill Generation Specification

File Structure

Complete SKILL.md Template

Retelling Feedback — Score: X/5

行文逻辑可视化(必含)

评分维度(综合打分)

整理本次值得记的词块(按 <词库门槛级别>+ 难度筛,跳过基础词)

Paragraph A — [主题]: X/5

📋 候选列表 — 标准版本中的地道表达

From Paragraph A ([主题])

From Paragraph B ([主题])

YYYY-MM-DD — Translation Standard Expressions (Para A: [主题])

YYYY-MM-DD — Translation Standard Expressions (Para B: [主题])

Impromptu Speaking Feedback — Score: X/5

Structure

Content Feedback

Language Corrections

Delivery Notes

YYYY-MM-DD

Generation Detail Constraints

Completion Criteria

Internal Tracking Checklist (For the AI)

Failure-Mode Prevention

4D · Copy the Dashboard Quiz Code to
`~/.barry-english/quiz-web/`
+ Generate a Desktop Shortcut

Mac → Desktop
`Barry-Quiz.command`

Windows → Desktop
`Barry-Quiz.bat`