第 06 节:迭代成个人知识库

本节 objectives:

• 能把一次生成后的反馈交给 agent 继续修课。
• 能区分改内容、改来源、改结构和改展示。
• 能把合格课程沉淀到个人知识库,而不是停在一次性产物。

先修:会预览并跑 guard ｜ 上一节 << 05 ｜ 下一节:无

生成只是第一版,知识库来自迭代

这个项目的野心不是"给你一页答案",而是把你想学的东西变成能持续阅读、修订、扩展的本地知识库。README 把产物描述为结构稳定的 Markdown 自学课和本地阅读站。¹ Markdown 的好处是:你可以审 diff、改 sources、扩 lesson,也可以长期放进 git。

所以一次使用 skill 的尾声不该是"谢谢,结束"。更好的尾声是:读一节、指出卡点、让 agent 小步改,再 guard。

每门课目录里的 agentmentor.json 记录这门课的原始请求、学员 brief、范围、guard 状态和 next steps。它是课程本地 manifest,跟着 Markdown 一起进 git;它不是把你的偏好写进 Codex 长期记忆的接口。长期可靠靠的是这个可复查文件、sources、diff 和 guard 形成闭环。

讲解

反馈可以分四类:

course-authoring-guide.md 要求练习有做法指引、自评 rubric、解答和渐进提示,并指向学习者真实环境。² 课程质量 rubric 也把 exercises、load 和 readable 当成独立维度。³ 你给反馈时,最好直接引用这些维度,比如"第 05 节 load 太高"或"Level 2 练习没有可量化 rubric"。

跟我做一遍(worked example)

目标:把一门新生成课从"能过 guard"改到"更适合我"。

第一次生成后,你读第 02 节发现它太抽象。给 agent:

第 02 节读起来还是概念讲义,请只改这一节:- 在讲解前加一个真实使用场景。- worked example 改成一步步操作,每步解释为什么。- Level 2 练习加可量化自评 rubric。- 不改其他文件,改完跑 course-guard。

这条反馈好在四点:限定文件、指出问题、给出改法、要求复验。它让 agent 小步行动,也方便你审 diff。

换你补全(faded example)

你读完一门课,觉得来源不够可靠。请补全反馈:

请先不要改所有课文。先检查 __________。把所有标为 __________ 的关键事实替换成 __________。改完后运行 __________。

参考答案:

请先不要改所有课文。先检查 sources.md 和课文引用。把所有标为 AI生成/营销 的关键事实替换成官方文档或权威教程支撑。改完后运行 node scripts/course-guard.mjs <课程目录>。

关键判断点是:来源问题先改 sources 和引用,不要只润色正文。

小结

使用 agent-mentor-skill 的完整动作是:一句话触发,补边界,生成 Markdown,阅读站预览,guard 验收,再按真实阅读反馈迭代。起手式可以很简单;长期可靠靠的是 agentmentor.json、sources、diff、guard 和你持续把卡点说清楚。