显影· 三主题树 · 高中 术语表

编程智能体上手:把任务单交给 AI

交一张任务单,看它读文件、改代码、跑起来——你当项目主,管立项与验收。

⏱ 10–15 分钟讲 · 例 · 做 · 卡编号 hs-make-04
学习证据 学完后,怎么核对? 如何核对 · 适用边界 · 最后复核

把学习结果留在一个可以回看、可以复做的动作里;这一区只写学生能自己检查的证据。

如何核对

  • 授权文件夹、命令与 diff 记录
  • 账号政策、数据处理与凭证检查

适用边界

使用前核对账号年龄、地区与学校政策;只授权本课项目,凭证和敏感资料不提交。代码是否上传或保留取决于服务与设置,按当前官方说明核对;命令、删除、安装、联网与 diff 逐项确认。

最后复核

这是内容复核日期,不是学习截止日期。

例子从传纸条,到让程序员进车间

初中那会儿,你在聊天框里让 AI 写页面:它吐代码,你复制、粘贴、保存、刷新,错了再贴回去问——像隔着墙传纸条。现在换一种活法:小舟打开终端里的编程智能体,交了一张任务单,然后看着它自己打开文件、自己改代码、自己跑起来测试,改完向他汇报。十分钟里小舟没碰键盘几下,但每个关口都是他点的头。

初中站回看:AI 写页面,你当验收员 —— 那时在聊天框里验收一段代码;现在验收员升职了:智能体进车间,你管立项与验收。

名词这类工具叫编程智能体(coding agent)——能在授权范围内读取项目文件、修改代码和运行命令的 AI 工具。Claude Code、Codex、Z Code 都属于这一类;可用地区、账号年龄和收费政策会变化,按学校允许和官方当前说明选择。配套词:任务单=你交给它的活的说明书,一会儿细讲。

定义智能体=有手脚的 AI;你=项目主

聊天框只会「说」,智能体有手脚:拿到任务后,它在「读文件 → 改代码 → 跑命令 → 看结果」的循环里自己推进,直到干完或者卡住来问你。相应地,你的岗位从打字员升成项目主,只管两头:立项——写清任务单;验收——检查交付。任务单四项,正是 1.3a「向 AI 交代任务」那套量规的工程版:①背景(项目什么样)②目标(做成什么样)③约束(红线在哪)④验收(怎么算合格)。

你=项目主 立项 · 验收 任务单 四项 编程智能体 读文件 改代码 跑命令 看结果 交付物 页面 / 脚本 / 报告 验收:对任务单第④项逐条查 → ✓ 收货 / ↩ 打回

协作回路:任务单进,交付物出;验收不过就带着意见打回,直到逐条过关。

三条上手纪律,先立后用:①放行要看懂——智能体动文件、跑命令前会请示,读一遍再点头,看不懂就先问「这条会干什么」;②范围要收小——只让它访问这次练习的项目文件夹,先看将执行的命令和文件 diff,删除文件、安装软件、联网或读取项目外目录没有明确必要就拒绝,确有必要也必须停下来确认;③凭证不出门——登录凭证与 API 密钥只存自己电脑,不进代码、不发群里,写例子一律用 YOUR_KEY_HERE 这样的占位符。

开始前先检查:确认服务的账号年龄与地区要求,并遵守学校设备和账号政策;共用电脑不要保存登录状态。没有可用账号、安装权限或免费额度时,不影响学习本课方法——用例一的任务单和验收清单,与同学互相扮演“项目主 / 执行者”,或手动完成同一处小改动。

泛化换个角度:能写清验收的活,才能放心外包

把镜头拉远,这节课教的其实是「怎么把活交出去」:立项清楚+验收严格,中间过程就可以放手。这条判据不只对 AI 成立——请同学帮你收集资料、小组作业分工、将来工作里带团队,全是同一个结构。反过来说也成立:一件事如果你连「怎么算做好了」都写不出来,那它还没到能交给别人(或 AI)的火候,先想清楚再外包。智能体抬高的不是「会不会写代码」的门槛,是「能不能说清要什么、验得出好坏」的门槛。

核心句:编程智能体自己读文件、改代码、跑命令;你当项目主,任务单四项交代清楚、验收标准先写好——能验收,才能放心交办。

补充三例——两个常见用法,一个易错。

例一 · 常见用法:第一张像样的任务单

小舟要给 studio 加深色模式,任务单四项写全:背景——纯静态个人页,通过本地 HTTP 预览;目标——右上角加一个按钮,一键切换深浅配色;约束——不引入任何外部库,改完仍能用本地 HTTP 预览;验收——①点按钮颜色切换 ②刷新后记住上次选择 ③手机宽度下按钮不挡标题。智能体改了三处文件后交活,小舟逐条验收:①②过,③按钮压住了标题——打回附一句「验收第③条没过」。两分钟后修复,收货,顺手 git commit 一张「智能体首单交付」。

例二 · 常见用法:把报错原样丢给它

朵朵的 Python 脚本炸出一屏红字,一个词都看不懂。她先删掉报错里可能暴露用户名、完整路径、密钥或个人资料的部分,只把错误类型、必要命令和上下文贴给智能体;任务单只有三句:「解释这个错误是什么意思;用最小的改动修好它;告诉我以后怎么避免。」智能体指出是文件路径里少了一层文件夹(正是 2.1a 讲的相对路径问题),改一行修好,还给了检查路径的小习惯。修好是收获,看懂报错的过程是更大的收获——边修边学,别只要结果。

例三 · 易错:不立项就外包,请示一律放行

阿豪对智能体甩了一句「帮我做个超酷的个人网站,要有高级感」,然后每弹一次请示就点一次「允许」,全程刷手机。半小时后:网站确实做完了,但风格根本不是他想要的,项目里多了一堆他不认识的试验文件,还装了两个他不知道干嘛的工具包。错在哪:两头全松——没立项(背景约束验收全空,「高级感」没法验收),也没把关(请示读都不读就放行)。修法:开工前四项写全,尤其把验收写成能逐条打钩的清单;每次请示先读懂再放行,删文件、装东西这类动作尤其要看清对象是什么。

三张任务单,哪张能让智能体一次干到点子上?

上手 · 交出你的第一张任务单
  1. 先核对账号年龄、地区、学校设备与安装权限;条件不满足就使用上面的同伴/手动替代路径,不借用他人账号。
  2. 如果条件允许,先用 git 快照或复制文件夹留一份可回退的本地版本,再在 studio 项目里启动编程智能体,只开放这个项目文件夹;交任务单——可以直接用例一那张深色模式单,或自拟一件小活,但四项必须写全。
  3. 盯它干活:每条请示读懂再放行,逐项看命令与文件 diff;看不懂就先问「这条命令会干什么」。
  4. 交付后对验收清单逐条打钩;有不过的,打回时写明是第几条没过。
  5. 全部过关后,用 git commit -m "智能体首单交付" 或复制文件夹留一份本地快照;不要为了完成这一步把仓库上传。

怎么算过关:任务单四项齐全且验收可打钩;说得出账号/设备是否允许、智能体能访问哪个文件夹;至少发生过一次「读懂命令和 diff 再放行」或「打回重修」;最终逐条验收通过并留下一份本地快照。走同伴/手动替代路径也算完成。

复习卡 · 点一下翻面

智能体和聊天框差在哪?你这个项目主管哪两头?

答案

智能体有手脚:读文件→改代码→跑命令→看结果,循环推进。项目主管两头:立项(任务单四项:背景/目标/约束/验收)和验收(逐条打钩,不过就带意见打回)。

  • 任务单四项写全,「验收」要写成能逐条打钩的清单。
  • 请示读懂再放行;凭证与密钥只存本机、不进代码、不发群里。
  • 能写清验收的活才能放心外包——对 AI 如此,对人也如此。