第 34 课教师讲稿｜把长任务整理成接得住、查得到的工作记录

对应 AIPath 第 7 阶段 Manus 案例。60 分钟，每人一台电脑。今天不从“顶尖智能体”的宣传词开始，而是接过一项已经做了一半的任务：资料读到哪里了，哪些话能写进草稿，什么时候应当停住？学生会操作真实的本地字符串比较和资料状态检查。这里没有启动 Manus，也没有测量任何模型的真实缓存。

本课要让学生带走什么

第一，能把一段工作输入拆成不常变的要求、本次变化的观察、原文证据和待办。第二，能检查引用路径是否真的指向可读的正确版本，保留失败以及未确认事项。第三，能把“官方作者披露的经验”“自己设计的课堂验证”“仍不知道的产品行为”分开写。最终交付是一份别人接手也能继续核查的小任务记录，不以自动执行了多少步作为成绩。

学生已学过上下文、工具调用和智能体循环。此时补充“上下文工程”这个名字即可：“它关注的是每次工作时，系统把哪些材料、要求和结果交给模型。把一桌散乱纸张整理好，并不等于给人换了大脑；管理输入也不等于当场训练了模型参数。”这个比方只解释信息组织，不代表模型像人一样记忆。

课前准备：先把材料准备完整

教师打开本页实验“长任务的上下文、文件与停止检查”，将任务设为社团借用说明、稳定规则在前、文件路径与期望版本、可读且版本匹配、读取上限 2、保留草稿。核心按钮叫“组装并检查任务状态”。先试一次，确认能展开“查看两轮实际组装文字”，再复位，避免学生看见结果后补写预测。学生工作纸与答案分开发；本稿末尾才放独立题讲评。

投影四张原创材料卡。卡片不是 Manus 实际日志，也不是用户的真实社交资料。

任务卡 T。 写一段社团借用说明，交付草稿即可。只允许 read 与 draft 两种动作。工具目录里还列有 send，但本任务没有允许发送。

规则卡 P。 只依据当前版本写；资料没有的事项标未知。规则与工具目录在两轮都保持原样，时间分别写 15:01、15:02。注意：这是人为设置的两轮输入，不是实际推理服务请求。

原文卡 D2，路径 rules/D2.txt。 第 1 条：学生同时最多借 2 件。第 2 条：续借须提前 1 天申请，并经值班人员批准。第 3 条：周末安排未提供。同名路径若被旧稿覆盖，将返回“旧版 D1：学生同时最多借 1 件”。

待办卡。 核对数量；核对续借条件；核对周末是否有规定；写草稿；明确没有发送。每一项只能用实际看见的原文或动作记录支持。按钮返回的草稿由规则拼接，不是模型创作；若原文无法核验，页面不形成草稿。

教师自己还要准备一条简短的官方依据。Manus 在 2025 年 7 月 18 日的工程文章中讨论了稳定输入前缀、外置文件、待办和错误观察。它是团队在当时披露的经验，不能当作全部内部实现或今日性能保证。课堂以下任务、数字、字符串和停止规则均为原创，不是对该产品的逆向结果。

0—6 分钟｜让接手的人说出还缺什么

教师把“报告已基本完成”写在白板上，说：“假设同学今天请假，只给你这一句话。你敢直接交报告吗？你至少需要拿到什么，才能知道他做过什么？”先让学生写 Q1，不立即告诉他们标准答案。请两位同学各读一项具体材料。若回答“需要更多上下文”，追问：“把上下文换成一个能交给我的东西，是文件、某次结果、还是一个待确认问题？”

接着出示任务卡 T 与 D2，教师说：“我们把大任务缩小到一段借用说明。虽然只有三条，但也能出现旧版、路径失效、漏掉批准条件和擅自发送。任务复杂不是做错的唯一原因；交接材料没有说明白，小任务一样会失真。”让学生在工作纸写最终交付类型“草稿”，并划掉自己刚才猜想的发布或通知动作。这是读取任务边界，不是给每一步增加无关审批。

学生可能认为待办写了“核对数量”，就表示已经核对过。教师指着空白状态栏问：“哪句话告诉你已经读到了第 1 条？如果没看到，你愿意把状态写成完成还是待查？”让学生自己补一列依据，体会待办和证据承担不同职责。

6—12 分钟｜用两轮文字观察“稳定的开头”

教师在白板写两组排列。A 组为“时间 15:01 → 规则 P → 工具目录”，第二轮把时间改成 15:02。B 组把规则 P 与工具目录放在时间前面。说：“先不用讲缓存原理。用手指从第一字开始往后比，只要遇到不同，连续相同的开头就到此为止。后面再出现相同内容，也不能接回最前面的连续段。”

让学生做 Q2 预测：哪组连续相同的开头更长？为什么时间只改了一位也有影响？不要求他们凭空猜精确字符数。然后打开实验，保持默认条件运行；展开两轮完整文字，指向时间最后一位的不同。仅把排列改为“变化时间在最前”，再次运行，让学生把前后两次数值抄在同一行，并写分叉位置。

教师补充准确边界：“页面数的是字符，我们没有调用分词器，更没有看到真实服务的缓存日志。因此只能确认这两段文字在哪儿开始不同。真正能否复用计算，还受模型、服务实现、路由、有效期等条件影响。这里的字符数不能换算成省了多少钱。”若学生说稳定排列一定便宜，追问：“你有账单和命中指标吗？没有时，你能把结论缩小到哪一项已观察事实？”

12—18 分钟｜输入变长，先分清必要信息和重复信息

保持稳定排列，把“在上下文中放什么”改为完整原文。请学生先看实际组装文字，再看长度。教师说：“不要只为让数字小而删字。第 2 条里的‘并经批准’影响含义，第 3 条说明未知，也有用。我们要判断是否能回查，而不是比赛谁把字删得更少。”

请学生将原文第 2 条改写为一句更短的话，但在纸上保留申请时间与批准条件。此处只改工作纸，不修改实验固定材料。邀请一位学生念自己的摘要，如果写成“提前申请即可续借”，教师只问：“申请发生了以后，还有哪一步结果没有确定？”让学生回到材料自己补全。

再次切回“文件路径与期望版本”，比较“全文材料”和“文件引用”两项计数。教师提醒：“我们刻意使用短材料，引用未必比全文短。文件外置不是放个路径就自动省。原文很长时可能减少本轮携带的内容，但多了读取、版本与权限这些运行条件。”让学生记录这次实际差值，不把预期收益抄成已经发生的结果。

18—25 分钟｜亲手让一个引用失效

教师先读 rules/D2.txt 这个路径，说：“路径像一张取件地址，不是包裹本身。我们今天的页面并没有真的访问磁盘，而是在三种固定资料状态里查表；这样所有同学都能复现失败。”保持路径与版本模式，只把资料状态改成文件不存在，读取上限为 2，然后让学生预测哪些待办还能完成。

运行后逐条看两次不存在的观察，特别看“待核对，不可勾选完成”。教师说：“两次失败没有提供新原文。我们已经用尽本次允许尝试，继续凭旧摘要填数量并没有让证据出现。可以交付完成的资料整理，并列出缺文件，但不能写已经核验新版。”让学生在 Q3 写停止理由，包括路径、次数、缺什么。

接着只把状态改成同名路径被替换成旧版。教师问：“现在读成功了，是不是就好了？”运行后看 D1 与期望 D2 的不符。请学生圈出“读到了”与“读对版了”的区别。若有人说按最新读到的内容为准，追问：“这里‘最新读取’和‘最新有效版本’是同一件事吗？”此时不要展开复杂版本控制，只要求在引用里保留版本以及读取后的实际内容。

25—31 分钟｜把失败变成下一步能使用的记录

恢复可读且版本匹配。教师在白板写一份可复制的状态记录，让学生按 Q4 填充：

目标：借用说明草稿；不发送。
证据：rules/D2.txt，版本 D2，已读取第1—3条。
已确认：数量 / 续借的申请和批准条件。
未知：周末安排。
曾失败：哪条路径、什么结果、是否更正。
待办：逐句核查引用，保存草稿。
停止：缺原文或版本不符时不补写事实；每次读取上限2。

解释：“这里保留失败是为了告诉接手者哪条路不应机械重复，并不是错误越多越好。我们需要与决策相关的路径和结果，不需要把一整屏无关日志都贴进下一轮。”请学生判断“读取失败”与“读取 rules/D2.txt 两次不存在”哪一个可帮助下一步行动，要求说明差别。

此时可以让具备现成工具的学生把这份状态记录连同完整 D2 原文交给自己的 AI 对话工具，要求仅整理状态。可复制要求为：“根据以下课堂材料整理一份交接记录。分为目标、已确认、未知、来源、失败和下一步。只生成文字草稿，不访问外部服务，不把待办写成已经执行。材料如下：……”这步是自选对照，主线本地练习不依赖它。记录真实输入和输出，不能把页面规则拼接文本署名为 Manus 输出。

31—37 分钟｜工具目录与允许动作分开看

指向实际组装文字里的工具目录 read、draft、send。问学生：“工具目录里有 send，能说明这次任务允许发送吗？”先在工作纸写理由，再把拟做动作切换成尝试发送。点击检查，看到拦截而没有发送。说明：“这里的拦截是课堂代码明确执行允许列表检查，不是测试了某个模型会不会听话。它把能提供的动作和此任务允许的动作分开处理。”

请学生说出可以保留的成果：原文、核验表、草稿、未发送状态。若有人觉得没有发送就算失败，回到任务卡的“交付草稿即可”。强调完成标准来自当前任务要求，既不能擅自增加外部动作，也不必把已允许的草稿工作暂停在多余确认上。

最后让同桌扮演接手者，仅凭状态记录复述数量和续借条件，并指出周末未知。如果他必须问“你到底用了哪版”，说明交接记录还有具体缺项。教师收两份匿名例子用于讲评，不把同学记录输入任何外部服务。

37—47 分钟｜独立任务：换成会议纪要

发出 M2 材料：路径 minutes/M2.txt，第 1 条周三 15:00 开会；第 2 条地点待确认；第 3 条小李负责整理草稿。旧 M1 写周二 15:00。任务是整理纪要草稿，仍只允许 read、draft。请学生完成 Q5，先写预测和交接记录，再切换实验任务为会议纪要核对。

独立阶段教师不提前说时间与地点的答案。巡查只问：“这句话由哪条支持？”“你把未确定的信息放在哪里了？”“如果同名文件已被旧版替换，哪项完成状态要改？”学生需尝试当前版、文件不存在、同名旧版三个条件，并选择其中一次失败做有理由的停止说明。已经完成的学生再比较时间在前后的前缀，不要求等待全班。

Q5 的最后一步要求 50 字以内纪要与交接状态分开。字数只用于迫使学生简洁，不因中文标点计数争论扣分。重点是短稿仍保留未知及出处，不能为了显得完整而虚构会议室。没有工具的同学可在纸上按同样的固定状态卡逐条检查，写“纸面核查”，程序运行栏留未执行。

47—53 分钟｜讲评：完成和未完成可以同时说清

独立段结束才打开参考答案。请学生先自查三件事：是否把周二旧时间混入；是否自创地点；是否把工具目录等同授权。教师用一份含有地点猜测的匿名草稿，问：“这句话拿掉以后，稿子是不是仍完成了资料支持的部分？”由此说明报告可以有明确边界，缺信息不需要靠流畅句子填满。

再看失败记录。若文件不存在，应写已经尝试到本次上限、缺新版可读证据、需要提供原文或修正路径；若同名旧版，写版本不符。两者下一步不同。不要一律给出“让 AI 再试一次”这种没有针对原因的建议。学生保留首答，在修订栏写哪条观察促成修改。

53—60 分钟｜从产品名字回到自己的工作方法

教师问：“如果把 Manus 这个名字遮住，今天哪些东西仍能拿到学习项目里用？”让学生选一项真实目标，例如文献报告、社团活动说明或作品说明，填写 Q6 的小交接模板。只写一份公开或本人有权使用的材料名称及版本，不在课堂收集同学私聊或给人格、专业方向打分。

最后的离堂句式是：“官方文章让我了解了……；我的本地实验确认了……；我还没有验证……。”学生不能只写“AI 很厉害”或“做了上下文工程”。教师示范如何把笼统动词换成可回查的对象，如比较了两轮字符串、核对 D2 第 2 条、拦截 send。收齐预测、两轮观察、独立纪要与来源范围四份证据，60 分钟结束。

后置答案、板书与补救

Q2 默认稳定规则在前会保留更长的连续相同开头；准确字符数以两段实际文字复算，不是 Token 或命中率。Q3 不存在与版本不符都不能勾选核验完成，但原因不同。Q4 必须保留“提前 1 天申请并经批准”，周末未知，交付草稿且未发送。Q5 合格纪要为：周三 15:00 开会，地点待确认，小李整理草稿〔M2 第 1—3 条〕。缺原文或旧版替换时停止将事实写成已核验；send 被允许列表拦截。

板书保留三行：规则＋观察＋可回查证据＋待办；读成功还要核对版本；完成状态必须对应任务边界和实际记录。 如果学生仍把保存路径当作读过文件，给他一张空地址卡，让他指出能从地址推知哪条原文，通常能迅速发现缺口。若字符串比较困难，打印两轮文字，从开头逐字划线即可；这条后备验证相同逻辑，不伪称实际测到了缓存。

课后加深可选一项已有工具中的真实小任务，保存原输入、文件内容与版本、可见操作结果、最终草稿和缺项。只有工具确实提供缓存指标时才讨论实际命中表现；否则只比较内容是否可追溯。此扩展不计入 60 分钟。本课原创程序已设随课测试，外部产品效果与真人试教另需实际记录。

来源

• AIPath 对应课：课序和讨论主题。
• Manus 官方上下文工程文章，2025-07-18：仅据公开的工程经验展开问题，不推断未披露内部实现。本课三份任务材料与程序均为原创。