讲义:先写完整,定稿成网页,只留一份
现在
在用
截至 10 月 11 日

AI 协作学习 · 功能说明

这一部分管讲义:AI 把一个技术主题写成离开对话也能读懂的完整讲义,上课前定稿成网页;之后修稿、换对话、换模型接手,都读同一份。

当前情况:草稿可以先写,上课前定稿成网页,网页同名的 JSON 是唯一现行讲义;一节对应一个小问题,我读完用自己的话答(10 月 11 日核对项目规则)。我是不是真的听懂,仍靠讨论和回答来看。

具体测试保留各自日期,页面不实时探测运行状态。

项目源码:私有仓库,源码未公开;用法与技术说明可在下面阅读。

讲义:先写完整,定稿成网页,只留一份
现在
在用
截至 10 月 11 日

AI 协作学习 · 功能说明

这一部分管讲义:AI 把一个技术主题写成离开对话也能读懂的完整讲义,上课前定稿成网页;之后修稿、换对话、换模型接手,都读同一份。

当前情况:草稿可以先写,上课前定稿成网页,网页同名的 JSON 是唯一现行讲义;一节对应一个小问题,我读完用自己的话答(10 月 11 日核对项目规则)。我是不是真的听懂,仍靠讨论和回答来看。

具体测试保留各自日期,页面不实时探测运行状态。

项目源码:私有仓库,源码未公开;用法与技术说明可在下面阅读。

这项功能怎样使用
这一部分做什么

用途与实际影响

为什么需要它

讲义如果只是一页提纲,缺的部分得我自己去补;只给一段漂亮的摘要,又会丢掉做决定要用的条件和边界。同一篇如果存着好几份版本,修改的时候、换模型接手的时候都容易对不上。所以这里规定讲义写完整,而且只留一份现行稿。

举个实际例子

我说“先给我完整讲义再聊”。AI 不会甩来一页提纲,而是先核对资料、回看已经交过的讲义、拿反例检查自己的结论,写好草稿,上课时把当天那一篇定稿成网页发我链接。我读完某一节,移开讲义用自己的话答一句;它保留对的部分,只纠正最影响结论的一处,我卡住了就换个例子重讲这一节。

最后我会得到什么

每个技术主题得到一份离开对话也能读懂的网页讲义:每节开头一句要点,末尾一个问题和折叠的参考答案,最后有串起全篇的收尾题。项目交流、简短答疑和重要纠正直接在聊天里说,不另建讲义,但备课要求一样。

这项功能怎样使用
这一部分做什么

用途与实际影响

为什么需要它

讲义如果只是一页提纲,缺的部分得我自己去补;只给一段漂亮的摘要,又会丢掉做决定要用的条件和边界。同一篇如果存着好几份版本,修改的时候、换模型接手的时候都容易对不上。所以这里规定讲义写完整,而且只留一份现行稿。

举个实际例子

我说“先给我完整讲义再聊”。AI 不会甩来一页提纲,而是先核对资料、回看已经交过的讲义、拿反例检查自己的结论,写好草稿,上课时把当天那一篇定稿成网页发我链接。我读完某一节,移开讲义用自己的话答一句;它保留对的部分,只纠正最影响结论的一处,我卡住了就换个例子重讲这一节。

最后我会得到什么

每个技术主题得到一份离开对话也能读懂的网页讲义:每节开头一句要点,末尾一个问题和折叠的参考答案,最后有串起全篇的收尾题。项目交流、简短答疑和重要纠正直接在聊天里说,不另建讲义,但备课要求一样。

从哪里开始

说“把这个问题讲明白”,或者要这一课的完整讲义。

需要准备什么
  • 当前问题或技术主题
  • 哪些地方没听懂或要补完整(如有)
从开始到拿到结果
1AI 核对并写稿
先核对来源、已经交过的讲义和反例,再写草稿:从现实问题、结论和例子讲起,再补术语、取舍和必要的技术细节;上课前定稿成网页。
2交付与接续
上课时打开当天一篇并给链接;我读完复述,AI 按我的回答纠正关键缺口。资料冲突或边界说不清时先补查,不拿提纲冒充最终版。
从哪里开始

说“把这个问题讲明白”,或者要这一课的完整讲义。

需要准备什么
  • 当前问题或技术主题
  • 哪些地方没听懂或要补完整(如有)
从开始到拿到结果
1AI 核对并写稿
先核对来源、已经交过的讲义和反例,再写草稿:从现实问题、结论和例子讲起,再补术语、取舍和必要的技术细节;上课前定稿成网页。
2交付与接续
上课时打开当天一篇并给链接;我读完复述,AI 按我的回答纠正关键缺口。资料冲突或边界说不清时先补查,不拿提纲冒充最终版。
技术实现与依据(一)
这里保留实现、关键条件、精确入口、历史记录和验证结果。
10 月 11 日核对
讲人话和保留专业细节同时成立,是这一部分的硬规定,写完没有不按篇幅或模板算;现行讲义的载体是网页及其同名 JSON(项目规则 10 月 7 日版本)。9 月 22 日页面依据的旧版本 e44fb5d 只作历史。
关键规则与设计选择
1
每节先写一句结论,再补读懂它需要的背景。
2
讲差别用具体场景和反例,不用定义去解释定义。
3
专业词第一次出现时跟上中文意思,之后保留英文原名,方便以后查;容易混的词只用有意义的简称,不编口诀。
4
次要细节折叠起来,但会改变结论、风险或适用范围的事实不删;折叠处标明是“后面讲”(写出在哪讲)还是“查阅”(可查,不用背)。
5
草稿可以先写 Markdown,上课前定稿成网页;网页同名的 JSON 是唯一现行讲义,修稿和换老师接手都读这一份,旧 Markdown 移出工作区、只留在版本历史里。
AI现在怎样协助
  • 一份讲义只解决一个明确问题,开头先说为什么值得弄懂;一节对应一个小问题。
  • 第一次交的完整讲义,要等资料核验、对照已交讲义、反例检查和自审都做完才定稿;新写的主干讲义再交给一个没有历史上下文的新会话独立复核,在旧讲义上改写的由老师自审,复核做多少按风险和收益定。
  • 每节开头一句要点,末尾一个问题加折叠参考答案(我先答再看),最后列本篇的必答题和收尾题;这是现在的安排,不是固定模板或字数标准。
技术实现与依据(一)
这里保留实现、关键条件、精确入口、历史记录和验证结果。
10 月 11 日核对
讲人话和保留专业细节同时成立,是这一部分的硬规定,写完没有不按篇幅或模板算;现行讲义的载体是网页及其同名 JSON(项目规则 10 月 7 日版本)。9 月 22 日页面依据的旧版本 e44fb5d 只作历史。
关键规则与设计选择
1
每节先写一句结论,再补读懂它需要的背景。
2
讲差别用具体场景和反例,不用定义去解释定义。
3
专业词第一次出现时跟上中文意思,之后保留英文原名,方便以后查;容易混的词只用有意义的简称,不编口诀。
4
次要细节折叠起来,但会改变结论、风险或适用范围的事实不删;折叠处标明是“后面讲”(写出在哪讲)还是“查阅”(可查,不用背)。
5
草稿可以先写 Markdown,上课前定稿成网页;网页同名的 JSON 是唯一现行讲义,修稿和换老师接手都读这一份,旧 Markdown 移出工作区、只留在版本历史里。
AI现在怎样协助
  • 一份讲义只解决一个明确问题,开头先说为什么值得弄懂;一节对应一个小问题。
  • 第一次交的完整讲义,要等资料核验、对照已交讲义、反例检查和自审都做完才定稿;新写的主干讲义再交给一个没有历史上下文的新会话独立复核,在旧讲义上改写的由老师自审,复核做多少按风险和收益定。
  • 每节开头一句要点,末尾一个问题加折叠参考答案(我先答再看),最后列本篇的必答题和收尾题;这是现在的安排,不是固定模板或字数标准。
技术实现与依据(二)
1
核对当前资料,对照已经交过的讲义,先消除会改变理解的矛盾。
2
用反例和自审检查遗漏、推得过头和讲不通的地方。
  • 我读完一节,移开讲义用语音或文字自己答;老师不抢答,保留对的部分,只纠正最影响结论的一处。对话里已经讲清的段落可以不读,我已经能讲出来的部分可以跳过。
  • 按我已经知道的内容调整讲义的详略,不把一般读者会缺的东西当成我个人的短板;按内容之间的关系选短文、表格、流程图或完整讲义,不为配图而配图。
  • 项目和业务上的交流,老师备好课后直接在聊天里谈,不要求我先读一份总览讲义;简短答疑和纠正不另建文档。
这一步怎样进行
技术实现与依据(二)
1
核对当前资料,对照已经交过的讲义,先消除会改变理解的矛盾。
2
用反例和自审检查遗漏、推得过头和讲不通的地方。
  • 我读完一节,移开讲义用语音或文字自己答;老师不抢答,保留对的部分,只纠正最影响结论的一处。对话里已经讲清的段落可以不读,我已经能讲出来的部分可以跳过。
  • 按我已经知道的内容调整讲义的详略,不把一般读者会缺的东西当成我个人的短板;按内容之间的关系选短文、表格、流程图或完整讲义,不为配图而配图。
  • 项目和业务上的交流,老师备好课后直接在聊天里谈,不要求我先读一份总览讲义;简短答疑和纠正不另建文档。
这一步怎样进行
技术实现与依据(三)
3
写清这篇要解决的现实问题和一句结论。
4
补上读懂结论需要的背景,配一个具体场景。
5
比较几种做法的代价,列出容易弄错的反例。
6
补术语、技术细节、未知和参考来源,定稿成网页,同名 JSON 作为唯一现行讲义。
7
上课时打开当天一篇,按我的复述纠正关键缺口。
技术实现与依据(三)
3
写清这篇要解决的现实问题和一句结论。
4
补上读懂结论需要的背景,配一个具体场景。
5
比较几种做法的代价,列出容易弄错的反例。
6
补术语、技术细节、未知和参考来源,定稿成网页,同名 JSON 作为唯一现行讲义。
7
上课时打开当天一篇,按我的复述纠正关键缺口。
名词和入口
这里会用到的说法
名词意思
现行讲义网页同名的那份 JSON;修稿、换对话、换模型都只读这一份。
草稿/定稿草稿可以提前写成 Markdown;定稿是上课前生成的网页,旧 Markdown 移出工作区。
折叠区讲义里收起来的细节,标明是“后面讲”还是“查阅”。
独立复核新写的主干讲义交给一个没有历史上下文的新会话检查;写稿的老师不能自称终审。
这一步说的是什么

讲义这一部分把一个技术主题写成完整的网页讲义:先讲现实问题、结论、理由和影响,再补专业名称、实现细节、反例和未知;同一篇只留一份现行稿,我读完用自己的话答。

名词和入口
这里会用到的说法
名词意思
现行讲义
意思:
网页同名的那份 JSON;修稿、换对话、换模型都只读这一份。
草稿/定稿
意思:
草稿可以提前写成 Markdown;定稿是上课前生成的网页,旧 Markdown 移出工作区。
折叠区
意思:
讲义里收起来的细节,标明是“后面讲”还是“查阅”。
独立复核
意思:
新写的主干讲义交给一个没有历史上下文的新会话检查;写稿的老师不能自称终审。
这一步说的是什么

讲义这一部分把一个技术主题写成完整的网页讲义:先讲现实问题、结论、理由和影响,再补专业名称、实现细节、反例和未知;同一篇只留一份现行稿,我读完用自己的话答。

出问题时
避免什么问题
防止讲义只堆术语、一次塞进太多上下文、简化以后丢了条件、例子换个场合就不成立、技术细节没法继续追问,以及同一篇存着几份版本互相打架。
边界
  • 没有固定字数、统一模板或必须配图的要求。
  • 提纲、草稿或聊天片段不能冒充第一次交的完整讲义;同一篇只有一份现行讲义。
  • 讲人话不能把“必须”、例外、停止条件和未知改成模糊的建议。
  • 我已经熟悉的部分,后面的讲义不再详细铺垫。
遇到问题时怎样处理
  • 我只能复述术语: 回到现实问题、例子和选择的代价,重讲这一节。
  • 简化后边界没了: 补回影响判断的条件,技术细节放到第二层。
  • 讲了很长却没有结论: 先写清一句判断和为什么,再删掉无关的铺垫。
  • 资料没核验或和已交讲义矛盾: 暂停定稿,回到来源、旧讲义、反例和自审补齐后再交。
出问题时
避免什么问题
防止讲义只堆术语、一次塞进太多上下文、简化以后丢了条件、例子换个场合就不成立、技术细节没法继续追问,以及同一篇存着几份版本互相打架。
边界
  • 没有固定字数、统一模板或必须配图的要求。
  • 提纲、草稿或聊天片段不能冒充第一次交的完整讲义;同一篇只有一份现行讲义。
  • 讲人话不能把“必须”、例外、停止条件和未知改成模糊的建议。
  • 我已经熟悉的部分,后面的讲义不再详细铺垫。
遇到问题时怎样处理
  • 我只能复述术语: 回到现实问题、例子和选择的代价,重讲这一节。
  • 简化后边界没了: 补回影响判断的条件,技术细节放到第二层。
  • 讲了很长却没有结论: 先写清一句判断和为什么,再删掉无关的铺垫。
  • 资料没核验或和已交讲义矛盾: 暂停定稿,回到来源、旧讲义、反例和自审补齐后再交。
依据与来源
参考与依据
  • 项目规则(10 月 7 日版本):讲义写法、定稿和唯一现行稿的规定
  • 讲义索引:每篇真实交付的日期和我的反馈摘要
  • 网页同名 JSON:每篇讲义的现行内容(公开页不展示)
怎样检查这一步没有跑偏
  • 拿一篇讲义,看第一次读的人能不能先说出现实问题、理由和结论,再看术语。
  • 用反例确认简化没有改变范围、强弱或停止条件。
  • AI 讲得清楚和我自己讲得出来是两回事,不能互相证明;检查看我能不能用自己的话说出来,不只看术语和文件齐不齐。
  • 确认同一篇只有网页同名 JSON 一份现行讲义。
和其他步骤怎样衔接

接收“先查清楚”部分核对过的事实;“继续聊”部分用我的真实追问检查讲义还缺不缺前提或边界。

依据与来源
参考与依据
  • 项目规则(10 月 7 日版本):讲义写法、定稿和唯一现行稿的规定
  • 讲义索引:每篇真实交付的日期和我的反馈摘要
  • 网页同名 JSON:每篇讲义的现行内容(公开页不展示)
怎样检查这一步没有跑偏
  • 拿一篇讲义,看第一次读的人能不能先说出现实问题、理由和结论,再看术语。
  • 用反例确认简化没有改变范围、强弱或停止条件。
  • AI 讲得清楚和我自己讲得出来是两回事,不能互相证明;检查看我能不能用自己的话说出来,不只看术语和文件齐不齐。
  • 确认同一篇只有网页同名 JSON 一份现行讲义。
和其他步骤怎样衔接

接收“先查清楚”部分核对过的事实;“继续聊”部分用我的真实追问检查讲义还缺不缺前提或边界。

复制 AI 续作说明

项目:讲义:先写完整,定稿成网页,只留一份;仓库:页面未提供仓库地址;范围:整个项目;目标:(这里写这次要做的事)。先读项目的 AGENTS.md 和说明,按现行规则做。

把“目标”换成这次要做的事,整段复制给 AI。