Imported from butterandfly/wordcraft (.agents/skills/wordcraft-sentence-mill-authoring/SKILL.md). Install upstream with npx skills add butterandfly/wordcraft --skill wordcraft-sentence-mill-authoring. Copyright stays with the author.

WordCraft「句子磨坊」关卡创作标准流水线 (Sentence Mill Authoring Skill)

本 Skill 规范了在 WordCraft 句子磨坊模块 (module-duo-sentence-mill) 中，构思并创作全新闯关单元（Unit）与关卡节点（Node）的完整 SOP。所有设计严格遵循针对 4-6 年级阿斯伯格（ASD Level 1）儿童 的认知特征、双区域推进原则与极简零噪音准则。

🏷️ 灵活 Tag 标签系统架构解析 (Tags Architecture)

在 WordCraft 架构中，所有 DuoNode 统一采用轻量且极具扩展性的 tags?: string[] 标签体系，而非硬编码固定的枚举属性。这确保了不同工坊与模块的自由度。

在「句子磨坊」中，Tag 体系形成了一个正交的二维教学矩阵：

1. 维度一：教学目标 (Pedagogy Target - 做什么)

'骨架构建'：
- 核心目标：从 0 到 1 识别与提炼画面核心骨架（核心主角 + 所在地点 + 所做动作），建立最简完整句子的意识。
- 对应卡片：主角卡 $\to$ 地点卡 $\to$ 动作卡 $\to$ 最简骨干拼装/书写卡。
'添加修饰'：
- 核心目标：在稳固骨架的基础上，通过多维度视角观察，为骨干添加生动的定语、状语与细节修饰，实现从“骨干句”向“文学长句”的蜕变。
- 对应卡片：温故知新卡 $\to$ 主角修饰分支 $\to$ 地点修饰分支 $\to$ 动作修饰分支 $\to$ 6 语块生动长句拼装/综合书写卡。

2. 维度二：交互模式与认知阶梯 (Interaction Mode - 怎么做)

'选择' (Level 1 认知支架模式)：
- 特点：提供精准干扰项辨析与 3D 积木拖拽拼装，适合初学与支架建立；
- 手感要求：1:1 跟手，开启 dragSnapToOrigin={false} 受控物理回弹。
'输入' (Level 2 开放自主书写模式)：
- 特点：纯中立引导占位符（绝对零剧透），由学生自主观察并书写提炼词汇，后续卡片动态绑定学生提炼的词汇，并在练习本上拍照归档。

3. 四大黄金基本组合：

tags: ['骨架构建', '选择']（如：符文遗迹探索 1、深海潜水探索 1）
tags: ['骨架构建', '输入']（如：火星红岩采样 1、热气球云海穿越 1）
tags: ['添加修饰', '选择']（如：符文遗迹探索 2、深海潜水探索 2）
tags: ['添加修饰', '输入']（如：火星红岩采样 2、热气球云海穿越 2）

🎯 核心特教与交互准则 (Pedagogical & UI Core Rules)

宏观教学阶梯闭环（Sequential Ladder）⭐：
- 同一个主题循环内，关卡顺序必须严格按照： [骨架构建, 选择] $\to$ [骨架构建, 输入] $\to$ [添加修饰, 选择] $\to$ [添加修饰, 输入] $\to$ [阶段宝箱] 推进。
- 先打牢骨架，再进阶修饰；先选择建立支架，再开放自主书写！
零剧透中立引导原则（Zero Spoiler Principle）⭐：
- 严禁在输入框的 placeholder、引导提示或题干中出现 （如：...） 或 例如：... 等示范答案，防止提前泄题或剥夺 ASD 儿童自主观察思考。
- 必须使用纯中立占位符（如：输入画面中的核心主角...、输入所在地点...、输入所做动作...、在此输入生动修饰词...、在此写出完整的生动长句...）。
学生词汇动态驱动（Student-Vocabulary Driven）：
- 在输入模式中，后续修饰卡片的顶部锚点（bone_text）必须动态读取学生在前面自主输入的骨干词汇（userExtractedElements），并在终局卡片中完整展示学生自己提炼的所有要素。
两步分支观察系统（Two-Stage Branching System）：
- 第一步：学生自选感兴趣的观察视角（如：🎒 随身道具 / 👕 服饰外貌 / ✨ 眼神神态）；
- 第二步：在选定视角下提供精准辨析或开放书写，并支持随时“换个视角”重选。
零泄密统一分色（Color-Blind Proofing）：
- 语块池与槽位中，所有修饰词统一为相同外观，所有骨干词统一外观，严禁通过前置颜色剧透答案。
1:1 跟手与受控回弹（Zero-Lag Controlled Drag）：
- Framer Motion 拖拽层严禁 transition-all，开启 dragElastic={0} 和 dragMomentum={false}；
- 设 dragSnapToOrigin={false}，仅在未命中放空时触发受控 spring 回弹，入槽瞬间 0 毫秒闪烁。
语块选项必须充分打乱（Shuffle Options & Block Banks）⭐：
- 严禁将目标句子的正确语块按顺序排在待选词池（block_bank / character_bank）的最前面。
- 待选词池必须交叉、随机或逆序打乱，迫使学生真正阅读每一个词块并进行逻辑重组，杜绝从左到右顺次点击直接过关。
UI 与题目信息严禁臃肿重复（Anti-Redundancy Principle）⭐：
- 题干直击问题核心（如 【语块排序】按时空轨道组装通顺长句：），严禁在题干中罗列括号内的子步骤。
- 看板图解/时空轨道自解释，严禁在看板底部或右上角用文本唠叨重复同一套规则。
单元与节点命名极简原则（Minimalist Naming）⭐：
- 单元名严禁出现 （纯文字构建） 等多余模式化说明，简介保持精炼。
- Node 标题严禁臃肿堆砌，严禁在末尾附加 1、2、3 等序号（如统一命名为 骨干提炼、时空轨道、自主扩写、作家手稿宝箱）。
纯文字单元专属奖励：【典藏作家手稿笺】（Artisan Manuscript Sheet）⭐：
- 纯文字思维构建单元的阶段宝箱奖励为【典藏作家手稿笺】（type: 'manuscript'）；
- 长句本位：纯粹聚焦于完整通顺的文学长句本身，杜绝繁琐小标签、色块堆砌或做题式拆解；
- 视觉呈现：复古米黄/羊皮纸笺底色、古典金铜细线内框与四角花饰（✦）、衬线大字长句优雅排版、朱砂红篆刻印章（如 [ 作家手稿 ]）与精简札记赏析。

🗺️ 四大关卡标准原型配置 (4 Node Golden Archetypes)

原型 1：【骨架构建 · 选择】(Level 1 Choice Backbone)

标签：tags: ['骨架构建', '选择']
标准 4 卡结构：
1. visual_choice_card：视觉选择主角（3 选 1，带精准辨析解析）
2. visual_choice_card：视觉选择地点（3 选 1）
3. visual_choice_card：视觉选择动作（3 选 1）
4. block_slot_card：3 槽位骨干拼装（[主角] [地点] [动作] + 干扰项）

原型 2：【添加修饰 · 选择】(Level 1 Choice Modifiers & Assembled)

标签：tags: ['添加修饰', '选择']
标准 5 卡结构：
1. block_slot_card：【温故知新】骨干回顾拼装（巩固最简骨干句）
2. branch_choice_card：主角修饰分支（提供 3 个观察维度，如道具/服饰/神态，2选1）
3. branch_choice_card：地点修饰分支（提供 3 个环境维度，如植被/光影/年代，2选1）
4. branch_choice_card：动作修饰分支（提供 3 个动作维度，如专注/姿态/心理，2选1）
5. block_slot_card (is_dynamic_branch_assembled: true)：
  - 根据学生前面 3 题自选的修饰词，动态生成 6 槽位目标与词库；
  - 拼装完成后触发【原骨干 $\to$ 专属生动长句】进化蜕变卷轴与语音朗读。

原型 3：【骨架构建 · 输入】(Level 2 Input Backbone)

标签：tags: ['骨架构建', '输入']
标准 4 卡结构：
1. input_card (is_open_input: true)：看图书写主角（纯中立 placeholder）
2. input_card (is_open_input: true)：看图书写地点
3. input_card (is_open_input: true)：看图书写动作
4. picture_input_card：看图综合写成骨干句 + 练习本纸笔工整书写拍照

原型 4：【添加修饰 · 输入】(Level 2 Input Modifiers & Expansion)

标签：tags: ['添加修饰', '输入']
标准 5 卡结构：
1. multi_input_card：【温故知新】骨干三要素分别输入（👤 主角、📍 地点、⚡ 动作 一屏收录）
2. branch_choice_card (is_open_input: true)：主角修饰分支输入（顶部原骨干动态显示为学生输入的主角）
3. branch_choice_card (is_open_input: true)：地点修饰分支输入（顶部原骨干动态显示为学生输入的地点）
4. branch_choice_card (is_open_input: true)：动作修饰分支输入（顶部原骨干动态显示为学生输入的动作）
5. picture_input_card：
  - 顶部工整汇总展示 3 个骨干要素（青色标签） 与 3 个生动修饰（暖金标签）；
  - 学生看着全部自提语块积木，连贯自主写出生动长句 + 纸笔拍照。

🌟 官方黄金标准范本：第一单元「奇境探险篇」 (Golden Reference Benchmark)

设计任何新单元时，必须 1:1 对标第一单元的数据结构、标签配置与两阶段循环：

// 示例：第一单元「奇境探险篇」标准结构
{
  id: 'unit-mill-1',
  title: '第一单元：奇境探险篇',
  description: '从神秘遗迹到火星红岩、深海与云海，探索不同奇境的画面骨干与生动修饰。',
  themeColor: '#0D9488',
  nodes: [
    // === 循环一：陆地与地质探险篇 ===
    // Node 1: 符文遗迹探索 1 -> tags: ['骨架构建', '选择']
    {
      id: 'node-mill-ruin',
      title: '符文遗迹探索 1',
      subtitle: 'Level 1 基础骨干提炼与组装',
      tags: ['骨架构建', '选择'],
      cards: [ /* 视觉选主角 -> 选地点 -> 选动作 -> 3槽位拼装 */ ]
    },
    // Node 2: 火星红岩采样 1 -> tags: ['骨架构建', '输入']
    {
      id: 'node-mill-mars',
      title: '火星红岩采样 1',
      subtitle: 'Level 2 骨干提炼与自主成句',
      tags: ['骨架构建', '输入'],
      cards: [ /* 输入主角 -> 输入地点 -> 输入动作 -> 综合骨干句输入+纸笔 */ ]
    },
    // Node 3: 符文遗迹探索 2 -> tags: ['添加修饰', '选择']
    {
      id: 'node-mill-ruin-2',
      title: '符文遗迹探索 2',
      subtitle: 'Level 1 分支视角与生动拼装',
      tags: ['添加修饰', '选择'],
      cards: [ /* 温故知新拼装 -> 主角分支 -> 地点分支 -> 动作分支 -> 6槽位动态拼装 */ ]
    },
    // Node 4: 火星红岩采样 2 -> tags: ['添加修饰', '输入']
    {
      id: 'node-mill-mars-2',
      title: '火星红岩采样 2',
      subtitle: 'Level 2 分支视角与生动长句书写',
      tags: ['添加修饰', '输入'],
      cards: [ /* 骨干3要素输入 -> 3维度分支自主输入 -> 综合生动长句输入+纸笔 */ ]
    },
    // Node 5: 阶段宝箱 1 (No.001 探险家的晨曦)
    {
      id: 'node-mill-chest-1',
      title: '探索之眼',
      type: 'chest',
      reward: {
        type: 'gem_and_card',
        gems: 50,
        cardReward: {
          type: 'card',
          cardNumber: 'No.001',
          title: '探险家的晨曦',
          image: '/scenarios/ruin.jpg',
          quote: '清晨的金光穿透石拱门，探险家手提晶石提灯，在古老遗迹里辨认着石碑上的神秘符文。'
        }
      },
      cards: []
    },

    // === 循环二：深海与高空探险篇 ===
    // Node 6: 深海潜水探索 1 -> tags: ['骨架构建', '选择']
    // Node 7: 热气球云海穿越 1 -> tags: ['骨架构建', '输入']
    // Node 8: 深海潜水探索 2 -> tags: ['添加修饰', '选择']
    // Node 9: 热气球云海穿越 2 -> tags: ['添加修饰', '输入']
    // Node 10: 阶段宝箱 2 (No.002 云海上的领航员)
  ]
}

🎨 视觉资产生成规范 (Visual Art Pipeline)

尺寸比例：严格为 16:9；
美术风格：水彩墨线童话绘本风（Ink & Watercolor Storybook）或新海诚/吉卜力温暖风；
存放路径：/public/scenarios/[主题名].jpg（如 ruin.jpg、mars.jpg、submarine.jpg、hotair_balloon.jpg）；

Prompt 模板：

An enchanting 16:9 storybook watercolor illustration with clean ink line art, picturesque [核心场景描述，如 a whimsical vintage hot-air balloon drifting through golden sunset clouds and rainbow skies, a young cheerful pilot at the helm], warm magical golden atmospheric lighting, classic European children's book aesthetic, delicate watercolor textures, serene and uplifting, high aesthetic quality, no text

💻 全自动装配与代码路径

主数据文件：/src/data/sentenceMillData.ts
核心组件目录：/src/components/duo/cards/
- DuoVisualChoiceCardView.tsx（视觉三选一）
- DuoBranchChoiceCardView.tsx（两步视角分支，支持选择与输入模式）
- DuoBlockSlotCardView.tsx（受控回弹 3D 积木拖拽拼装）
- DuoInputCardView.tsx（单项要素自主书写）
- DuoMultiInputCardView.tsx（三要素一屏分别输入）
- DuoPictureInputCardView.tsx（综合成句书写 + 骨干/修饰双色汇总 + 纸笔拍照）

wordcraft-sentence-mill-authoring

About