# Skill: generate-age-weekly-plans

> 生成分龄页各年龄段的「4 周推荐学习路线」，更新 `age.config.ts` 中的 `AGE_WEEK_PLANS`。

## 触发条件

当用户提到以下内容时触发：
- "生成学习路线"、"更新学习路线"、"更新周计划"、"generate weekly plans"
- "更新分龄页第三部分"、"更新分龄路线"

## 任务描述

你是一位拥有 15 年经验的儿童早教专家，专注于 3-8 岁儿童的系统化学习规划。你需要基于当前系统中已上线的所有 worksheet（打印练习册），为 5 个年龄段设计科学的 4 周学习路线，确保每周推荐的练习都是系统中实际存在的 worksheet。

## 执行步骤

### Step 1：获取 worksheet 数据

`page-config.json` 存储在微信云存储中（路径：`/content/page-config.json`），本地项目中不存在此文件。按以下优先级获取数据：

**方式一：读取本地缓存（优先）**

1. 使用 Glob 搜索 `.cache/page-config.json` 是否存在
2. 如果存在，读取 `category.categories` 数组，提取每个分类下的 `items[]`
3. 从每个 item 中提取关键信息（与 `pageContentBuild` 下发的 `category.items[]` 一致）：
   - `id`（云 worksheet `_id`，写入配置时作为 `_id` 字段）
   - `title`、`subtitle`、`path`
   - 可选辅助：`ageMin` / `ageMax`、`category`、`difficulty`、`downloads`、`likes`

**方式二：通过微信开发者工具下载**

如果本地缓存不存在，提示用户按以下步骤获取：

1. 打开微信开发者工具
2. 进入「云开发控制台」→「存储」
3. 找到 `/content/page-config.json` 文件，点击下载
4. 将文件保存到项目根目录的 `.cache/page-config.json`

```bash
# 确保 .cache 目录存在
mkdir -p .cache
# 用户手动将下载的文件放入：.cache/page-config.json
```

**方式三：通过云函数调用获取**

如果用户已安装 `tcb` CLI（腾讯云开发 CLI），可以直接下载：

```bash
mkdir -p .cache
tcb storage:download /content/page-config.json .cache/page-config.json
```

> **重要**：请在获取数据后告知用户文件中有多少个 worksheet，以及覆盖了哪些分类和年龄段，让用户确认数据是最新的。

### Step 2：按年龄段分组和分析

1. 将所有 worksheet 按年龄段（`ageBand`）分组
2. 在每个年龄段内，按分类统计 worksheet 数量
3. 记录每个 worksheet 的难度等级（`difficulty`）
4. 按 `downloads + likes` 排序，优先选择受欢迎的 worksheet

当前系统的分类体系：
- `math` - 数感启蒙
- `puzzle` - 益智游戏
- `pinyin` - 汉语拼音
- `chinese` - 趣味识字
- `english` - 英语启蒙
- `craft` - 创意手工

年龄段定义（来自 `core/data/difficulty.ts`）：
- `3-4`：3-4 岁
- `4-5`：4-5 岁
- `5-6`：5-6 岁
- `6-7`：6-7 岁
- `7-8`：7-8 岁

### Step 3：设计 4 周学习路线

以早教专家视角，为每个年龄段设计 4 周学习计划。

**编排原则：**

1. **由易到难**：第 1 周以基础入门为主，逐周提升难度
2. **跨领域覆盖**：4 周合计应覆盖该年龄段可用的多个学科分类，避免单一
3. **主题连贯**：每周设定一个明确的学习主题（如"数感启蒙""形状与空间""趣味文字"等）
4. **基于实际内容**：每个练习必须对应系统中实际存在的 worksheet，**必须**带上真实的 `_id`、`subtitle`、`path`（与数据源一致，禁止手写虚构 path）
5. **合理搭配**：每周 3 个练习应尽量来自不同分类，提供多元学习体验
6. **第 4 周综合**：最后一周安排综合练习，涵盖前 3 周的核心技能

**主题命名规范：**
- 简洁明了，4-6 个汉字
- 体现该周的学习重点
- 示例：数感启蒙、形状与连线、趣味专注、综合练习、拼音入门、创意手工

**当 worksheet 不足时的处理：**
- 如果某个年龄段的 worksheet 不足 12 个（4 周 × 3 个），允许同一 worksheet 在不同周出现
- 如果某个年龄段完全没有 worksheet，使用相邻年龄段的内容并标注
- 若某年龄段可用 worksheet 不足，可放宽年龄筛选，但每条仍须来自数据源中的真实 `id/title/subtitle/path`，**不要**编造 `_id` 或 path

### Step 4：更新 age.config.ts

1. 读取 `miniprogram/pages/age/age.config.ts` 文件
2. 找到 `AGE_WEEK_PLANS` 常量（如果不存在则在现有代码中 `MOCK_WEEKS` 的位置创建）
3. 替换为新生成的数据

**`WeekExercise` 输出结构（写入 `age.config.ts`，与小程序分龄页跳转一致）：**

```ts
export type WeekExercise = {
    _id: string;      // 等于数据源 item.id（即云 worksheets._id）
    title: string;   // item.title
    subtitle: string; // item.subtitle
    path: string;    // item.path，可含 query；点击「去练习」将按 path 跳转
};
```

**`AGE_WEEK_PLANS` 示例片段：**

```ts
export const AGE_WEEK_PLANS: Record<AgeBandKey, WeekPlan[]> = {
    '3-4': [
        {
            week: 1,
            theme: '数感启蒙',
            exercises: [
                {
                    _id: 'xxxxxxxx',
                    title: '找数字，涂一涂',
                    subtitle: '在数字方阵中找出目标数字并涂色',
                    path: '/mathPages/mathDraw/mathDraw?id=number-find',
                },
                // ...
            ],
        },
        // week 2–4
    ],
    // '4-5' … '7-8'
};
```

**数据规范：**
- 每个年龄段必须有 4 个 `WeekPlan`
- 每个 `WeekPlan` 必须有 3 个 `exercises`
- 每个 `exercises[]` 元素必须四字段齐全：`_id`、`title`、`subtitle`、`path`
- `_id` 与 `path` 必须与 `.cache/page-config.json`（或云函数拉取结果）中对应 worksheet **逐字一致**
- `theme` 简洁描述本周学习主题
- 列表 `wx:key` 使用 `_id`，避免同 title 重复导致渲染异常

### Step 5：验证

1. **结构完整性**：5 个年龄段 × 4 周 × 3 练习 = 60 个练习项
2. **内容真实性**：抽查每条 `_id`、`path`、`subtitle` 是否与数据源一致（可复制粘贴比对）
3. **递进合理性**：确认每个年龄段的内容难度符合该年龄段认知水平
4. **跨周不重复**：尽量避免同一 worksheet 在同一年龄段的不同周重复出现
5. **主题覆盖度**：检查 4 周主题是否覆盖了该年龄段的主要学科
6. **类型匹配**：确认数据结构与 `WeekPlan` 和 `WeekExercise` 类型定义一致

## 相关文件

- `miniprogram/pages/age/age.config.ts` — 输出目标文件
- `miniprogram/pages/age/age.ts` — 分龄页逻辑（引用 config）
- `miniprogram/core/data/difficulty.ts` — AGE_BANDS 定义
- `miniprogram/core/data/categories.ts` — CATEGORY_LIST 分类定义
- `.cache/page-config.json` — worksheet 数据本地缓存（从云存储下载）
- 云存储 `/content/page-config.json` — worksheet 数据源（Source of Truth）
- `cloudfunctions/worksheetsQuery/` — 查询 worksheet 的云函数（备选数据源）
- `docs/分龄页内容管理方案.md` — 方案文档