动作加对象
取近三年中国宏观数据，做成汇报网页
经济金融 AI 智能体设计与开源 · W0401 — 40
课程总览中山大学岭南学院 · 李学恒 / 张一帆
++中山大学岭南学院 · 2026 秋
Skills 与可复用任务
经济金融 AI 智能体设计与开源 · Week 4
把说过三遍的做法，写成它用到时会去翻的文件
李学恒
中山大学岭南学院 · 微观经济与数字经济教研室
中山大学岭南学院 · 微观经济与数字经济教研室
W0409 · 29
I
PART I / VII
先回头看
三周下来，大家的感受我们都听到了。先说说听到了什么、接下来怎么调，再把前三周串成一条线。
I你们的反馈
三周下来，我们听到了什么
“讲得有点快，跟不上”“又要点东西，又要听老师讲”“一开始真的理解不了 Git 有什么用”
| 你可能正处在 | 常听到的一句话 | 最需要的 |
|---|---|---|
| 还在搭环境软件没装全，或者登录、额度卡住 | “我电脑里没有 VS Code 怎么办” | 一次补齐，一步一步来 |
| 会动手，但容易迷路跟着做，做着做着不知道在哪一步 | “命令输在上面这个框，还是下面这个？” | 一张全景图：这一步为什么做 |
| 做完了，心里没底怕做错，怕漏交 | “这样可以吗？这样呢？现在呢？” | 一份自查清单，自己能判断 |
| 时间紧，先把事办完先弄清交什么、怎么交 | “我要交作业，要交哪几样？” | 固定、清楚的提交方式 |
| 已经跑在前面想换工具，想问原理 | “会话和上下文有什么区别？” | 更深的机制，更难的挑战 |
五种状态没有高下，同一个人每周也会换一格。多数卡点出在第一次动手，卡住很正常。
学情反馈 · 8 位同学访谈 · 酷酷私聊记录
I接下来
我们都看到了，接下来一起调
老师和助教这边
- 上机带做，一步一停：每一步说清做什么、为什么、做对了会看到什么
- 每周一个当堂就能看到的成果；先保底，再进阶
- 提交方式每周固定：同一个地方，同一种格式
你这边
- 动手之前先查一遍环境：能启动
claude、有额度、找得到项目文件夹、会截图、会/export - 卡住别硬扛：截图，说清用的是 Windows 还是 Mac、做到哪一步，问酷酷或举手
- 嫌快、看晕了，直接跟酷酷说“一步一步带我”
- 基础练习做完就达标；做得快，再往进阶走
跟不上不是你一个人的事。先动手做一遍，很多名词会自己变得好懂。
课程材料
I阶段复习
前三周，串成一条线
W01搭好现场
装好 VS Code 和 Claude Code，接上模型
让 AI 碰得到你的文件→
W02把活交代清楚
六要素写任务，先出计划再动手；长期规矩写进 CLAUDE.md
→
W03留下存档
Git 提交、看差异、回退
改坏了找得回，过程有记录→
W04 · 今天把做法存下来
写成 Skill，下次直接用
做对一次，以后不用再教底下是 W02 讲过的同一个式子：Agent = LLM + Tool + Context。W01 接上模型和工具；W02 管上下文；W03 管住工具改出来的文件；今天，把好用的上下文存成文件，随用随取。
一件活的四个问题：在哪做，怎么说，改坏了怎么办，下次怎么更快。
课程材料
I阶段复习
为什么要学这几样
| 学的是 | 少了它会怎样 | 有了它 |
|---|---|---|
| 项目文件夹＋终端里的智能体 | AI 只能在网页里陪你聊，文件要你自己复制粘贴 | 它直接读写你的文件，替你跑程序 |
| 六要素＋先出计划 | 它按自己的理解猜，猜错了你来返工 | 一次交代清楚，看过计划再放行 |
CLAUDE.md | 模型不记事，每开一个新会话，规矩都要重说 | 长期规矩写成文件，每次自动读到 |
| Git | AI 一轮改好几个文件，改坏了回不去，也说不清改过什么 | 每步有存档：看得到差异，退得回去 |
| 交互记录、决策日志 | 别人看不出哪些判断是你做的 | 过程留痕，判断归你 |
这几样解决的是同一件事：AI 替你动手的时候，结果还在你手里。
课程材料
II
PART II / VII
开场
今天三件事：装一个别人的 Skill 用起来；让两个 Skill 接力做一份汇报；把你对这份汇报的要求，沉淀成自己的 Skill。
II从上周接过来
上周那一步，做了什么
1从课程仓库拷一个文件夹
skills/
frontend-design/→
2放进项目里
.claude/skills/
frontend-design/→
3输入一句
/frontend-design→
4课件换了样子字体、配色、版式都变了
关于字体、配色、版式，你一句也没交代。
拷进去的那个文件夹里，是什么？
II开场
同一句话，你说了几遍
审美那套话，有人替你写进了文件。你自己的那几句——“数字要标来源”“先出计划再动手”“只用我给的数据，不要编”——每开一个新会话，还要再说一遍。第三次还在重复交代，就该把交代写下来。
课程材料
III
PART III / VII
为什么要 Skill
做法只存在某一次对话里，会出什么事？对话、CLAUDE.md、Skill 各放什么？
III教材 7.1
只靠对话，会出三种事
一个根子：做法只存在某一次对话里。要它下次还照着做，得把做法放到对话以外、它会去读的地方。
教材第 7 章
III分工
三样东西，各管一段时间
| 放在哪里 | 什么时候读进来 | 例子 |
|---|---|---|
| 对话里说的 | 只管这一轮，说完就过去 | “这次先看 CPI” |
CLAUDE.md | 每次开会话整份读进，一直占着 | “金额统一亿元，保留两位” |
| Skill | 平时只有一行描述；用到才读正文 | “做宏观汇报”“写研报点评” |
只管这一次的，说出口；这个项目长期适用的，写
CLAUDE.md；一整套做法，写 Skill。教材第 7 章 · Claude Code 文档：Skills ↗
III一个比喻
入职手册与岗位作业指导书
CLAUDE.md 是入职手册：这个项目做什么、文件放哪、有哪些规矩，每次会话整份读进，所以要短。Skill 是岗位作业指导书：步骤、口径、检查项，轮到这项作业才拿出来。课程材料
III接第 2 周
Skill 是上下文工程的产物
第 2 周讲过两条约束：上下文有限；输入和输出都只是字符串。
平时每一轮都在
系统提示CLAUDE.md技能描述
一个一行对话留给干活的空间
一个一行对话留给干活的空间
做宏观汇报时挑中一个
系统提示CLAUDE.md技能描述对话这一个 Skill 的正文剩余空间
CLAUDE.md 每一轮都占地方，只能短；几百行的做法放不进去。
Skill 平时只放一行描述，用到才把正文拿进来。
所以 Skill 不是“存起来的提示词”，而是什么时候把哪段上下文交给它的安排。
教材第 7 章 · Claude Code 文档：Skills ↗
III边界
能写下来的，和写不下来的
能写进 Skill
- 口径：同比用哪个基数，哪个来源可以引用
- 步骤：先查什么，后查什么，查完怎么核
- 红线：哪些数不准自己填，取不到就写“未取到”
写不下来
- 手感：一张图看着哪里不对劲
- 临场取舍：这次先讲哪个指标，删掉哪一页
- 攒出来的直觉：这个数“不太像真的”
Skill 编码做法，
CLAUDE.md 和资料编码现实，判断仍然在你。教材第 7 章
IV
PART IV / VII
Skill 长什么样
一个文件夹，一个 SKILL.md，放对地方就能用。
IV教材 7.2
最小的 Skill：一个 SKILL.md
---
name: finance-brief
description: 从上市公司定期报告里做关键指标表时用。我说「看看这家的半年报」「做张指标表」……就用它。不要用于估值建模、买卖建议、同行业横向对比。
---
# 上市公司定期报告 · 关键指标表
## 交出什么 一张十行的指标表，加三句判断
## 格式规矩 单位换成亿元；每格写来源页码……
## 取哪十项 ## 表格长这样
## 交叉核对 ## 三句判断
## 交之前自己核一遍
## 不要做的事
两道 --- 之间
name 是名字，description 说它什么时候用。平时它带在身上的，就是这两行。
下面是正文
小标题可以就是第 2 周的六要素：
| 六要素 | 在这份里 |
|---|---|
| 背景与任务 | 交出什么 |
| 输入 | 取哪十项 |
| 步骤 | 交叉核对、三句判断 |
| 约束 | 格式规矩、不要做的事 |
| 输出格式 | 表格长这样 |
| 自检 | 交之前自己核一遍 |
把你每次都要说的那段话，加上一个名字和一句“什么时候用我”。
课程材料 · 教材第 7 章
IV格式与位置
四条格式规矩，放在哪
文件名必须叫
SKILL.mdname小写字母、数字、连字符，和文件夹同名
description写清做什么、什么时候用，不超过 1,024 字符
开头的 ---在第一行，前面不能有空行
| 项目级：跟着项目走，可以发给组员 | 个人级：本机所有项目都能用 | |
|---|---|---|
| Claude Code | 项目/.claude/skills/html-slides/SKILL.md | ~/.claude/skills/Windows： C:\Users\用户名\.claude\skills\ |
| Codex | 项目/.agents/skills/html-slides/SKILL.md | ~/.agents/skills/ |
Codex 早期用 .codex/skills、~/.codex/skills，目前仍能读取；官方文档已改为 .agents/skills（2026-09-27 查证）。以点开头的文件夹默认隐藏；第一次建好 skills 文件夹后，退出 Claude Code 或 Codex 再重开。
课程仓库
sysu-awesome-cc 的 skills/ 下，每个文件夹就是一个 Skill，拷哪个进来就装哪个。IV调用
两种用法：它自己想起来，或者你点名
它自己想起来
把 素材/ 里的两份资料做成一份网页演示
你照常说话。它读每个 Skill 的描述，判断这件活归谁；用上时，界面上会出现一行调用记录。
你点名
/html-slides 在最后加一页小结输入 /技能名（Codex 用 $技能名），不管你的话里有没有它认得的词，都用这个 Skill。
看装了哪些：输入
/skills，或者直接问它“你有哪些技能可用”。描述决定它来不来；想不起来，就点名。
V
PART V / VII
看实物
打开别人写的两个 Skill，看里面写了什么。
V现场演示
web-research：现场跑一次
name: web-research
description: Searches multiple web sources, synthesizes findings, and produces cited research reports using delegated subagents. Use when the user asks to research a topic online, …
多方搜索、综合发现、写成带引用的调研报告，由它派出的子智能体分头查。用户要上网调研、查最新信息、比较几种选择时用。
现场的问题国内能免费获取月度 CPI 的数据源有哪些，各自发布滞后多久？只拆 2 个子课题，每个最多搜 3 次。
1
先写研究计划
建一个研究文件夹，把问题拆成 2–5 个不重叠的子课题，写进 research_plan.md
2
分头查
每个子课题派一个子智能体，每个最多搜 3–5 次，结果各存一个 findings_*.md
3
汇总成报告
读完所有发现文件，写成带引用的报告
一个
SKILL.md，77 行，没有一行代码。发出去以后回来看：它写出的计划文件和发现文件。课程仓库 sysu-awesome-cc/skills ↗ ·
web-research/SKILL.mdV回看上周
frontend-design：上周那个，里面写了什么
## Ground your designs in the subject matter
If the brief does not identify what the product or subject
matter is, identify it yourself before designing …
Choose your typefaces deliberately, not the default families …
Avoid these default typographic treatments:
- Accenting just a single word or phrase in a headline …
- Using all caps for labels.
Use non-user-triggered motion sparingly …
- 先弄清题材，再定视觉方向
- 字体、配色不用谁都会用的默认
- 列出一眼就像“生成出来的”做法：标题只强调一个词、全大写标签、到处淡入
- 要给出有辨识度的方案
71 行，全是审美要求，没有代码，也是 Skill。上周你一句没交代，它照着这份文件做了。
课程仓库 sysu-awesome-cc/skills ↗ ·
frontend-design/SKILL.mdV四级形态
更大的 Skill，和装之前先读一遍
除了 SKILL.md，还可以带 references/（要查的资料）、scripts/（要跑的程序）、assets/（要套的模板），正文里写“做到哪一步去读哪份”。仓库里的 html-slides、macro-data 都是这样。
装别人的 Skill，先读一遍
- 谁写的，从哪里来
- 要不要另装程序、要不要密钥：
macro-data第一次调用时，会引导智能体检查并安装环境——先让它讲清要装什么 - 有没有留着别人的痕迹：作者的本机路径、只在作者电脑上成立的约定
放到你的电脑上，让它按你的机器改；签字的是你。
课程材料 · Claude Code 文档：Skills ↗
VI
PART VI / VII
它怎么被想起来
一句描述，决定它来不来。
VI教材 7.3
渐进式披露：像在书架上找书
书架上摆三十本，常驻的也只是三十条书脊（每条约 100 token）。现场问一句：开新会话问“不打开任何文件，你现在知道 web-research 的哪些信息？”——它答得出的，就是书脊那一层。
教材第 7 章 · Agent Skills 规范 ↗
VI书架的长度
装多了会怎样
- 书脊常驻，所以书架不是无限长
- Claude Code 给技能清单的预算，约为上下文窗口的 1%；超了，先截短用得最少的那些描述
- 输入
/doctor可以看到清单占了多少
描述写短，关键用途放最前面；用不上的 Skill 移出去。
VI三条写法
描述怎么写
反例
文档助手处理数据什么活都像归它，又都不像写上你会怎么说
“看看近几年中国宏观数据，做个汇报”
写明不做什么
不用于只查一个数，不给投资建议
真实例子 · 可比公司分析 Skill 的描述，列了五种“不太适合”
没有可比上市公司的私营企业高度多元化的综合集团陷入困境或破产的公司尚无收入的初创公司商业模式独特的公司
description 在清单里会被截短，关键用途放最前面。
教材第 7 章 · Claude Code 文档：Skills ↗ · comps-analysis 的 description（原文 Not ideal for）
VI触发
两种毛病：想不起来，和抢着来
| 想不起来（触发不足） | 抢着来（触发过度） | |
|---|---|---|
| 表现 | 该它的活，它没来 | 不该它的活，它也来了 |
| 原因 | 描述太窄或太虚，没有你会说的话 | 描述太宽，没写不做什么 |
| 怎么改 | 把你平时的说法补进描述 | 补一句“不用于……” |
改描述时，直接问它：“你什么时候会用这个技能？”听它怎么复述。有副作用的流程可以设成只许点名调用（
disable-model-invocation: true），本课不用。教材第 7 章 · Claude Code 文档：Skills ↗
VI验收
装了不等于用了：怎么验
- 看界面：有没有调用技能的那一行
- 问它：“你按哪个技能的第几步做的？”
- 三句测试：两句该来的、一句不该来的，各在新会话里试一次
还有一个坑：项目里已有一份做好的成品，它可能直接照抄旧文件。测的时候换一个时间窗口、输出到新文件夹。
教材第 7 章 · Claude Code 文档：Skills ↗
VII
PART VII / VII
造一个 Skill
三条路造一个 Skill：你给得越少，验得越多。
VII三条路径
三条路，各给什么
路径一 事后沉淀
你给
带它一步步把一件活做对
它做
把刚才的经验写成 Skill
适合
你会做、但每次都要交代的活
本课
练习三
路径二 事前设计
你给
目标、做法、Skill 有哪些部件和流程
它做
按你的设计创建 Skill
适合
流程你心里有数、还没让它做过
本课
skill-creator 四句话交底
路径三 只给目标
你给
一类任务的目标
它做
上网调研、测试，自己定流程和工具
适合
你也不知道最好怎么做的活
本课
老师演示：macro-data
三条路都要测。路径越往后，人写得越少，验收越重。
教材第 7 章
VII路径一 · 优先推荐
路径一：先做对，再沉淀
图中 Git 提交是可选的版本管理方式，本周不交 Git 截图。沉淀时请
skill-creator 把对话里的意见归纳进步骤、口径和自检清单，不写死这次的数；先给我看草稿。教材第 7 章
VII路径二
路径二：先设计，再让它写
开工前讲清三件事
- 想做什么
- 准备怎样做
- 这个 Skill 包含哪些部件和流程
用 skill-creator（造 Skill 的 Skill）最顺手：它先访谈你、出方案，你确认才落盘。它在课程仓库 skills/skill-creator/；Codex 自带 $skill-creator，用时写明“放到本项目的 .agents/skills/”。
四句话交底
用 skill-creator 帮我造一个技能。① 做什么活：……
② 我现在怎么做：……
③ 交出来什么：……
④ 最容易出错在哪：……
请先访谈我，给方案再写文件。description 写清做什么、我会怎么开口、什么时候不用。不要跑评测。
skill-creator 自带评测流程，跑起来很久；本课写明“不要跑评测”。教材第 7 章 · 课程仓库 sysu-awesome-cc/skills ↗ · Codex 文档：Build skills ↗
VII路径三
路径三：只给目标，让它自己找路
你给一类任务的目标，加一条做法要求：逐个实测，每个写报告。
上网调研现有
工具和方案→写成这类任务
的流程→逐个
跑测试→按方案和踩坑结果
打包成 Skill→端到端
再测一遍
工具和方案→写成这类任务
的流程→逐个
跑测试→按方案和踩坑结果
打包成 Skill→端到端
再测一遍
方向
有没有现成的开源封装？
验收
看完测试报告，再决定做不做
纠错
它做错了，让它改
你管三个关口。人写得最少，所以验收最重。
课程材料
VII路径三 · 只给目标，让它自己去试
我只说了四句话：macro-data 是怎么来的
约 1 小时建成
10 个子智能体
10 份实测报告
6/6 项验收全过
我说的话
①“调研一下，现在 2026 年 9 月，有什么 agent 可方便调用的、相对可靠的宏观或财经数据源？”
②“按你收集的所有数据源，逐一派子智能体做数据拉取测试，分别写一个测试报告。”
③“难道网上就没有 GitHub 开源项目或者 skill 专门做了封装吗？”
没说话，
等它交卷
等它交卷
④“好的，做一个 skill”
“把这个 skill 也安装给 Claude Code”
“你明显还是违反了不建 venv……”
提目标
要求实测
看报告
做成 Skill
建成之后
它做了什么
先搜一圈，列出 FRED、DBnomics 等候选
分两波派出 10 个子智能体，各自真拉一次数据、写一份报告
汇总报告，给每类数据选好源
写成 SKILL.md，验收 6/6，新坑当场补进
装到 Claude Code，改用 conda，打包发给同事
踩过的坑
实测时发现国家统计局 3 月改版，旧教程全失效，新接口是子智能体摸通的
建 Skill 时撞上统计局搜索一次要 10 条以上，服务器就返回异常页
实测时发现AKShare 的 CPI 月度接口滞后约一年，查最新的要换源
成品
macro-data/
├─ SKILL.md走哪个源、怎么调、坑
├─ references/common-series.md常用序列 ID
└─ scripts/nbs_fetch.py统计局取数
Skill 里最值钱的是踩过的坑，这些坑是它自己跑出来的，模型训练数据里没有。
来源：Hermes Agent 对话记录（2026-09-21）、10 份实测报告、macro-data 的 SKILL.md
VII任务卡 · 练习一
练习一：从 GitHub 装 html-slides，做一份网页演示
练习一三个练习都要完成。仓库：github.com/ai-lingnan/sysu-awesome-cc ↗
装
1打开课程仓库，进
skills/2绿色 Code 按钮 → Download ZIP
3解压（Windows 右键“全部解压缩”）
4把
html-slides 整个文件夹拖进项目的 .claude/skills/5退出，重开 Claude Code
用
6
/skills 里看得到 html-slides7自然说一句：把素材做成 6 页网页演示
8
/html-slides 点名，再加一页9打开
SKILL.md，认出 name、description、正文找不到 .claude？以点开头的文件夹默认隐藏，在 VS Code 文件栏里操作最方便
怎样算重开？连按两次 Ctrl+C 退出，再输入
claude，就是一个新会话只做 HTML，不配图、不截图审阅、不导出 PDF；本练习交演示文稿与交互记录，已有课堂版本可用。
课程仓库 sysu-awesome-cc/skills ↗ · 详细步骤见上机手册
VII任务卡 · 练习二
练习二：两个 Skill 接力，做一份宏观基本面汇报
练习二做完练习一再做。题目：当前中国宏观基本面：近三年指标走势与我的判断
- 新项目，装
macro-data与html-slides，退出重开 - 先让它读
macro-data，讲清要装什么，等你确认；第一次调用时 Skill 会引导智能体检查并安装环境 - 取数：至少四个指标，覆盖增长、价格、景气、金融中三类以上；先看最新一期是哪个月
- 先写事实，再写你的判断，让它帮你找支撑与反例
- 用
html-slides出 8–10 页 - 自查；练习二版本另存，导出交互记录
三条硬要求
每个数字逐条留痕数据逐行带获取时间、机构、原发布链接、标题与日期；二手接口加接口名
每条判断下面挂依据哪个指标、哪几期、数值多少
事实与判断分开标注不写投资建议，不预测具体数值
交练习三修改之前的演示文稿、取数记录与交互记录；取不到数可用备用 CSV，写明来源，不补造。
课程仓库 sysu-awesome-cc/skills ↗ · 详细步骤见上机手册
VII任务卡 · 练习三
练习三：一轮轮改，再沉淀成你的 Skill
练习三做完练习二再做。这是路径一的实践。
A多轮反馈
从指标、口径、图表、结论表述、版式五方面提具体意见，至少两轮；每轮意见在对话里说清，改完复看；改过的演示文稿另存，不覆盖练习二那份
B用 skill-creator 沉淀
从课程仓库装 skill-creator（Codex 自带）；结合 macro-data 取数、html-slides 出页和你的每轮反馈；反馈归纳进步骤、口径、自检清单；不写死这次的数；放进 .claude/skills/（Codex 放 .agents/skills/）；先看草稿，不跑评测
C新会话里测
两句该来、一句不该来；换一个时间窗口或指标组合再做一次，输出到新文件夹；过程与结果留在交互记录里
D整理交付
新 Skill 文件夹打成 ZIP；改过的演示文稿另存为 HTML（有外部文件则打 ZIP）；交互记录按会话逐份导出
反馈与触发测试在交互记录里体现；不用另交反馈记录、触发测试记录或 Git 截图。
课程仓库 sysu-awesome-cc/skills ↗ · 详细步骤与沉淀指令全文见上机手册
VII复盘
复盘：三层各念一遍
练习一
Skill 放在哪一串路径下；自然说的那句话是什么；description 说它什么时候用
练习二
挑一条“我的判断”，指出它的依据和数据来源
练习三
读两条反馈，指出它们进了新 Skill 的哪一步；三句测试，来没来
两句重申：描述决定它来不来，想不起来就点名；装别人的 Skill 先读一遍，签字的是你。
课程材料
三句话带走
先把一次任务做对，
再把做对的方法写成 Skill
CLAUDE.md 是入职手册，Skill 是岗位作业指导书书架上常驻的是书脊，用到才翻开正文