@aiyiran/myclaw 1.1.24 → 1.1.26

package/skills/yiran-course-template-pipeline/prompts//351/230/266/346/256/2653-teacher/347/224/237/346/210/220.md

@@ -0,0 +1,131 @@
+# 阶段3：生成 __teacher__.json
+
+用途：
+在 __student__.json 已经明确之后，再整理教师侧的题目设计目的与教学判断信息。
+
+这个阶段的目标不是生成学生页内容，
+而是：
+**把这个题目为什么这样设计、主要解决什么问题、老师上课时该怎么看，整理成 __teacher__.json。**
+
+---
+
+## 本阶段输出对象
+
+必须输出：`__teacher__.json`
+
+结构如下：
+
+```json
+{
+  "任务类别": "",
+  "任务编号": "",
+  "任务名称": "",
+  "主能力标签": "",
+  "任务类型标签": "",
+  "适合学生类型": [],
+  "训练重点": [],
+  "卡点和解决方案": [
+    {
+      "卡点": "",
+      "解决方案": ""
+    }
+  ],
+  "可拓展方向": [],
+  "课后作业": []
+}
+```
+
+参考：
+- `references/teacher-fields.md`
+- `references/teacher-scaffold.json`
+
+---
+
+## 这个阶段真正要解决什么
+
+不是再去重写学生步骤。
+不是再去写一星二星三星。
+不是再去讨论页面布局。
+
+而是要明确：
+- 这个题主要练什么
+- 这个题属于什么任务类型
+- 更适合哪类学生
+- 训练重点是什么
+- 学生会卡在哪里
+- 老师应该怎么引导
+- 还能怎么拓展
+- 课后作业怎么布置
+
+---
+
+## 字段逐项对应
+
+### 1）任务类别
+只能填写：A、B、C。
+
+- A = 启动类：让学生动起来，适合弱学生、卡住学生
+- B = 结构类：开始搭东西，适合中间学生
+- C = 迭代类：重点训练改，适合会做但不会改的人
+
+注意：ABC 不是按难度分，而是按任务在学习过程中的作用分。
+
+### 2）任务编号
+用于编号和自动命名。
+
+要求：
+- 固定三位字符串
+- 范围固定为 `100 ~ 999`
+- 每个类别单独编号，并且按顺序往后排
+- A 类从 `100` 开始，B 类从 `100` 开始，C 类也从 `100` 开始
+- 同一类别新增模板时，按 `100、101、102 ...` 这样继续往后加
+
+### 3）任务名称
+任务显示名称，应和 __student__.json 的任务标题保持一致或高度一致。
+
+### 4）主能力标签
+这是最核心的教学能力标签，只能选一个。
+
+固定集合：
+- 构思能力
+- 表达构建
+- 问题判断
+- 迭代推进
+
+它回答的是：这个任务主要训练什么能力。
+
+### 5）任务类型标签
+说明作品本身属于什么类型，也只能选一个。
+
+固定集合：
+- 游戏机制
+- 角色交互
+- 视听表达
+- 改编优化
+
+它回答的是：这个任务最终属于什么作品类型。
+
+### 6）适合学生类型
+这里写的是更适合哪类学生，而不是课堂分组名称。
+
+### 7）训练重点
+这里要写的是教学训练重点，不是页面功能列表。
+
+### 8）卡点和解决方案
+这里最重要的是老师上课时能不能直接拿来判断和引导。
+
+### 9）可拓展方向
+写这个题还能怎么继续扩展。
+
+### 10）课后作业
+写课后还能布置什么延伸练习。
+
+---
+
+## 输出要求
+
+- 只输出 __teacher__.json
+- 不输出解释文字
+- 不补充 markdown 说明
+- 不输出 HTML
+- 字段名称必须保持中文

package/skills/yiran-course-template-pipeline/prompts//351/230/266/346/256/2654-/346/211/223/345/214/205/350/220/275/347/233/230.md

@@ -0,0 +1,77 @@
+# 阶段4：打包落盘提示词
+
+用途：
+指导 agent 在已有 `__demo__.html`、`__student__.json`、`__teacher__.json` 的前提下，先生成页面，再移动文件夹。
+
+注意：
+第4阶段现在拆成两个独立脚本，不再混在一个脚本里。
+
+---
+
+## 输入前提
+
+阶段一到阶段三的产物，应该先放在：
+**当前工作目录下新建的 `任务名称/` 文件夹里。**
+
+这个任务文件夹里至少应有：
+- `__demo__.html`
+- `__student__.json`
+- `__teacher__.json`
+
+---
+
+## 脚本1：build_template_views.py
+
+目标：
+只要字段校验通过，就在传入的文件夹里直接生成：
+- `__student-view__.html`
+- `__teacher-view__.html`
+- `index.html`
+
+其中 `index.html` 使用固定脚本规则：
+- 左边展示“评价目标”
+- 右边展示“步骤”
+- 不显示任务标题
+- 不显示一句话说明
+- 这部分不再靠临时 prompt 自由发挥，而是固定走脚本渲染
+
+调用方式：
+```bash
+python3 scripts/build_template_views.py 任务文件夹
+```
+
+适用场景：
+- 还在当前工作目录里调试
+- 想先看页面渲染结果
+- 还没准备正式入库
+
+---
+
+## 脚本2：move_template_task.py
+
+目标：
+在页面已经生成好的前提下，把整个文件夹直接移动到：
+skill 目录下的 `templates/`
+
+同时按规则改名，例如：
+`a100_给依然老师设计一个AI画像`
+
+调用方式：
+```bash
+python3 scripts/move_template_task.py 任务文件夹
+```
+
+适用场景：
+- 已经确认内容没问题
+- 已经有 `__student-view__.html` 和 `__teacher-view__.html`
+- 准备正式落库
+
+---
+
+## 原则
+
+1. 先在当前工作目录完成中间产物
+2. 先 build，再 move
+3. build 只在原目录生成页面，不移动
+4. move 只负责移动和改名，并自动触发索引构建
+5. 文件命名固定，不临时改名

package/skills/yiran-course-template-pipeline/references/student-example.json

@@ -0,0 +1,38 @@
+{
+  "任务标题": "给依然老师设计一个AI画像",
+  "一句话说明": "先让 AI 生成一个老师形象，再用网页把它展示出来，重点练习描述和小修改。",
+  "步骤": [
+    {
+      "标题": "先做图片",
+      "说明": "先用 AI 做出一张依然老师的图片。"
+    },
+    {
+      "标题": "放进网页",
+      "说明": "把图片放进网页里，再加上标题和一句介绍。"
+    },
+    {
+      "标题": "小改一下",
+      "说明": "试着小改一次图片，让它变得更好看一点。"
+    },
+    {
+      "标题": "展示变化",
+      "说明": "把几张图片一起放进网页里，展示你的修改过程。"
+    }
+  ],
+  "评价目标": [
+    {
+      "等级": "一星",
+      "说明": "完成一张老师图片。"
+    },
+    {
+      "等级": "二星",
+      "说明": "把图片放进网页里，并完成发布。"
+    },
+    {
+      "等级": "三星",
+      "说明": "把图片再改好一点，再把几张图片一起放进网页里。"
+    }
+  ],
+  "示例区标题": "示范样例",
+  "示例页面文件": "example.html"
+}

package/skills/yiran-course-template-pipeline/references/student-fields.md

@@ -0,0 +1,195 @@
+# 学生侧字段说明
+
+这份文档用于定义学生页面要使用的数据字段。
+
+目标是：
+- 把学生页真正需要的内容从 HTML 里抽离出来
+- 让模板和数据分开
+- 为后续 `__student__.json -> html` 脚本做准备
+
+当前默认模板文件位置：
+`skills/course-template-pipeline/assets/student-template.html`
+
+---
+
+# 一、当前 __student__.json 结构
+
+```json
+{
+  "任务标题": "",
+  "一句话说明": "",
+  "步骤": [
+    {
+      "标题": "",
+      "说明": ""
+    }
+  ],
+  "评价目标": [
+    {
+      "等级": "",
+      "说明": ""
+    }
+  ],
+  "示例区标题": "",
+  "示例页面文件": ""
+}
+```
+
+---
+
+# 二、字段逐个说明
+
+## 1）任务标题
+
+```json
+"任务标题": ""
+```
+
+### 作用
+显示在学生页最上方，是学生最先看到的任务名称。
+
+### 设定原则
+- 要短
+- 要清楚
+- 一眼能知道要做什么
+
+例子：
+- 给依然老师设计一个AI画像
+- 我自己的三国杀卡牌游戏
+
+---
+
+## 2）一句话说明
+
+```json
+"一句话说明": ""
+```
+
+### 作用
+用一句话告诉学生：
+- 先做什么
+- 再做什么
+- 重点练什么
+
+### 设定原则
+- 只写一句
+- 不要太长
+- 用学生能看懂的话
+
+例子：
+- 先让 AI 生成一个老师形象，再用网页把它展示出来，重点练习描述和小修改。
+
+---
+
+## 3）步骤
+
+```json
+"步骤": [
+  {
+    "标题": "",
+    "说明": ""
+  }
+]
+```
+
+### 作用
+给学生一个清楚的完成路径。
+
+### 设定原则
+- 一般 3 到 4 步
+- 每一步分成两层：
+  - 标题：短
+  - 说明：学生真正要读的句子
+
+### 标题怎么写
+推荐短词：
+- 先做图片
+- 放进网页
+- 小改一下
+- 展示变化
+
+### 说明怎么写
+- 用短句
+- 直接说要做什么
+- 不要讲太多理由
+
+---
+
+## 4）评价目标
+
+```json
+"评价目标": [
+  {
+    "等级": "",
+    "说明": ""
+  }
+]
+```
+
+### 作用
+告诉学生做到什么程度算完成、做到更好是什么样。
+
+### 设定原则
+- 默认固定三档：
+  - 一星
+  - 二星
+  - 三星
+- 每一档都要有一句清楚说明
+
+### 说明怎么写
+- 一星：基础完成
+- 二星：完成页面
+- 三星：有改进、有变化展示
+
+---
+
+## 5）示例区标题
+
+```json
+"示例区标题": ""
+```
+
+### 作用
+控制中间示例区标题文字。
+
+### 默认建议
+一般可直接写：
+```json
+"示例区标题": "示范样例"
+```
+
+---
+
+## 6）示例页面文件
+
+```json
+"示例页面文件": ""
+```
+
+### 作用
+告诉学生页中间 iframe 应该加载哪个页面文件。
+
+### 设定原则
+- 使用同级文件名
+- 不直接写复杂路径
+
+例如：
+```json
+"示例页面文件": "example.html"
+```
+
+---
+
+# 三、设计原则
+
+## 1）学生页字段只服务学生阅读
+不要把老师看的结构化字段放进 __student__.json。
+
+## 2）模板负责布局，__student__.json 负责内容
+布局固定在模板里，__student__.json 只管填什么。
+
+## 3）句子要短
+学生页比教师页更需要控制字数。
+
+## 4）数据和页面分开
+以后改模板时，不应该被 __student__.json 限制；以后换任务时，也不应该去手改 HTML 文案。

package/skills/yiran-course-template-pipeline/references/student-scaffold.json

@@ -0,0 +1,34 @@
+{
+  "任务标题": "请填写一个短、清楚、学生一眼能看懂的任务标题",
+  "一句话说明": "请用一句话说明：先做什么，再做什么，重点练什么",
+  "步骤": [
+    {
+      "标题": "请填写一个短的步骤标题，例如：先做图片",
+      "说明": "请填写学生真正要读的说明，要求短句、直接、可执行"
+    },
+    {
+      "标题": "请填写第二个步骤标题",
+      "说明": "请填写第二个步骤说明"
+    },
+    {
+      "标题": "请填写第三个步骤标题",
+      "说明": "请填写第三个步骤说明"
+    }
+  ],
+  "评价目标": [
+    {
+      "等级": "一星",
+      "说明": "请填写完成最基础要求时，学生需要做到什么"
+    },
+    {
+      "等级": "二星",
+      "说明": "请填写在基础上进一步完成时，学生需要做到什么"
+    },
+    {
+      "等级": "三星",
+      "说明": "请填写完成进阶挑战时，学生需要做到什么"
+    }
+  ],
+  "示例区标题": "请填写中间示例区标题，通常可写：示范样例",
+  "示例页面文件": "请填写同级示例页面文件名，例如 example.html"
+}