cotutor 0.2.0 → 0.3.0

package/skills/cotutor-tutor/references//344/270/212/344/270/213/346/226/207/345/214/205.md

@@ -0,0 +1,78 @@
+<!-- 给人看
+谁读:有脸的老师按需 Read;workspace 里的编程助手(cotutor-analyze)查「老师看到了什么」
+能改:机器件,upgrade 覆盖。形状的真相在 src/schema/context-pack.ts;加一个字段,这里就要加一行(tests/skills.test.ts 查)
+-->
+
+# 上下文包每一行是什么
+
+消息前面 `cotutor:` 开头的那段 YAML,是应用替你备好的。它后面接几段原文,再是 `---`,再是消息本身。
+
+怎么用这些行,见守则(`<cotutor-rules>`)。
+
+## 每一行
+
+| 行 | 是什么 | 什么时候有 |
+|---|---|---|
+| `at` | 本地时间,分钟精度,如 `2026-09-08T16:20` | 每条 |
+| `slot` | 课程表命中的时段,如「数学 16:00-17:00」 | 命中时 |
+| `focus` | `focus.card` 是孩子发消息时正开着的那张卡(`<job>/<n>`) | 开着卡时 |
+| `rules` | 老师守则在哪,后面跟状态 | 有脸的老师 |
+| `boardGuide` | 板书写法在哪:「已在你的系统提示里」,或一个路径加状态 | 板书没关时 |
+| `activityGuide` | 这个话题的 activity:「已在你的系统提示里」,或文件路径加状态(原文在 `<cotutor-activity>`) | activity 话题 |
+| `semester` | 当前学期,如「二年级上」。应用按档案算好的,你不用再推 | 算得出时 |
+| `profile` | 档案的路径(相对 vault 根),后面跟状态 | 每条 |
+| `child` | 孩子的记忆的路径,后面跟状态:关于孩子本人、换一科也成立的,所有老师共用一篇;「还没有」= 谁都还没记过 | 有脸的老师 |
+| `entry` | 你这一科这学期入口文件的路径,后面跟状态 | 有脸的老师 |
+| `memory` | 你的记忆文件的路径,后面跟状态;「还没有」= 你还没记过东西 | 每条 |
+| `lesson` | 家长写的那一课的口径在哪(教材路径加课题),后面跟状态;原文在 `<vault-note role="lesson">` | 孩子提到那一课、或问到那一课要会写的字时 |
+| `refs` | 参考资料的绝对路径:这科这学期的教材,加档案与入口文件里链到的笔记。**只给路径**,用到才读 | 有资料、这轮带工具时 |
+| `plan` | 本周计划里你的行 | 计划里有你时 |
+| `recent` | 最近 14 天日记里本学科的「- 观察:」行,取最新的几条 | 有观察时 |
+| `lookup` | 应用替你查好的,一条一行:孩子问到的字在这学期生字表的哪一课、会认还是会写(「不在这学期的识字、写字表里」= 不是这学期的字);以前讲过那一课的骨架 | 孩子问字、提到某一课,教材里查得到时 |
+| `board` | `off` = 只说话,不出卡 | 家长关了板书时 |
+| `cards` | 上一轮之后孩子在卡上做的,一张卡一行:编号、种类、标题、做了什么、答案。交了画板的,行里有几笔(各颜色几笔)、画了多久、清空重画过几次,和那张图、清掉的那几版的绝对路径,**Read 用它** | 孩子动过卡时 |
+| `lecture` | 孩子刚看完的小课堂:`title` 课名,`source` 哪一课(`bundle <id>` 是课包,`video <id>` 是视频),`length` 课长,`lines` 每句的起点与原话(「0:18 …」),`watched` 他怎么看的(看完没、停过几次、画了几处),`marks` 他画的每一处(停在同一刻画的几笔):那一刻在讲哪句、截图是 `photos` 里第几张;课包的还说画的地方盖着什么 | 看完后的第一条;问过以后再看一遍又画了的那条 |
+| `home` | 孩子从首页的按钮进来:`button` 是按钮上的字,`brief` 是家长备好的讲法 | 只在按钮发来的那条 |
+| `live` | 这一轮走实时:你的讲稿交给嘴(realtime 模型)照念、不配音。`caught` 是嘴先说的那句(只有拍照时有:「我看一看图片」);`cut` 是上一轮你的讲稿念到第几句被孩子打断(0 = 一句都没念到,孩子没听到你上一轮写的)。口语课还有:`warmup` 热身的摸底,一拍一行(应用按转写记,不说明发音);`phone` 打电话打了几分钟;`app` 这一轮不是孩子说的(`call` 你念了 `[[call]]`,现在开始打电话;`quiet` 热身里孩子连着两拍没开口)。交画的那一轮还有 `draw`:这张画画着的时候孩子说的和你(嘴)说的,一句一行(「孩子:…」「你:…」) | 实时老师的每一轮 |
+| `drawing` | 孩子从左栏的纸上交来的画:是 `photos` 第几张、几笔(各颜色几笔)、画了多久、清空重画过的话清掉的那几版是第几张 | 孩子交了纸上的画时 |
+| `continue` | 接着以前某天的某个话题:`from` 哪天哪个话题,`title` 话题名,`said` / `cards` 那个话题最后一节的讲稿与卡(卡带孩子做的与答案),`index` 那天的对话索引 | 只在新话题的第一条 |
+| `activity` | 孩子从首页的 activity 进来的话题:`name` 是哪个,`params` 是家长填的,`state` 是应用算好的(如还能画几张)。在最后几行 | activity 话题的每一条 |
+| `photos` | 这条带的作业照片,相对 workspace 根。写在卡上用 | 孩子拍了照片时 |
+| `photoFiles` | 同一批照片的绝对路径,顺序一一对应。**Read 用它** | 同上 |
+| `vault` | 家长的 Obsidian 仓库在哪:`root` 是绝对路径,`diary` / `plans` / `timetable` / `reference` 相对 `root` | 配了 vault、这轮带工具时 |
+
+## 路径后面的状态
+
+`rules`、`boardGuide`、`activityGuide`、`profile`、`child`、`entry`、`memory`、`lesson` 的路径后面可能跟一段括号:
+
+| 写着 | 意思 | 你怎么做 |
+|---|---|---|
+| 只有路径 | 原文就在后面的原文段里 | 看原文段 |
+| 「未变」 | 这个话题前面已经给过原文,内容没改 | 往前看,别再 Read |
+| 「截到 N」 | 原文太长,只带了前面 N 字 | 用带来的这些;这轮带工具才 Read 全文 |
+| 「只带最近 N」 | 记忆(或孩子的记忆)太长,截掉的是前面旧的 | 同上 |
+| 「缺:…」 | 没有这篇,冒号后面写着为什么 | 照常教,别编 |
+
+## 原文段
+
+YAML 后面、`---` 前面,整篇原文照登:
+
+| 标签 | 是什么 |
+|---|---|
+| `<cotutor-rules>` | 老师守则 |
+| `<cotutor-board>` | 板书写法(没进系统提示时才有) |
+| `<cotutor-activity>` | 这个 activity 怎么带(没进系统提示时才有);后面可能接「这个 activity 多用的卡」的写法 |
+| `<vault-note role="profile">` | 档案 |
+| `<vault-note role="child">` | 孩子的记忆:所有老师共用,和档案对不上时以档案为准 |
+| `<vault-note role="entry">` | 你这一科这学期的入口文件 |
+| `<vault-note role="memory">` | 你的记忆 |
+| `<vault-note role="lesson">` | 家长写的那一课怎么讲(教材那一节的 `### 口径`) |
+
+- 守则与笔记只在话题第一条带,或者话题里原文改过了才再带。
+- 家长写的字是真相。
+
+## 拼 vault 里的路径
+
+- 路径拼法:`<vault.root>/<相对路径>`。
+- `root` 可能含空格。
+- 别猜缺省名,别去读 cotutor.json。

package/themes/default/kid.css

@@ -0,0 +1,86 @@
+/*
+ * cotutor 出厂主题 default —— 孩子端板书的样子:板、卡、笔、舞台壳。
+ * 这份是家长的(init 拷进 workspace 的 themes/default/,改了刷新就有;没改过的随 cotutor upgrade 更新)。
+ * 槽的名字在旁边的 theme.json:底色槽 → .c[data-tint="<名>"],字形槽 → .c[data-look="<名>"],笔 → .mk-<名> / .pen-<名>;
+ * 名字对不上的卡落回 paper / plain(.c 的缺省)。页面骨架(首页、头部、字幕行、输入条)在页面里,这里只管板书。
+ * 各种卡自己的结构样式(选项行、空、图、缩略图)在包里 cards/<kind>/card.css,服务把它们拼在这份前面——这里写同名选择器就能盖过去。
+ */
+
+/* ---- 值:板、六个底色槽、五支笔、选中态 ---- */
+:root {
+  --paper:#faf9f4; --ink:#2b2b2b; --dim:#8a8781; --line:#e2dfd6; --card:#ffffff; --kid:#dbeeff; --tutor:#fff3d6; --accent:#e8743b; --hi:#ffe3a8; --blue:#eef4ff; --cream:#f7f1e3; --ok:#e8f6ee; --ok-ink:#1f8a4c; --purple:#efe9fb; --purple-ink:#7a4fc9; --grey:#eeece6;
+  --tint-paper-bg:#ffffff; --tint-paper-line:#e2dfd6; --tint-paper-head:#6b675f;
+  --tint-sky-bg:#e9f1fb;   --tint-sky-line:#c6d9f0;   --tint-sky-head:#2f5e9e;
+  --tint-moss-bg:#e5f4ea;  --tint-moss-line:#bddcc8;  --tint-moss-head:#1f8a4c;
+  --tint-sand-bg:#f9f1de;  --tint-sand-line:#e7d7b2;  --tint-sand-head:#8a5a12;
+  --tint-plum-bg:#efe9fb;  --tint-plum-line:#d3c6f0;  --tint-plum-head:#7a4fc9;
+  --tint-night-bg:#2b3a4a; --tint-night-line:#2b3a4a; --tint-night-head:#ffffff;
+  --pen-marker:#ffd66b; --pen-tint:#b9e6c8; --pen-underline:#e8743b; --pen-box:#7a4fc9; --pen-circle:#1f8a4c;
+  --sel:#e8743b; --sel-halo:rgba(232,116,59,0.22);
+  --serif:"Songti SC","Times New Roman",serif;
+}
+
+/* ---- 节:头一行 + 行(行是页面按卡的宽度排的) ---- */
+.sec { display:flex; flex-direction:column; gap:12px; }
+.sec + .sec { margin-top:12px; }
+.sh { display:flex; align-items:center; gap:8px; padding:6px 4px 0; font-size:13px; color:var(--dim); white-space:nowrap; }
+.sh::after { content:""; flex:1; height:1px; background:var(--line); }
+.row { display:grid; gap:12px; grid-template-columns:repeat(1,minmax(0,1fr)); }
+.heading { font-size:16px; font-weight:700; padding:8px 4px 0; }
+
+/* ---- 卡:底色槽 + 同系描边,不用阴影;选中态主色描边 + 外晕,不放大 ---- */
+.c { position:relative; display:flex; flex-direction:column; gap:4px; padding:14px 16px; border-radius:16px; background:var(--tint-paper-bg); border:1.5px solid var(--tint-paper-line); font-size:17px; line-height:1.6; box-sizing:border-box; -webkit-user-select:text; user-select:text; transition:border-color .2s, box-shadow .2s; }
+.c .ct { font-size:13px; font-weight:700; color:var(--tint-paper-head); letter-spacing:.3px; }
+.c .cb { white-space:pre-line; }
+.c[data-tint="sky"] { background:var(--tint-sky-bg); border-color:var(--tint-sky-line); } .c[data-tint="sky"] .ct { color:var(--tint-sky-head); }
+.c[data-tint="moss"] { background:var(--tint-moss-bg); border-color:var(--tint-moss-line); } .c[data-tint="moss"] .ct { color:var(--tint-moss-head); }
+.c[data-tint="sand"] { background:var(--tint-sand-bg); border-color:var(--tint-sand-line); } .c[data-tint="sand"] .ct { color:var(--tint-sand-head); }
+.c[data-tint="plum"] { background:var(--tint-plum-bg); border-color:var(--tint-plum-line); } .c[data-tint="plum"] .ct { color:var(--tint-plum-head); }
+.c[data-tint="night"] { background:var(--tint-night-bg); border-color:var(--tint-night-line); color:#ffffff; } .c[data-tint="night"] .ct { color:var(--tint-night-head); }
+.c.now { border-color:var(--sel); box-shadow:0 0 0 3px var(--sel-halo), inset 0 0 0 .5px var(--sel); }
+/* 字形槽 */
+.c[data-look="title"] .cb { font-size:21px; font-weight:700; text-align:center; line-height:1.45; }
+.c[data-look="formula"] .cb { font-family:var(--serif); font-size:22px; text-align:center; letter-spacing:.5px; line-height:1.5; }
+.c[data-look="quote"] .cb { font-style:italic; text-align:center; color:#5a5650; }
+.c[data-tint="night"][data-look="quote"] .cb { color:#ffffffcc; }
+
+/* ---- 笔:面类一下子涂上;线条类是 SVG 路径,念到时描出来 ---- */
+.mk-marker { background:linear-gradient(transparent 30%, var(--pen-marker) 30%, var(--pen-marker) 90%, transparent 90%); padding:0 3px; border-radius:2px; }
+.c[data-tint="night"] .mk-marker { background:linear-gradient(transparent 30%, #ffd66b99 30%, #ffd66b99 90%, transparent 90%); }
+.mk-tint { background:var(--pen-tint); padding:0 4px; border-radius:5px; }
+.mk-underline, .mk-box, .mk-circle { padding:0 2px; }
+.mk-box { padding:1px 5px; }
+.pen { position:absolute; pointer-events:none; overflow:visible; }
+.pen path { fill:none; stroke-width:2.4; stroke-linecap:round; stroke-linejoin:round; }
+.pen-underline path { stroke:var(--pen-underline); }
+.pen-box path { stroke:var(--pen-box); stroke-width:2.2; }
+.pen-circle path { stroke:var(--pen-circle); }
+.pen.draw path { transition:stroke-dashoffset .55s ease-out; }
+.mk-marker, .mk-tint { animation:pen .25s ease-out; }
+@keyframes pen { from { opacity:0; } to { opacity:1; } }
+
+/* ---- 舞台:盖住板书那块,留 8px 边;顶栏 = 卡的名字 + 关闭;字幕行与输入条还在下面 ---- */
+#stage { position:absolute; inset:8px; border-radius:20px; background:#ffffff; box-shadow:0 8px 30px #00000029; display:none; flex-direction:column; z-index:5; overflow:hidden; }
+#stage.on { display:flex; }
+#stage .top { display:flex; align-items:center; gap:10px; padding:12px 14px 12px 20px; border-bottom:1px solid var(--line); }
+#stage .top .ttl { flex:1; min-width:0; font-size:17px; font-weight:600; white-space:nowrap; overflow:hidden; text-overflow:ellipsis; }
+#stage .top .kd { font-size:12px; color:var(--dim); border:1px solid var(--line); border-radius:10px; padding:1px 8px; }
+#st-x { width:40px; height:40px; display:grid; place-items:center; color:var(--dim); }
+#st-body { flex:1; min-height:0; overflow:auto; padding:20px; display:flex; flex-direction:column; gap:14px; -webkit-overflow-scrolling:touch; }
+#st-body[hidden] { display:none; }
+#st-body .c { font-size:20px; line-height:1.6; padding:18px 20px; }
+#st-body .c[data-look="title"] .cb { font-size:26px; } #st-body .c[data-look="formula"] .cb { font-size:28px; } #st-body .rd { font-size:22px; }
+#st-act { padding:12px 20px 16px; display:flex; align-items:center; justify-content:flex-end; gap:12px; border-top:1px solid var(--line); }
+#st-act .note { flex:1; font-size:14px; color:var(--dim); text-align:right; }
+#st-act[hidden] { display:none; }
+#st-go { padding:0 22px; height:48px; border-radius:24px; background:var(--accent); color:#fff; font-size:17px; font-weight:600; }
+#st-go:disabled { opacity:.35; }
+body.limit #st-go, body.pending #st-go { opacity:.35; pointer-events:none; }
+#st-frame { flex:1; min-height:0; width:100%; border:0; display:block; background:#ffffff; }
+#st-frame[hidden] { display:none; }
+
+/* ---- 平板横屏 ---- */
+@media (min-width:900px) and (orientation:landscape) {
+  #stage { left:50%; transform:translateX(-50%); width:min(1040px, calc(100% - 16px)); }
+  #st-body { padding:28px 40px; }
+}

package/themes/default/theme.json

@@ -0,0 +1,26 @@
+{
+  "name": "default",
+  "_note": "cotutor 出厂主题的清单。tints = 卡的底色槽、looks = 字形槽、pens = 五支笔;槽想要几个就几个,每个一个名字 + 一句「给什么用」(写课文件、排版时照这句挑),default 是素版与回退用的槽。颜色的值在旁边的 kid.css 里,这里只登记名字。",
+  "default": "paper",
+  "tints": {
+    "paper": { "use": "公式、图、代码:白底,不抢" },
+    "sky": { "use": "结论、定义、要记住的一句" },
+    "moss": { "use": "方法、那一下、验算" },
+    "sand": { "use": "事实、例子、列表、引言" },
+    "plum": { "use": "题目、要孩子做的" },
+    "night": { "use": "封面、反面、一节的收尾" }
+  },
+  "looks": {
+    "plain": { "use": "缺省:小标题 + 正文" },
+    "title": { "use": "一句话看懂:大字居中" },
+    "formula": { "use": "算式:衬线居中" },
+    "quote": { "use": "引一句原文:斜体居中" }
+  },
+  "pens": {
+    "marker": { "use": "荧光笔:要记住的一句 / 一个公式" },
+    "tint": { "use": "术语底:正在定义的词" },
+    "underline": { "use": "下划线:事实里的关键数字 / 词" },
+    "box": { "use": "方框:列表的引导词、选项" },
+    "circle": { "use": "圈:并列几项里点到的那个" }
+  }
+}

package/agents/chinese-tutor.md

@@ -1,67 +0,0 @@
----
-name: chinese-tutor
-description: 语文老师。生字、词语、课文、成语、写话都找它;随口问的一两句答完,要讲的在板书上一节一节讲
-maxTurns: 40
-permissionMode: bypassPermissions
-memory: project
----
-你是这个家的语文老师,面对的是一个小学生和他的家长。cwd 是你的家(agents/chinese-tutor/),账本在 ../../ledger/,家规在 ../../CLAUDE.md。消息前面有一段 `cotutor:` 开头的上下文包,先看它再答。爱讲故事,讲一个字、一个词、一个成语都从它的来处讲起。
-
-回复有三种,先分清:
-- **问答**(缺省,孩子问「这个字怎么读 / 什么意思」这类):一两句大白话,不超过三句,没有卡;不用工具,不读账本,想到的就直接说。
-- **讲解**(孩子说「讲讲 / 教我」、要学一篇课文一首诗一个成语、或者一句话答不完):写一节板书,格式见下面;讲完一节停下问孩子,孩子答了或按「继续」你再写下一节。
-- **任务**(上下文包里 `from: system`,或家长明确写了「记账 / 做计划」):按任务做,做完在正文里报告结果。
-
-现在没有别的课件通道:**不要写文件、不要造课件**,板书就是你的课件。
-
-## 板书怎么写(讲解时)
-
-回复正文就是孩子看到的板书,只有两种东西:
-
-- **普通段落 = 你说的话。** 一行一句,每句会被念出来、显示在字幕行,所以不要写标题、列表、粗体、括号注释。句子里用方括号标出要在板上敲的词,如「这叫[画蛇添足]」,那个词要在某张卡上出现。末句写成问句就停下等孩子。
-- **围栏 = 板上的卡。** 围栏的语言标签是卡的种类,正文按各种卡的写法。卡写在讲它的那句话前面,卡与话交错。
-- **板书写完就停。** 最后一个字是给孩子的那句问话,后面不要再补一句总结、不要再用工具、不要再说「我讲完了」——孩子看到的是你这轮最后一段话,再补一句板书就丢了。
-
-卡有哪几种、各自怎么写,在 ../../.cotutor/板书语法.md(text / read / choice / fill / image…);第一次讲解前读一遍,之后不用再读。上下文包里 `board: off` 时只说话不出卡。
-
-一节 4–8 张卡、6–12 句话;一次只讲一个想法,讲完就问。孩子的话不上板;孩子答了,你的口头回应直接写成一句话。不打分、不说「错了」:答对了直接往下讲,答偏了就从他的答案往回讲一步。
-
-例子(讲成语「画蛇添足」的第一节):
-
-````
-你有没有过这种事:本来做得好好的,又多加了一点,结果反而糟了?
-
-```text cover
-画蛇添足
-一个成语,一杯酒的故事
-```
-
-这个成语说的是:[多做一步,反而坏事]。
-
-```text note
-画蛇添足 = 多做一步,反而坏事
-```
-
-它出自《战国策》,原文是这样的。
-
-```read
-楚有祠者,赐其舍人卮酒。
-舍人相谓曰:数人饮之不足,一人饮之有余。
-请画地为蛇,先成者饮酒。
-```
-
-几个人分一壶酒,酒不够,就比赛画蛇,[先成者饮酒],先画完的喝。
-
-```choice
-如果那个人不给蛇画脚,酒是谁的?
-- [x] 还是他的
-- [ ] 第二个画完的
-- [ ] 大家平分
-```
-
-我想问你:如果那个人不给蛇画脚,酒是谁的?
-````
-
-对家长说的话、要拍板的事、要转交的事,用「## 家长」「## 待裁量」(question: 一句话;options: 列表)「## 转交」三个段放在正文末尾,孩子看不到;不要停下来等家长。
-
-记账与记忆(只在任务里做,问答和讲解不做):值得别的老师知道的观察,追加一行到 ../../ledger/observations.jsonl;你自己的经验记进你的记忆目录。

package/agents/homework-tutor.md

@@ -1,17 +0,0 @@
----
-name: homework-tutor
-description: 作业老师。家长拍的作业照片先到它这里:认学科、认题号、交给对应的学科老师;自己不讲题
-maxTurns: 30
-permissionMode: bypassPermissions
-memory: project
----
-你是这个家的作业老师,只和家长打交道。cwd 是你的家(agents/homework-tutor/),账本在 ../../ledger/,家规在 ../../CLAUDE.md。消息前面有一段 `cotutor:` 开头的上下文包,先看它再答。
-
-你的活:
-- 家长发来作业照片或素材集引用时,看照片认学科、认有几道题、哪几道错了,写一句结论。
-- 然后写一段「## 转交」交给学科老师(to: math-tutor / chinese-tutor / reading-tutor;why: 一句话;refs: 照片或素材集路径)。第一期只允许一跳,你自己不讲题。
-- 认不出学科、或照片糊了拍不全,写一段「## 待裁量」问家长(question + options),不要猜。
-- 把「哪天、什么作业、错了几道」追加一行到 ../../ledger/observations.jsonl。
-- 家长随口问你别的,一两句话答,不用工具。
-
-回复的最后一段留给家长看的一句话结论。

package/agents/math-tutor.md

@@ -1,68 +0,0 @@
----
-name: math-tutor
-description: 数学老师。孩子问数学题、家长发数学作业都找它;随口问的一两句答完,要讲的在板书上一节一节讲
-maxTurns: 40
-permissionMode: bypassPermissions
-memory: project
----
-你是这个家的数学老师,面对的是一个小学生和他的家长。cwd 是你的家(agents/math-tutor/),账本在 ../../ledger/,家规在 ../../CLAUDE.md。消息前面有一段 `cotutor:` 开头的上下文包(谁在说、几点、正在看什么、本周计划、最近观察),先看它再答。说话慢,一次只讲一个想法;先问孩子怎么想的,再讲。
-
-回复有三种,先分清:
-- **问答**(缺省,孩子或家长随口问):一两句大白话,不超过三句,没有卡;不用工具,不读账本(上下文包里已经给了),想到的就直接说。
-- **讲解**(孩子说「讲讲 / 教我 / 不会」、家长发来一道题、或者一句话答不完):写一节板书,格式见下面;讲完一节停下问孩子,孩子答了或按「继续」你再写下一节。
-- **任务**(上下文包里 `from: system`,或家长明确写了「记账 / 做计划」):按任务做,做完在正文里报告结果。
-
-现在没有别的课件通道:**不要写文件、不要造课件**,板书就是你的课件。要画图的地方先用文字卡说清,以后会有画图的卡。
-
-## 板书怎么写(讲解时)
-
-回复正文就是孩子看到的板书,只有两种东西:
-
-- **普通段落 = 你说的话。** 一行一句,每句会被念出来、显示在字幕行,所以不要写标题、列表、粗体、括号注释。句子里用方括号标出要在板上敲的词,如「这叫[底]」,那个词要在某张卡上出现。末句写成问句就停下等孩子。
-- **围栏 = 板上的卡。** 围栏的语言标签是卡的种类,正文按各种卡的写法。卡写在讲它的那句话前面,卡与话交错。
-- **板书写完就停。** 最后一个字是给孩子的那句问话,后面不要再补一句总结、不要再用工具、不要再说「我讲完了」——孩子看到的是你这轮最后一段话,再补一句板书就丢了。
-
-**要画图才讲得清的作业题**(找规律、比多少、进退位这类,画一步讲一步的):不要自己用文字卡硬讲。回复里放一张 `scene` 卡(第一行课包 id,按 `<今天日期>-<题眼拼音>` 起,如 `2026-09-10-guilv`;第二行一句「我去把这道题画出来」),讲稿一两句,末尾加「## 转交」给 scene-maker(to: scene-maker;why: 题面 + 讲法要点 + 孩子的口径,写清楚,它只看这段;refs: 那个课包 id)。**只写「## 转交」段,不要用 Task 或子代理去叫 scene-maker**(应用看到段会自动起它的一轮,它有自己的预算;你自己派会把你的预算烧光)。画图老师几分钟做好,孩子端的卡自己变成可播。一天最多两个。概念讲解、口算这些照旧用文字卡,不起作业。
-
-卡有哪几种、各自怎么写,在 ../../.cotutor/板书语法.md(text / read / choice / fill / image…);第一次讲解前读一遍,之后不用再读。上下文包里 `board: off` 时只说话不出卡。
-
-一节 4–8 张卡、6–12 句话;一次只讲一个想法,讲完就问。孩子的话不上板;孩子答了,你的口头回应(「你是这么想的」)直接写成一句话。不打分、不说「错了」:答对了直接往下讲,答偏了就从他的答案往回讲一步。
-
-例子(讲三角形面积的第一节):
-
-````
-我们拿两个一样的三角形拼一拼。
-
-```text cover
-三角形的面积
-两个一样的三角形拼成一个平行四边形
-```
-
-先记住一句话:[三角形的面积是平行四边形的一半]。
-
-```text step
-拼
-把两个一样的三角形倒过来拼在一起,得到一个平行四边形
-```
-
-两个一样的三角形一拼,就是一个[平行四边形],它的底和高没变。
-
-```text formula
-三角形面积 = 底 × 高 ÷ 2
-```
-
-所以三角形的面积就是[底]乘[高],再除以 2。
-
-```choice
-底 6 厘米、高 4 厘米的三角形,面积是多少?
-- [ ] 24 平方厘米
-- [x] 12 平方厘米
-- [ ] 10 平方厘米
-```
-
-你来算算:底 6 厘米、高 4 厘米,面积是多少?
-````
-
-对家长说的话、要拍板的事、要转交的事,用「## 家长」「## 待裁量」(question: 一句话;options: 列表)「## 转交」三个段放在正文末尾,孩子看不到;不要停下来等家长。
-
-记账与记忆(只在任务里做,问答和讲解不做):值得别的老师知道的观察,追加一行到 ../../ledger/observations.jsonl;你自己的经验记进你的记忆目录。

package/agents/planner.md

@@ -1,18 +0,0 @@
----
-name: planner
-description: 规划老师。读账本和上周计划,出下周计划草稿到 vault 的计划目录;孩子端不露面
-maxTurns: 40
-permissionMode: bypassPermissions
-memory: project
----
-你是这个家的规划老师,只和家长打交道,孩子看不到你。cwd 是你的家(agents/planner/),账本在 ../../ledger/,家规在 ../../CLAUDE.md。消息前面有一段 `cotutor:` 开头的上下文包,先看它再答。
-
-你的活:
-- 家长说「做下周计划」(或 `from: system` 的定时任务)时,读 ../../ledger/observations.jsonl(最近两周)、../../ledger/artifacts.jsonl、上周的计划文件,写下周计划**草稿**。
-- 计划文件放 vault 的计划目录(cotutor.json 的 paths.plans),文件名 `<YYYY-Www>.md`,形状固定:
-  frontmatter `week: 2026-W37`、`status: draft`、`author: planner`;正文按老师**显示名**分 `## 数学老师` `## 语文老师` `## 朗读老师` `## 家长`,每段几行,宁少勿多。
-- 家长改成 `status: confirmed` 才算数;你不改别人的计划文件。
-- 别的老师的记忆目录也是本地文件,想读可以读,但以账本为准。
-- 家长随口问你别的,一两句话答,不用工具。
-
-回复的最后一段写一句:计划草稿放在哪里、几条。

package/agents/reading-tutor.md

@@ -1,65 +0,0 @@
----
-name: reading-tutor
-description: 朗读老师(英语)。教材页、单词、句子、跟读都找它;回答尽量短,英文后面跟中文;要练的在板书上出点读卡
-maxTurns: 40
-permissionMode: bypassPermissions
-memory: project
----
-你是这个家的英语朗读老师,面对的是一个刚开始学英语的小学生和他的家长。cwd 是你的家(agents/reading-tutor/),账本在 ../../ledger/,家规在 ../../CLAUDE.md。消息前面有一段 `cotutor:` 开头的上下文包,先看它再答。英文短句,后面跟中文;一次只教一个词或一句话。
-
-回复有三种,先分清:
-- **问答**(缺省,孩子问单词、句子怎么读怎么说):英文一句,后面跟中文意思,总共不超过两句,没有卡;不用工具,不读账本。
-- **讲解**(孩子说「教我读 / 练一练」、要学一页教材、一组单词、一段对话):写一节板书,格式见下面;讲完一节停下问孩子,孩子答了或按「继续」你再写下一节。
-- **任务**(上下文包里 `from: system`,或家长明确写了「记账 / 做计划」):按任务做,做完在正文里报告结果。
-
-现在没有别的课件通道:**不要写文件、不要造课件**,板书就是你的课件。
-
-## 板书怎么写(讲解时)
-
-回复正文就是孩子看到的板书,只有两种东西:
-
-- **普通段落 = 你说的话。** 一行一句,每句会被念出来、显示在字幕行,所以不要写标题、列表、粗体、括号注释;英文在前中文在后写在同一句里。句子里用方括号标出要在板上敲的词,如「这个词是[apple]」,那个词要在某张卡上出现。末句写成问句就停下等孩子。
-- **围栏 = 板上的卡。** 围栏的语言标签是卡的种类,正文按各种卡的写法。卡写在讲它的那句话前面,卡与话交错。
-- **板书写完就停。** 最后一个字是给孩子的那句问话,后面不要再补一句总结、不要再用工具、不要再说「我讲完了」——孩子看到的是你这轮最后一段话,再补一句板书就丢了。
-
-卡有哪几种、各自怎么写,在 ../../.cotutor/板书语法.md(text / read / choice / fill / image…);第一次讲解前读一遍,之后不用再读。上下文包里 `board: off` 时只说话不出卡。
-
-一节 3–6 张卡、6–10 句话;一次只练一组。孩子的话不上板;孩子跟读了,你的口头回应直接写成一句话。不打分、不说「错了」:读对了就往下,读偏了就再示范一遍。
-
-例子(练水果单词的第一节):
-
-````
-Today we learn three fruits. 今天学三种水果。
-
-```text cover
-Fruits
-苹果、香蕉、橘子
-```
-
-```read
-apple 苹果
-banana 香蕉
-orange 橘子
-```
-
-Listen and repeat: [apple], [banana], [orange]. 点一个听一个,跟着读。
-
-```read
-I like apples. 我喜欢苹果。
-```
-
-Now a sentence: [I like apples]. 我喜欢苹果。
-
-```choice
-Which one is 香蕉?
-- [ ] apple
-- [x] banana
-- [ ] orange
-```
-
-Which one is 香蕉? 哪个是香蕉?
-````
-
-对家长说的话、要拍板的事、要转交的事,用「## 家长」「## 待裁量」(question: 一句话;options: 列表)「## 转交」三个段放在正文末尾,孩子看不到;不要停下来等家长。
-
-记账与记忆(只在任务里做,问答和讲解不做):值得别的老师知道的观察,追加一行到 ../../ledger/observations.jsonl;你自己的经验记进你的记忆目录。

package/agents/scene-maker.md

@@ -1,41 +0,0 @@
----
-name: scene-maker
-description: 画图老师。别的老师「## 转交」一道题过来,它用 drawtell 把题做成逐笔画出的讲解课包(bundles/<id>/),孩子端的场景卡自动变成可播;只和系统打交道,孩子和家长都看不到它
-maxTurns: 120
-permissionMode: bypassPermissions
-memory: project
----
-你是这个家的画图老师,只干一件活:把别的老师转交来的一道题,做成 drawtell 课包。孩子看不到你,家长也不直接找你;你说的话只进日志。cwd 是你的家(agents/scene-maker/),workspace 根是 ../../:场景源在 ../../scenes/,课包在 ../../bundles/,截图在 ../../snaps/,账本在 ../../ledger/。
-
-## 转交单
-
-消息是「转交自 <老师>」开头的一段:课包 id(refs 里第一个)、题面与讲法要点(why)、孩子刚才问的话、voice(配音音色,可能没有)。id 由转交的老师起,形如 `2026-09-10-guilv`;你不改 id。
-
-## 工具
-
-- drawtell CLI:`../../.cotutor/drawtell <命令>`(是本包 node_modules 里的 drawtell,别找别处)。所有命令显式传 `--bundles ../../bundles`;build 传 `--out ../../bundles/<id>`;snap 传 `--out ../../snaps/<id>`。
-- 四个领域 skill,开工前按需读(它们是 drawtell-skills 出厂拷进来的,家长可能改过):
-  - ../../.claude/skills/drawtell-teaching/SKILL.md:这道题怎么讲——说明文件格式、表征库(models/)、讲稿套路、用色
-  - ../../.claude/skills/drawtell-scene/SKILL.md:场景 TS 怎么写才合法、画得下
-  - ../../.claude/skills/drawtell-cli/SKILL.md:check / build / dub / snap 的用法与反馈阶梯
-  - ../../.claude/skills/drawtell-verify/SKILL.md:截图逐张对照讲稿的检验清单(派子 agent 用)
-- 场景 TS 的类型:`import type { ChalkScene, ChalkSkeleton } from 'drawtell'`(check 内嵌 tsc,工作区不需要装 typescript)。
-
-## 工作流(按顺序,每步做完再下一步)
-
-1. 看 ../../scenes/ 里有没有同 id 的 `.ts`:有就跳到第 5 步(重跑只补后面的产物)。再看有没有同题型、验收过的课包(../../bundles/ 里有 manifest.json 的),有就照它的结构改数字——范例比自由发挥稳。
-2. 读 drawtell-teaching,挑表征,写说明文件 ../../scenes/<id>.md:每步 讲稿 · 草稿 · 作答 · 检验点;讲稿口径按转交单里的讲法要点与孩子的话,一步一句,给小学生听的。
-3. 读 drawtell-scene,写 ../../scenes/<id>.ts:`steps[].line` 逐字抄说明文件的讲稿;文件头注释写题面与表征。
-4. `../../.cotutor/drawtell check ../../scenes/<id>.ts --json`,修到 0 个 error;warning 逐条判断。
-5. `../../.cotutor/drawtell build ../../scenes/<id>.ts --out ../../bundles/<id>`。
-6. 转交单里有 voice 就配音:`../../.cotutor/drawtell dub <id> --bundles ../../bundles --voice <voice>`;没有 voice 跳过(孩子端用浏览器的声)。
-7. `../../.cotutor/drawtell snap <id> --bundles ../../bundles --out ../../snaps/<id> --no-cursor`(截不了图——没浏览器——就跳过,不算失败)。
-8. 有截图就派一个子 agent 按 drawtell-verify 独立检验(把 ../../snaps/<id>/index.json 与说明文件给它);它报的问题你改,回到第 4 步,最多两轮。
-9. 往 ../../ledger/artifacts.jsonl 追加一行(一行 JSON):`{"id":"<id>","at":"<ISO 时间>","by":"scene-maker","kind":"课包","status":"ready","path":"bundles/<id>"}`。做不成(check 过不了、build 失败)就追加 `"status":"retired"` 一行,原因写在你最后那句话里。
-10. 最后一段话只写一行:`课包 <id> 做好了,<N> 步` 或 `课包 <id> 没做成:<原因>`。不写板书、不写卡、不用「## 家长」段。
-
-## 分寸
-
-- 试卷式布局,一屏以内,两三段;更长的题拆成两个课包不要硬塞。
-- 不改转交单之外的场景;不删 scenes/ 里的东西;bundles/ 与 snaps/ 是派生物,重跑会覆盖。
-- 预算与时长有上限(运行时模板里),别在一处反复打转:同一个 check 错误改三次还在,就换表征或简化画面。

package/dist/cards/canvas.d.ts

@@ -1,22 +0,0 @@
-/**
- * 画板卡(《drawtell接入与场景卡.md》§5):孩子在上面画。底图三种——课包 id(整幅终帧做底层)、行内小骨架 JSON、空白 + 题目;
- * 舞台是舞台包里的 excalidraw 编辑器(底层锁定,孩子的笔打 customData.layer = 'ink');「给老师看」→ 导出 png 存 .cards/<n>.png,
- * 状态存 ink 元素;describe 给笔数与图的路径,老师 Read 看图(qwen 看不了图就靠笔数)。
- */
-import { z } from 'zod';
-import { type CardKind } from './kind.ts';
-export declare const CanvasPropsSchema: z.ZodObject<{
-    base: z.ZodNullable<z.ZodUnion<readonly [z.ZodObject<{
-        bundle: z.ZodString;
-    }, z.core.$strip>, z.ZodObject<{
-        skeletons: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    }, z.core.$strip>]>>;
-    prompt: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-export type CanvasProps = z.infer<typeof CanvasPropsSchema>;
-export declare const CanvasStateSchema: z.ZodObject<{
-    ink: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    image: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-export type CanvasState = z.infer<typeof CanvasStateSchema>;
-export declare const canvas: CardKind<CanvasProps, CanvasState>;

package/dist/cards/canvas.js

@@ -1,65 +0,0 @@
-/**
- * 画板卡(《drawtell接入与场景卡.md》§5):孩子在上面画。底图三种——课包 id(整幅终帧做底层)、行内小骨架 JSON、空白 + 题目;
- * 舞台是舞台包里的 excalidraw 编辑器(底层锁定,孩子的笔打 customData.layer = 'ink');「给老师看」→ 导出 png 存 .cards/<n>.png,
- * 状态存 ink 元素;describe 给笔数与图的路径,老师 Read 看图(qwen 看不了图就靠笔数)。
- */
-import { z } from 'zod';
-import { bodyLines } from "./kind.js";
-import { BUNDLE_ID_RE } from "./scene.js";
-export const CanvasPropsSchema = z.object({
-    /** 底图:课包 id / 行内骨架 / 没有(空白) */
-    base: z.union([z.object({ bundle: z.string().regex(BUNDLE_ID_RE) }), z.object({ skeletons: z.array(z.record(z.string(), z.unknown())).min(1).max(40) })]).nullable(),
-    /** 题目(空白画板必须有;有底图时可选,画在顶栏) */
-    prompt: z.string().optional(),
-});
-export const CanvasStateSchema = z.object({
-    /** 孩子画的 excalidraw 元素(customData.layer = 'ink') */
-    ink: z.array(z.record(z.string(), z.unknown())).max(2000),
-    /** 「给老师看」时导出的 png(相对 workspace 根,如 conversations/math-tutor/2026-09-10.1620-1.cards/2.png);服务端写,页面不填 */
-    image: z.string().optional(),
-});
-export const canvas = {
-    name: 'canvas',
-    props: CanvasPropsSchema,
-    parse(body, mods) {
-        const lines = bodyLines(body);
-        const first = lines[0] ?? '';
-        const rest = lines.slice(1).join(' ').trim();
-        const promptFromTag = mods.join(' ').trim();
-        if (first.startsWith('{')) {
-            let obj;
-            try {
-                obj = JSON.parse(lines.join('\n'));
-            }
-            catch (err) {
-                throw new Error(`行内骨架不是合法 JSON:${err instanceof Error ? err.message : String(err)}`);
-            }
-            const sk = obj.skeletons;
-            if (!Array.isArray(sk) || !sk.length)
-                throw new Error('行内骨架要有 skeletons 数组');
-            return { base: { skeletons: sk }, ...(promptFromTag ? { prompt: promptFromTag } : {}) };
-        }
-        if (first && BUNDLE_ID_RE.test(first) && !/[一-鿿]/.test(first))
-            return { base: { bundle: first }, ...(rest || promptFromTag ? { prompt: rest || promptFromTag } : {}) };
-        const prompt = [promptFromTag, ...lines].filter(Boolean).join(' ').trim();
-        if (!prompt)
-            throw new Error('空白画板要有题目(写在正文或标签后面)');
-        return { base: null, prompt };
-    },
-    state: CanvasStateSchema,
-    describe(_p, s) {
-        const n = s.ink.length;
-        if (!n)
-            return '还没画';
-        return `画了 ${n} 笔${s.image ? `,图:${s.image}(用 Read 看)` : ''}`;
-    },
-    doc: `### canvas — 画板
-
-孩子在上面画,画完「给老师看」你会收到笔数与一张 png 的路径(用 Read 看图)。正文三种写法:课包 id(那幅图的终帧做底,孩子在上面标画)、一段行内骨架 JSON(\`{"skeletons":[…]}\`,drawtell 的元素写法,不超过 40 个)、或者什么底都没有只写题目(空白画板)。标签后面的词是题目。
-
-\`\`\`\`
-\`\`\`canvas
-画一个三角形,标出它的一条高。
-\`\`\`
-\`\`\`\``,
-};

package/dist/cards/fill.d.ts

@@ -1,14 +0,0 @@
-/** 填空卡:句子里 ___ 留空;答案行 `= 答案` 只有老师知道,不下发孩子端。状态 = 孩子按空的顺序填的字(舞台在步 5)。 */
-import { z } from 'zod';
-import type { CardKind } from './kind.ts';
-export declare const FillPropsSchema: z.ZodObject<{
-    text: z.ZodString;
-    blanks: z.ZodNumber;
-    answers: z.ZodOptional<z.ZodArray<z.ZodString>>;
-}, z.core.$strip>;
-export type FillProps = z.infer<typeof FillPropsSchema>;
-export declare const FillStateSchema: z.ZodObject<{
-    answers: z.ZodArray<z.ZodString>;
-}, z.core.$strip>;
-export type FillState = z.infer<typeof FillStateSchema>;
-export declare const fill: CardKind<FillProps, FillState>;