中山大学岭南学院 · 金融 AI 智能体设计与应用 · 学员实操页第 5 次课 · 10 月 14 日
第 5 次课 · 学员实操页

一篇研究文稿,一条线走到底

整个下午写一篇研究文稿,一万字以内,题目自己定。
练习一和练习二是同一条线的前后两半。练习一收资料、写大纲,挑出资料里的缺口;听完浏览器那一段,装上 Playwright MCP;练习二用浏览器把缺口补上,再写报告、评审、定稿。每一步都接着上一步交出的文件往下做。
晚上整晚是小组进度汇报。
第 5 次课 · 材料包一个现成的研究文稿项目文件夹(编排技能、三个子代理、大纲模板、人工审阅记录、诺奖官方资料),Playwright MCP 的安装说明与离线包。解压后先看根目录的 00_先看这里.md 下载 ⬇
  1. 练习一 · 第一段1 收资料,写大纲资料员收资料,主会话据资料写大纲
  2. 练习一 · 第二段2 关卡一你改大纲,挑出要补的缺口
  3. 回到投屏听第四部分资料够不着,就开浏览器去取
  4. 课上一起装3 装浏览器装上 Playwright MCP,回到刚才的会话
  5. 练习二 · 第一段4 补资料用浏览器去公众号,把缺口补上
  6. 练习二 · 第二段5 写完定稿撰稿、评审、关卡二、改一轮
投屏上的提示词,这里都能复制 每段都标了课件第几页,和投屏上是同一段,点「复制」就能用。【】里换成你自己的,没有【】的原样发。出处怎么标、文件放哪、在哪停,项目的 CLAUDE.md 和 research-pipeline 技能里已经写了,你自己写提示词时不用再抄一遍。

开工前 · 放好项目文件夹,确认它认得

解压材料包,把 01_研究文稿项目 整个拷到你自己的工作目录,在这个文件夹里启动 Claude Code。不在这个文件夹里启动,它就找不到里面的技能和子代理。

文件或文件夹是什么谁来写
CLAUDE.md项目规矩:谁写哪个文件、两道关卡、出处怎么标、一万字以内写好了
.claude/skills/research-pipeline/编排:收资料、写大纲、撰稿、评审、改一轮定稿,每段派谁、交什么文件、在哪停写好了
.claude/agents/三个子代理:资料员、撰稿人、审稿人。审稿人和撰稿人是两个独立的角色写好了
备选题目.md四个备选题,附资料入口和公众号搜索词写好了
模板/大纲模板.md研究大纲长什么样:每个问题要写清手上有哪几份资料、还缺什么写好了
资料/官方资料/2026 诺贝尔经济学奖的新闻稿、科普背景、科学背景,英文原文写好了
资料/收集/、缺口清单.md资料员收来的资料,取不到的记在缺口清单第 1 步,资料员
大纲.md据资料写出的研究大纲第 1 步主会话写,第 2 步你改
资料/公众号/用浏览器从公众号取来的 3 篇第 4 步,主会话按你的提示词取
稿件/初稿、审稿意见、修改稿、终稿第 5 步,撰稿人、审稿人、主会话
人工审阅记录.md两道关卡上你改了什么、为什么,要补的缺口,你自己的三条评审意见只由你写
不要读任何文件,也不要派子代理。只根据你现在上下文里已有的信息回答。1)你能派哪些子代理?把 collector、writer、reviewer 的描述原样抄出来,包括名字、描述和工具清单。2)你的上下文里有没有资料员.md 分隔线以下的正文?有就抄第一句,没有就说没有。
抄不出三个角色 多半是没在项目文件夹里启动,或者会话是在拷文件之前开的。退出,cd 到 01_研究文稿项目 再启动。

选做 · 看派出去的资料员手里有什么

这两段会真的派子代理,各花一两分钟。课上来不及就课后做,做完再开始第 1 步也行。

派一个 collector 子代理,但这次不要它收资料。便条里只让它回答下面四个问题,然后原样把它的回答转给我,再把你写给它的便条原文也给我:
1)你的系统提示(最开头的说明)第一句话是什么?
2)你的上下文里有没有一份标题为『研究文稿项目』的 CLAUDE.md?如果有,抄出它的第一句。
3)除了这一份,还有没有别的 CLAUDE.md(比如用户目录下的)?只回答有或没有、有几份,不要抄内容。
4)你看得到主会话之前和用户的对话吗?
派一个 collector 子代理,但这次不要它收资料。便条里只让它回答一个问题:把你的系统提示最开头的三句话原样抄出来(英文就抄英文,中文就抄中文,不要翻译、不要概括)。然后原样把它的回答转给我,再把你写给它的便条原文也给我。
题目 和经济金融有关、找得到公开资料就行。五分钟定不下就从 备选题目.md 里挑:2026 诺贝尔经济学奖(Hall 与 Woodford)、AI 经济学、AI 数字员工进金融业。只用公开资料,不写买卖建议。

第 1 步 · 练习一第一段 · 收资料,写研究大纲

接上一步题目、写给谁,你心里最想弄清的一两个问题
交给下一步资料/收集/、资料/缺口清单.md、大纲.md
我要写一篇研究文稿。
题目:【你的题目】
写给:【读者,比如金融硕士同学】
我最想弄清的:【一两个问题;没想好就写「你据资料提三个」】
照研究文稿流水线开始,先收资料,再据资料写研究大纲。

发出去就可以休息,让它在后台跑。大纲要落在资料上,资料撑不起来的问题,下一步换掉。

第 2 步 · 练习一第二段 · 关卡一,挑出要补的缺口

接上一步大纲.md、资料/缺口清单.md
交给下一步改过的大纲;人工审阅记录.md 的关卡一,写着要去公众号补哪几条缺口
  1. 打开 大纲.md,对着 资料/ 和缺口清单看那三个问题
  2. 直接改文件,或者在对话里告诉它怎么改
  3. 改了哪里、为什么,写进 人工审阅记录.md 的关卡一。再从缺口清单里挑出要去公众号补的一两条,记在下面。比如缺国内反响,就记下中文报道会用的说法当搜索词
  4. 回它一句下面这段话
大纲改好了,先别写,等我补资料。
「接着写」三个字留到第 5 步 补完资料再说。它没等你说就开写了,说明关卡没守住,按 Esc 打断,跟它说回到关卡一。
练习一做到这里。回到投屏,听第四部分:资料够不着,就开浏览器去取。
缺口清单里那些取不到的,下面三步来补。

第 3 步 · 装浏览器 · 给它装上手

接上一步缺口清单里那几条直接取不到的,比如只在公众号里的
交给下一步一个能开浏览器的 Claude Code,还是刚才那段对话

Playwright MCP 让 Claude Code 能开浏览器、点页面,约 19 MB,不会另外下载浏览器,默认用你电脑上的 Chrome。第 4 次课后已经装好的,在项目会话里敲 /mcp 看见 playwright,直接做这一步最后的自检。

另开一个终端装

项目那个会话只做这篇文稿,别在里面装。另开一个终端窗口,在任意文件夹里装。

npm install -g @playwright/mcp
claude mcp add playwright -s user -- playwright-mcp

电脑上没有 Chrome、只有 Edge 的,第二条末尾加 --browser msedge。npm 慢或者报网络错误,第一条末尾加 --registry=https://registry.npmmirror.com。

帮我装 Playwright MCP,每一步做完把输出给我看:
1. 跑 node --version,低于 18 就停下告诉我
2. 跑 npm install -g @playwright/mcp
   慢的话加 --registry=https://registry.npmmirror.com
3. 跑 claude mcp add playwright -s user -- playwright-mcp
   我电脑上没有 Chrome 的话,末尾加 --browser msedge
4. 跑 claude mcp list,确认 playwright 已连接
不要用 npx,不要加 --browser chromium。
做完提醒我退出重开。
-s user 不能省 不加的话只在你运行命令的那个文件夹里生效,回到项目文件夹就没了。

回到项目会话,接着刚才那段对话

  1. 在项目会话里输入 /exit
  2. 还在 01_研究文稿项目 里,输入 claude -c,接回刚才那段对话。VS Code 插件从历史会话里点回刚才那一个
  3. 敲 /mcp,列表里有 playwright
用浏览器打开 https://weixin.sogou.com/ ,告诉我页面标题,别的先不做。
它点哪你都看得见 浏览器窗口是弹出来的,它打开哪页、点哪里、填什么,全程在窗口里看得到,不是在后台悄悄跑。窗口可能被 VS Code 或终端挡在后面,去任务栏找。它在操作时你别在窗口里点,验证码那种要你过的,它会停下来叫你。
接不上刚才的对话也不怕 进度都在文件里。新开一个会话,发下面这段,它读完文件就知道走到哪了。
我们在走研究文稿流水线,关卡一已经过了:大纲.md 我改过,人工审阅记录.md 写了关卡一。先读这两个文件和 资料/缺口清单.md,告诉我现在到了哪一段。先别写报告,我要先用浏览器补资料。

用哪个浏览器

你的情况注册时怎么写要不要另下东西
电脑上有 Chrome什么都不加不用
只有 Edge(Win11 自带)末尾加 --browser msedge不用
想用 Firefox 或 Safari 内核--browser firefox 或 webkit要另下浏览器内核,课上别用
接已经开着的浏览器--cdp-endpoint,或装扩展用 --extension它会碰到那个浏览器里所有的登录,课上别用

默认情况下它自己开一个独立的浏览器窗口,登录信息存在它自己的文件夹里,跟你平时用的浏览器分开。不要写 --browser chromium,那会去下载一整个浏览器内核。

装不上

npm 源不通的,用材料包 03_Playwright-MCP离线包/ 里那份 zip,约 4 MB,不需要联网也不需要 npm,做法见 02_装 Playwright MCP/安装与排错.md 第二节。还装不上的,第 4 步跟着投屏看,第 5 步照样做,缺口在文稿里写明「资料未覆盖」。

第 4 步 · 练习二第一段 · 用浏览器把缺口补上

接上一步人工审阅记录关卡一里挑出的缺口和搜索词;能开浏览器的会话
交给下一步资料/公众号/ 下 3 篇,更新过的缺口清单
用浏览器打开 https://weixin.sogou.com/ ,
搜「2026 诺贝尔经济学奖」,点「搜文章」,取前 3 条。
先把标题、公众号、时间列给我看,再逐篇点开,
读标题、公众号、发布时间和正文。
每篇存成一个 Markdown 放进 资料/公众号/,
开头写标题、公众号、发布时间、文章链接、取得日期。
正文照原文抄,不改写、不总结。
带 timestamp 的链接会过期,能取到永久链接就记永久链接。
遇到验证码或要登录,马上停下告诉我。
存完更新 资料/缺口清单.md。

题目不是诺奖的,用下面这段。和上面是同一段话,只多了一行缺口,取前 3 条改成挑 3 篇对得上缺口的。

用浏览器打开 https://weixin.sogou.com/ ,
搜「【你的搜索词】」,点「搜文章」。
我要补的缺口:【从缺口清单里挑的一两条】。从第一页结果里挑 3 篇最对得上缺口的。
先把标题、公众号、时间列给我看,再逐篇点开,
读标题、公众号、发布时间和正文。
每篇存成一个 Markdown 放进 资料/公众号/,
开头写标题、公众号、发布时间、文章链接、取得日期。
正文照原文抄,不改写、不总结。
带 timestamp 的链接会过期,能取到永久链接就记永久链接。
遇到验证码或要登录,马上停下告诉我。
存完更新 资料/缺口清单.md,告诉我哪几条缺口补上了。
弹出验证码 全班同时搜,搜狗可能要你验证。它会停下等你,你在弹出来的浏览器窗口里自己完成验证,再跟它说「继续」。不要让它想办法绕过去。
进资料夹之前,你先看一眼 撰稿人、审稿人都会把资料夹里的东西当真。几篇说法打架的,按原文核;它说取完了,对一下页面上的条数。

第 5 步 · 练习二第二段 · 写报告,评审,关卡二,定稿

接上一步改过的大纲,资料/ 下全部资料,包括刚补的公众号
交给下一步稿件/终稿.md,人工审阅记录两道关卡都写了
资料补完了,接着写。
  1. 它派撰稿人照大纲写初稿,再派一个独立的审稿人评审,然后停在关卡二
  2. 读 稿件/初稿.md 和 稿件/审稿意见.md,抽查至少三处出处,打开资料文件看原文是不是这么说的
  3. 在 人工审阅记录.md 写关卡二:抽查结果,加上你自己的三条评审意见,审稿人没提到的,或者你不同意它的
  4. 回它一句下面这段话。撰稿人按审稿意见和你的三条改一轮,主会话定稿
关卡二写好了,在 人工审阅记录.md 里,接着改。
三条意见写进文件 光在对话里说不算。改稿的撰稿人是子代理,看不到你和主会话聊了什么,只读得到文件。
审稿人也会错 上次问卷里 23 人有 11 人没核就信了审阅员。它挑出来的问题,先自己翻资料核一下;你的三条意见,得是自己读过资料写出来的。课上跑不完的课后接着跑,晚上是汇报。

排错

现象多半是怎么办
开工前问它,它说不全三个子代理不是在项目文件夹里启动的,或会话开在拷文件之前退出,cd 到 01_研究文稿项目 再启动,确认里面有 .claude/
它自己闷头搜,没派资料员没认出子代理点名:派 collector(资料员)去收资料
大纲写完没停,或者你一说大纲改好了它就开写关卡没守住按 Esc 打断,跟它说「回到关卡一,大纲我还没审」。再不行就点名:照 research-pipeline 技能走
资料员说网页返回 403、要登录那个网站不让直接取正常,记进缺口清单。第 4 步用浏览器去取,要登录的不碰
/mcp 里没有 playwright装完没退出重开,或注册时漏了 -s user退出,claude -c 接回;还没有就 claude mcp remove playwright -s user 后重新加
重开后它不记得做到哪了新开了一段对话,没接回刚才那段退出再 claude -c;还不行就发第 3 步那段「接不上时」的话
加 playwright 时提示已存在以前装过一次先 claude mcp remove playwright -s user,再重新加
报 Chromium distribution 'chrome' is not found电脑上没装 Chrome注册命令末尾加 --browser msedge
每次开新会话都卡好几秒注册时用了 npx …@latest改成全局安装,见第 3 步办法一
搜狗弹验证码、提示访问过于频繁同一个网络出口搜的人太多在浏览器窗口里自己验证,再说「继续」。实在过不去,换个搜索词或等几分钟
永久链接写的是「未取到」有的文章页没给永久链接可以接受,正文已经存在本地。别用地址栏里带 timestamp 的临时链接顶上
存下来的公众号正文变成了摘要它从页面快照里抄,顺手改写了跟它说照原文重存,可以在页面上执行一小段脚本读 #js_content 的文字
让 AI 读 PDF,它说 password-protected这套配置读 PDF 会误报用同名的 .md;没有的记进缺口清单
撰稿人写到一半停了,初稿不完整一次输出太长跟它说让撰稿人接着写,一节一节存
它说文稿超了一万字字数是它估的,常常估错让它照 research-pipeline 技能里那行命令数一遍;真超了,把压到多少字写进你的三条意见
评审完没停,直接按审稿意见改了关卡二没守住按 Esc 打断,跟它说「回到关卡二,我要先写自己的三条意见」
写 .claude/ 下的文件时停下来问要不要允许.claude/ 算配置目录,开着自动接受也会单独问正常,看清是哪个文件再点允许

课后 · 按日期排

时点做什么
本周内没跑完的接着跑到终稿,两道关卡都要过
本周内用 skill-creator 把第 4 步取公众号那段封装成技能,放进项目的 .claude/skills/。【】里的搜索词和缺口留给技能开口问你,其余写进技能。新开会话说一句「从公众号补几篇」试一次
本周内用浏览器把自己组的网页点一遍主要功能,截图,问题列成表,分成「这次必须改」和「可以以后再说」两类
下次课前想两个个人作业二的题目方向(行研报告或技术分享,二选一),今天这条线就是行研报告的骨架。下次课晚上有选题答疑
11 月 10 日 23:59 前终期材料交平台:报告 PDF、展示页 zip、会话记录 zip
刷课、替课是红线 浏览器能替你点很多重复的活,但让 AI 挂着替你看网课,是教育部等五部门教高〔2022〕1 号文件点名严禁的「刷课」「替课」,查实取消课程成绩,情节重的可以开除学籍。