AI工程化与智能体应用第3期:WorkBuddy 入门——搭你的第一个

老薛的人工智能 · AI工程化与智能体应用 · 第3期

进入第二模块「会借力」。本期三千字长篇，四段配置可直接抄走。

大家好，我是老薛。

前两期我们在练「会做」：把脚本变成工具，把配置从代码里拿出来。从这一期开始进入第二个模块——会借力。工具是 WorkBuddy，一件能读写你的文件、能替你跑命令、还能接外部服务的工作搭档。

本期要解决的痛点：很多人用 AI 是「每次重新介绍一遍自己」。换个对话窗口，前功尽弃；同一件事问三遍，得到三个答案。 解决办法不是换个更聪明的模型，而是把助手的身份、知识、流程、格式写进文件里——这一期就干这一件事。 

01｜十期地图：我们在第二站

十期分五级台阶：会做（1–2 期）→ 会借力（3–6 期）→ 会编排（7–8 期）→ 会交付（9–10 期）。会借力这一级又分两条线：3–4 期玩 WorkBuddy（通用工作搭档），5–6 期玩 Trae（面向编程的开发环境）。两条线的底层逻辑完全一致：先会做，才会改；不会做，借来的东西你连哪里不对都看不出来。

02｜先把边界画清楚：三能三不能

一句话定义：WorkBuddy 是一个「能动手」的对话式助手——它不只说话，还真去读文件、改文件、跑命令、联网查。这跟网页版聊天机器人是两回事。

能做的三件事：读写工作区里的文件；按你的指令执行命令与脚本；通过连接器访问外部服务（云开发、代码仓库、在线文档等）。做不到的三件事，更要记牢：不能替你思考——它不知道你的实验目的，你得说清楚；不能保证事实——它会一本正经地编，尤其是数字、文件名、接口参数；不能无授权对外发布——涉及公开发布的动作必须你亲自确认。

本期第一句原理：把「不能」写进制度，比期待它「能」更重要。一个助手的可靠性，不取决于它多聪明，取决于你把边界划得多清楚。

03｜五个积木：它到底由什么拼成

积木一，对话与上下文。你说话，它应答；它能看见的是「当前这一轮对话里出现过的内容」。上下文有长度上限，塞满了就会丢前面的。

积木二，文件与工作区。这是它相对网页版最大的优势：它能真正打开你磁盘上的文件夹。凡是写进文件的，就脱离了上下文长度的限制——这一条后面要反复用。

积木三，技能（Skill）。把一个固定流程写成一个文件夹：一份说明 + 若干脚本 + 参考资料。你一句话触发，它按写好的流程走，不再每次现场发挥。

积木四，专家（Expert）。给助手换一套专业视角与方法论，适合需要行业判断的活儿，比如按学术规范改论文、按期刊模板调图表。

积木五，连接器（Connector / MCP）。让它能访问外部系统：云开发、代码仓库、在线文档、邮件。连接之前先看清楚授权范围——这是边界，不是功能。

五个积木的配合关系是这样的：对话负责「这一次要干什么」，文件负责「长期记住什么」，技能负责「怎么干」，专家负责「用什么视角干」，连接器负责「能碰到哪些外部东西」。新手最常见的误区是把所有东西都塞进对话里，于是每次重来；正确做法是能落文件的绝不留在对话里。

04｜一个能用的助手，靠四根柱子撑着

身份：它是谁，服务谁。知识：它该记住什么（项目约定、你的偏好、已确认的事实）。流程：接到任务先做什么、再做什么。格式：产出长什么样。

这四根柱子，缺一根，助手就会「时好时坏」——而时好时坏，比一直不好更难受，因为你没法判断该不该信它。四样齐了，它才从「会聊天的模型」变成「能交付的工具」。

05｜项目骨架：目录就是助手的身体

my_assistant/ ├─ IDENTITY.md          角色设定：我是谁、做什么、不做什么 ├─ MEMORY.md            长期记忆：项目约定与用户偏好 ├─ prompts/             提示词模板 │  ├─ weekly.txt        周报模板 │  └─ review.txt        复盘模板 ├─ skills/              固化下来的流程 │  └─ make_report/ │     ├─ SKILL.md       流程说明 │     └─ scripts/       可选的可执行脚本 ├─ out/                 产出：每次都留痕 ├─ config.toml          真值（密钥在这里，不进仓库） └─ config.example.toml  模板（不带密钥，进仓库）

注意config.toml 与 config.example.toml 同时出现——这是第 2 期「配置外置」的直接应用：真值不进仓库，模板进仓库。工程化的习惯是连贯的，不是每一期另起炉灶。

目标：在工作区里建出这套目录。步骤：新建 my_assistant 文件夹 → 建 prompts / skills / out 三个子目录 → 新建两个空的 .md 文件。验收：命令行进到根目录，能列出上面这些条目。易错：把工作区放在桌面或下载目录里，权限与路径都容易出问题——单独建一个干净文件夹，路径不要带中文和空格。

06｜任务卡①：立身份——角色不是人设，是制度

很多人写角色是「你是一位资深的 AI 专家」——这是形容词，不是制度，模型读完该怎么干还怎么干。有用的角色设定必须回答四个问题：我是谁、我做什么、我不做什么、做成什么样。第三问最容易被跳过，也最值钱。

# IDENTITY.md —— 角色不是人设，是制度  ## 我是谁 一名人工智能技术应用专业的学习助理，服务对象是高职学生。  ## 我做什么 - 把零散的实验记录整理成结构化的周报 - 每条结论必须给出「依据来源」；找不到依据就写「未记录」  ## 我不做什么 - 不编造实验数据，不替用户下结论 - 不改动用户的原始记录文件，只写入 out/ 目录  ## 做成什么样 输出 Markdown，固定五段：本周做了什么 / 遇到什么问题 / 怎么解决的 / 下周计划 / 需要老师帮忙的地方。 四百字以内，不写空话。

目标：让助手在任何新对话里都保持同一套行为。步骤：把上面这份存成 IDENTITY.md → 新开一个对话，让它先读这个文件再干活。验收：故意问一个它没依据的问题，看它是否回答「未记录」而不是编一个。易错：只写「要做什么」不写「不做什么」——没有禁令的行为规范，等于没有规范。

07｜任务卡②：装知识——写进文件，才算记住

这是新手和熟手的分水岭。对话里的上下文是临时的：一关窗口就散，塞太满还会丢前面的内容。而写进文件的记忆是持久的、可检索的、能随项目一起版本管理的。

# MEMORY.md —— 长期记忆：写进文件，才算记住  ## 用户偏好 - 讲解说人话，公式能省则省；抽象概念先给例子再给定义 - 产出先给结论，再给依据  ## 项目约定 - 所有产出写入 out/，命名格式 YYYY-MM-DD-主题.md - 配置一律从 config.toml 读取，代码里不写死 - 依赖版本写死在 requirements.txt  ## 已确认的事实 - 实验环境：Python 3.13 + PyTorch CPU 版 - 本机无独立显卡，示例一律以 CPU 跑通为准

写法有三条讲究：区分事实与偏好（「本机无独显」是事实，「讲解说人话」是偏好）；每条都可验证（不写「大概」「可能」）；定期整理（过期的事实比没有更危险，它会让助手理直气壮地走错路）。

目标：建立一份能被反复读取的项目记忆。步骤：按「用户偏好 / 项目约定 / 已确认的事实」三段写 → 每次完成阶段性工作后追加一条。验收：新开对话，问它「我的产出文件放哪、命名格式是什么」，它能答对。易错：把记忆写成流水账——只写「下次还用得上」的部分。

08｜任务卡③：定流程——技能就是把套路固化

技能的本质一句话：把你脑子里「每次都这么干」的套路，写成一个文件夹，让机器照着走。好处有三个：不用每次重复交代；流程可以被同伴审阅和改进；同一个流程跑一百次，产出格式是一致的——这对交付至关重要。

--- name: make-report description: 把一周的实验记录整理成结构化周报。当用户提到「整理周报」「本周总结」时使用。 ---  # 周报生成流程  ## 流程 1. 读取 out/ 下本周的 raw-*.md 原始记录 2. 按 IDENTITY.md 定义的五段结构归类 3. 每条结论标注来源文件名；找不到依据的写「未记录」 4. 写入 out/YYYY-MM-DD-周报.md，并在对话里打印完整路径  ## 约束 - 不修改原始记录文件 - 不补充用户没写过的实验数据 - 四百字以内，超出部分放到附录

关键点在那个 description 字段：它决定「什么时候自动触发」。写得太宽，它到处乱触发；写得太窄，你叫不动它。经验是写清楚场景词（整理周报、本周总结）与文件类型（raw-*.md），让触发条件可判断。

目标：让一句话触发一整套流程。步骤：在 skills/ 下建 make_report 目录 → 存 SKILL.md → 对话里只说「整理周报」。验收：不读提示词、不重复交代，它也能按五段结构产出。易错：流程里写「视情况处理」这类模糊指令——凡是机器判断不了的，就在流程里写成判断条件。

09｜跑一遍：从零散记录到一份周报

# ① 把这一周的零散记录丢进 out/ #    out/raw-2026-09-21.md   今天跑通了量化，显存没爆 #    out/raw-2026-09-22.md   检索那块还是找不准，明天再试  # ② 对话里只说一句话，技能会被自动调用 "帮我把这一周的记录整理成周报"  # ③ 三看验收 #    看一：out/ 下生成了 2026-09-22-周报.md #    看二：五段齐全，每条结论后面有来源文件名 #    看三：没写到的部分标注「未记录」，而不是自己编

四步走完：立身份 → 装知识 → 定流程 → 跑一遍。最后一步千万别省：没有跑通过的助手，只是个想法；跑通一次，它才算存在。跑通之后再做一件小事——把这次的输入和产出一起存进 out/，它就是你的第一个可复现示例。

10｜翻车与自救：四件事，一件比一件常见

一，上下文塞太满。症状是它开始忘记开头说过的话。自救：重要内容一律落文件，对话里只放指针；开新窗口时让它先读 IDENTITY.md 与 MEMORY.md。

二，一本正经地编。症状是文件名、接口参数、数字看着很像真的。自救：要求每条结论标注来源；凡是涉及具体数字与路径的，让它给出可验证的位置，你自己核一遍。

三，权限没给够。症状是「无法访问」。自救：检查工作区目录是否正确、连接器是否已授权，别急着改代码。

四，路径写错。症状是文件找不到。自救：一律用相对路径，路径里不要有中文与空格——这是第 1 期就定下的规矩。

再说一层分寸感，这一层比技术更重要。三类活不该交给助手：你还没弄懂原理的活——让 AI 替你做你不会的事，你连它做错了都看不出来；后果不可逆的活——删除文件、公开发布、提交成绩，这类动作必须人工确认；需要价值判断的活——给同学的评价、给团队的结论，署名是你的，判断就得是你的。工具可以代劳执行，不能代劳责任。

本期第二句原理：助手出错，八成不是模型笨，而是你给的信息不够、不准、不成文。

11｜验收四条

换个问题也能用（不是只对示例有效）；产出格式稳定（三次运行结构一致）；说明看得懂（IDENTITY.md 与 SKILL.md 别人读完知道怎么用）；同学照做能复现（把目录打包给同伴，他按说明跑出同样的结果）。

第四条最硬，也最容易被跳过。能复现，是项目可信度的最低门槛；不能复现的成果，在答辩现场撑不过三个问题。

12｜职业素养：手脑并用与敬业乐群

这一栏是本系列的固定栏目。黄炎培先生讲「手脑并用、做学合一」，落到本期就是先做一遍，再懂一遍：你把助手搭完跑通一次，才真正明白「身份、知识、流程、格式」这八个字的分量——光看是看不会的。他还讲「敬业乐群」，落到今天就是把说明写清楚，让同伴接得上手：一个只有你自己会用的助手，在团队里等于不存在。

再说一句这个时代的特点：AI 把「会做」的门槛降低了，把「说清楚要做什么」的门槛抬高了。过去拼的是手速，现在拼的是把需求写成制度的能力——这恰恰是职业教育最该练的那一块。

13｜一分钟自测与下期

1）我能说清我的助手「能做什么、不能做什么」吗？ 2）我的 IDENTITY.md 里，有没有写「我不做什么」这一段？ 3）项目约定是写在文件里，还是每次对话重新交代？ 4）我的流程能被一句话触发吗？触发条件写清楚了吗？ 5）把目录打包给同学，他能跑出同样的结果吗？

本期一句话带走：助手的可靠性，不取决于它多聪明，取决于你给它划的边界有多清楚。 把身份、知识、流程、格式写进文件——写下来，它才存在。

下期第 4 期：WorkBuddy 进阶——技能与自动化，让这个助手学会定时干活、自己记住经验。评论区可只回：第03期打卡 + 我的助手叫什么。

— 老薛的人工智能 —把AI从黑话变成人话手脑并用，做学合一