@aiyiran/myclaw 1.1.25 → 1.1.26

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

@@ -0,0 +1,92 @@
+# demo 生成提示词
+
+用途：
+把一个题目灵感、设计角度或课堂切入点，先变成一个适合演示的 demo 页面。
+
+## 目标
+
+你现在不是在先整理 JSON。
+你要做的是：
+**先把灵感做成一个看得见的 __demo__.html 页面。**
+
+## 为什么先做 demo
+
+因为 demo 是后续流程的起点：
+- demo 出来后，学生页内容更容易整理
+- demo 出来后，教师 JSON 也更容易提炼
+- demo 能帮助快速判断这个题目有没有意思、能不能继续发展
+
+## 输出要求
+
+生成的 demo 页面要满足：
+- 适合演示
+- 页面不要太复杂
+- 一眼能看出这个任务大概是什么
+- 能作为后续 __student__.json 和 __teacher__.json 的上游参考
+
+## 写 demo 时要注意
+
+### 1）先突出核心效果
+不要一开始把所有功能都做满。
+先做出最能说明这个题目价值的那一个效果。
+
+### 2）适合课堂抛砖引玉
+这个 demo 不一定是完整作品，
+但它必须足够清楚，能让人一眼看懂方向。
+
+### 3）优先做“能看见”的页面
+优先让页面可看、可点、可感受，
+而不是先写很多结构化说明。
+
+### 4）为后续 JSON 留出空间
+做 demo 时，心里要有这些问题：
+- 这个任务学生到底要做什么？
+- 步骤会是什么？
+- 评价目标会是什么？
+- 老师侧会怎么看这个任务？
+
+## 如果 demo 是多图对比练习页，要遵守这些规则
+
+### 页面结构
+- 首屏基本看完
+- 尽量一屏展示核心内容
+- 如果是三张图对比，必须三栏横排同时展示
+
+### 每一栏的结构
+- 上面放图片
+- 下面放观察和思考提示
+- 不直接写改进建议
+- 不直接告诉学生答案
+
+### 文字控制
+- demo 页面优先短句
+- 顶部说明必须很短
+- 每张图下面只放 2 到 3 个短问题
+- 不要长段落
+- 不要把老师说明塞进学生首屏
+
+### 目标
+- 让学生一打开就能同时看到几张图
+- 能马上开始比较
+- 能先发现一个问题
+- 能想一个最小修改点
+
+### 资源命名方式
+- demo 中使用的图片、音频等资源文件名，不要只用简单固定名
+- 统一使用：`中文学生友好名_2位数字随机戳`
+- 例如：`班级小组徽章_47.png`
+- 这样可以减少浏览器缓存带来的旧图问题
+
+### 资源路径方式
+- demo 网页中的所有媒体资源，不要使用本地相对路径
+- 必须使用 CDN 链接
+- CDN 固定前缀写死为：`https://cdn.yiranlaoshi.com/yiran/workspace-ai-demo`
+- 后面再拼接资源相对路径
+- 例如：`https://cdn.yiranlaoshi.com/yiran/workspace-ai-demo/c102_给小组作品做微调训练/班级小组徽章_47.png`
+
+## demo 生成后的下一步
+
+生成 demo 页面后，不要立刻结束。
+下一步要继续：
+1. 从 demo 中提炼 __student__.json
+2. 再提炼 __teacher__.json

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

@@ -0,0 +1,115 @@
+# 阶段2：生成 __student__.json
+
+用途：
+在题目灵感已经比较清楚、或者 demo 方向已经大致确定时，先把学生侧任务结构定下来。
+
+注意：
+**这个阶段不要求一定已经有 __teacher__.json。**
+**这个阶段甚至不要求一定已经有完整作品。**
+
+这个阶段最重要的目标只有一个：
+**先把学生任务的步骤和评价结构 JSON 确立下来。**
+
+---
+
+## 本阶段输出对象
+
+必须输出：`__student__.json`
+
+结构如下：
+
+```json
+{
+  "任务标题": "",
+  "一句话说明": "",
+  "步骤": [
+    {
+      "标题": "",
+      "说明": ""
+    }
+  ],
+  "评价目标": [
+    {
+      "等级": "",
+      "说明": ""
+    }
+  ],
+  "示例区标题": "",
+  "示例页面文件": ""
+}
+```
+
+---
+
+## 这个阶段真正要解决什么
+
+不是去做教师分析。
+不是去做能力标签。
+不是去解释教学意义。
+
+而是先确定：
+- 学生要做什么
+- 这个任务怎么拆成步骤
+- 评价目标怎么分一星、二星、三星
+- 学生页中间示例区叫什么、加载什么文件
+
+---
+
+## 字段逐项对应
+
+### 1）任务标题
+学生页最上方的大标题。
+必须短、清楚、一眼看懂。
+
+### 2）一句话说明
+用一句话告诉学生：
+- 先做什么
+- 再做什么
+- 重点练什么
+
+### 3）步骤
+这是本阶段最重要的部分。
+先把学生完成任务的路径定下来。
+
+要求：
+- 一般 3 到 4 步
+- 每一步都包含：
+  - 标题
+  - 说明
+
+### 4）评价目标
+也是本阶段核心。
+告诉学生做到什么程度算完成、做到更好是什么样。
+
+要求：
+- 默认固定三档：一星、二星、三星
+- 每一档都要有一句清楚说明
+
+### 5）示例区标题
+控制学生页中间示例区标题。
+默认可写“示范样例”。
+
+### 6）示例页面文件
+控制 iframe 加载哪个页面文件。
+默认可写：
+```json
+"示例页面文件": "example.html"
+```
+
+---
+
+## 原则
+
+1. 全部使用中文
+2. 只写学生真正需要读的内容
+3. 不把老师看的信息混进来
+4. 标题要短
+5. 一句话说明只保留一句
+6. 步骤比解释更重要
+7. 评价目标必须清楚可执行
+
+---
+
+## 结果要求
+
+输出的 __student__.json 应该可以直接喂给学生页模板，不需要再大改。

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"
+}