经济金融 AI 智能体设计与开源 · W0401 — 35
课程总览中山大学岭南学院 · 李学恒 / 张一帆
++
中山大学岭南学院 · 2026 秋

Skills 与可复用任务

经济金融 AI 智能体设计与开源 · Week 4
把说过三遍的做法，写成它用到时会去翻的文件
李学恒
中山大学岭南学院 · 微观经济与数字经济教研室
课程网站ai.lingnan.top ↗Skill 仓库sysu-awesome-cc ↗
W0409 · 29
PART I / VI

开场

今天三件事：装一个别人的 Skill 用起来；让两个 Skill 接力做一份汇报；把你对这份汇报的要求，沉淀成自己的 Skill。
I从上周接过来

上周那一步，做了什么

1从课程仓库拷一个文件夹skills/
frontend-design/
→
2放进项目里.claude/skills/
frontend-design/
→
3输入一句/frontend-design
→
4课件换了样子字体、配色、版式都变了
关于字体、配色、版式，你一句也没交代。
拷进去的那个文件夹里，是什么？
课程材料 · 课程仓库 sysu-awesome-cc/skills ↗
I开场

同一句话，你说了几遍

周一到周五，同一个人每天对智能体重复三句话：数字要标来源、用三线表、先出计划我确认再动手；到周五累倒在桌上
审美那套话，有人替你写进了文件。你自己的那几句——“数字要标来源”“先出计划再动手”“只用我给的数据，不要编”——每开一个新会话，还要再说一遍。第三次还在重复交代，就该把交代写下来。
课程材料
PART II / VI

为什么要 Skill

做法只存在某一次对话里，会出什么事？对话、CLAUDE.md、Skill 各放什么？
II教材 7.1

只靠对话，会出三种事

三格并列：要求漂移（这次说了保留两位小数，下次忘了）、经验散落（调好的说法埋在聊天记录里）、协作失准（五个人五种写法），三格汇到一句：做法只存在某一次对话里
一个根子：做法只存在某一次对话里。要它下次还照着做，得把做法放到对话以外、它会去读的地方。
教材第 7 章
II分工

三样东西，各管一段时间

放在哪里什么时候读进来例子
对话里说的只管这一轮，说完就过去“这次先看 CPI”
CLAUDE.md每次开会话整份读进，一直占着“金额统一亿元，保留两位”
Skill平时只有一行描述；用到才读正文“做宏观汇报”“写研报点评”
三个文件盘：CLAUDE.md 每次都读，技能用到才翻开，对话说完就扔
只管这一次的，说出口；这个项目长期适用的，写 CLAUDE.md；一整套做法，写 Skill。
教材第 7 章 · Claude Code 文档：Skills ↗
II一个比喻

入职手册与岗位作业指导书

左：新员工桌上摊开入职手册，每天都用，放在手边，这是 CLAUDE.md；右：文件柜里五本作业指导书（宏观汇报、研报点评、数据清洗、网页演示、会议纪要），抽出宏观汇报那本，轮到这项活才拿出来，这是 Skill
CLAUDE.md 是入职手册：这个项目做什么、文件放哪、有哪些规矩，每次会话整份读进，所以要短。Skill 是岗位作业指导书：步骤、口径、检查项，轮到这项作业才拿出来。
课程材料
II接第 2 周

Skill 是上下文工程的产物

第 2 周讲过两条约束：上下文有限；输入和输出都只是字符串。
平时每一轮都在
系统提示CLAUDE.md技能描述
一个一行对话留给干活的空间
做宏观汇报时挑中一个
系统提示CLAUDE.md技能描述对话这一个 Skill 的正文剩余空间

CLAUDE.md 每一轮都占地方，只能短；几百行的做法放不进去。

Skill 平时只放一行描述，用到才把正文拿进来。

所以 Skill 不是“存起来的提示词”，而是什么时候把哪段上下文交给它的安排。
教材第 7 章 · Claude Code 文档：Skills ↗
II边界

能写下来的，和写不下来的

能写进 Skill

  • 口径：同比用哪个基数，哪个来源可以引用
  • 步骤：先查什么，后查什么，查完怎么核
  • 红线：哪些数不准自己填，取不到就写“未取到”

写不下来

  • 手感：一张图看着哪里不对劲
  • 临场取舍：这次先讲哪个指标，删掉哪一页
  • 攒出来的直觉：这个数“不太像真的”
Skill 编码做法，CLAUDE.md 和资料编码现实，判断仍然在你。
教材第 7 章
PART III / VI

Skill 长什么样

一个文件夹，一个 SKILL.md，放对地方就能用。
III教材 7.2

最小的 Skill：一个 SKILL.md

--- name: finance-brief description: 从上市公司定期报告里做关键指标表时用。我说「看看这家的半年报」「做张指标表」……就用它。不要用于估值建模、买卖建议、同行业横向对比。 --- # 上市公司定期报告 · 关键指标表 ## 交出什么　一张十行的指标表，加三句判断 ## 格式规矩　单位换成亿元；每格写来源页码…… ## 取哪十项　## 表格长这样 ## 交叉核对　## 三句判断 ## 交之前自己核一遍 ## 不要做的事
两道 --- 之间

name 是名字，description 说它什么时候用。平时它带在身上的，就是这两行。

下面是正文

小标题可以就是第 2 周的六要素：

六要素在这份里
背景与任务交出什么
输入取哪十项
步骤交叉核对、三句判断
约束格式规矩、不要做的事
输出格式表格长这样
自检交之前自己核一遍
把你每次都要说的那段话，加上一个名字和一句“什么时候用我”。
课程材料 · 教材第 7 章
III格式与位置

四条格式规矩，放在哪

文件名必须叫 SKILL.md
name小写字母、数字、连字符，和文件夹同名
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，拷哪个进来就装哪个。
Claude Code 文档：Skills ↗ · Codex 文档：Build skills ↗ · Agent Skills 规范 ↗
III调用

两种用法：它自己想起来，或者你点名

它自己想起来

把 素材/ 里的两份资料做成一份网页演示

你照常说话。它读每个 Skill 的描述，判断这件活归谁；用上时，界面上会出现一行调用记录。

你点名

/html-slides 在最后加一页小结

输入 /技能名（Codex 用 $技能名），不管你的话里有没有它认得的词，都用这个 Skill。

看装了哪些：输入 /skills，或者直接问它“你有哪些技能可用”。
描述决定它来不来；想不起来，就点名。
Claude Code 文档：Skills ↗ · Codex 文档：Build skills ↗
PART IV / VI

看实物

打开别人写的两个 Skill，看里面写了什么。
IV现场演示

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.md
IV回看上周

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.md
IV四级形态

更大的 Skill，和装之前先读一遍

技能文件夹：SKILL.md 必需；scripts/ 跑的、references/ 查的、assets/ 套的；SKILL.md 上半是书脊（name、description），下半是正文（挑中才读）

除了 SKILL.md，还可以带 references/（要查的资料）、scripts/（要跑的程序）、assets/（要套的模板），正文里写“做到哪一步去读哪份”。仓库里的 html-slides、macro-data 都是这样。

装别人的 Skill，先读一遍
  • 谁写的，从哪里来
  • 要不要另装程序、要不要密钥：macro-data 第一次调用时，会引导智能体检查并安装环境——先让它讲清要装什么
  • 有没有留着别人的痕迹：作者的本机路径、只在作者电脑上成立的约定
放到你的电脑上，让它按你的机器改；签字的是你。
课程材料 · Claude Code 文档：Skills ↗
PART V / VI

它怎么被想起来

一句描述，决定它来不来。
V教材 7.3

渐进式披露：像在书架上找书

三站：看书脊（名字和描述一直露在外面）→ 翻开正文（挑中了才读 SKILL.md）→ 翻到附录（做到那一步才打开资料和脚本）
书架上摆三十本，常驻的也只是三十条书脊（每条约 100 token）。现场问一句：开新会话问“不打开任何文件，你现在知道 web-research 的哪些信息？”——它答得出的，就是书脊那一层。
教材第 7 章 · Agent Skills 规范 ↗
V书架的长度

装多了会怎样

书架上三十本技能书，智能体在想：装了三十个，它怎么知道用哪个
  • 书脊常驻，所以书架不是无限长
  • Claude Code 给技能清单的预算，约为上下文窗口的 1%；超了，先截短用得最少的那些描述
  • 输入 /doctor 可以看到清单占了多少
描述写短，关键用途放最前面；用不上的 Skill 移出去。
Claude Code 文档：Skills ↗
V三条写法

描述怎么写

反例文档助手处理数据什么活都像归它，又都不像

动作加对象

取近三年中国宏观数据，做成汇报网页

写上你会怎么说

“看看近几年中国宏观数据，做个汇报”

写明不做什么

不用于只查一个数，不给投资建议

真实例子 · 可比公司分析 Skill 的描述，列了五种“不太适合”
没有可比上市公司的私营企业高度多元化的综合集团陷入困境或破产的公司尚无收入的初创公司商业模式独特的公司
description 在清单里会被截短，关键用途放最前面。
教材第 7 章 · Claude Code 文档：Skills ↗ · comps-analysis 的 description（原文 Not ideal for）
V触发

两种毛病：想不起来，和抢着来

想不起来（触发不足）抢着来（触发过度）
表现该它的活，它没来不该它的活，它也来了
原因描述太窄或太虚，没有你会说的话描述太宽，没写不做什么
怎么改把你平时的说法补进描述补一句“不用于……”
改描述时，直接问它：“你什么时候会用这个技能？”听它怎么复述。有副作用的流程可以设成只许点名调用（disable-model-invocation: true），本课不用。
教材第 7 章 · Claude Code 文档：Skills ↗
V验收

装了不等于用了：怎么验

左：装了但没触发，报告看着挺像回事；右：真的用了，问它按第几步做的；底部：问一句，就知道
  1. 看界面：有没有调用技能的那一行
  2. 问它：“你按哪个技能的第几步做的？”
  3. 三句测试：两句该来的、一句不该来的，各在新会话里试一次
还有一个坑：项目里已有一份做好的成品，它可能直接照抄旧文件。测的时候换一个时间窗口、输出到新文件夹。
教材第 7 章 · Claude Code 文档：Skills ↗
PART VI / VI

造一个 Skill

三条路造一个 Skill：你给得越少，验得越多。
VI三条路径

三条路，各给什么

优先

路径一　事后沉淀

你给

带它一步步把一件活做对

它做

把刚才的经验写成 Skill

适合

你会做、但每次都要交代的活

本课

练习三

路径二　事前设计

你给

目标、做法、Skill 有哪些部件和流程

它做

按你的设计创建 Skill

适合

流程你心里有数、还没让它做过

本课

skill-creator 四句话交底

路径三　只给目标

你给

一类任务的目标

它做

上网调研、测试，自己定流程和工具

适合

你也不知道最好怎么做的活

本课

老师演示：macro-data

三条路都要测。路径越往后，人写得越少，验收越重。
教材第 7 章
VI路径一 · 优先推荐

路径一：先做对，再沉淀

四站：带它做一遍（先出计划，逐项核对）→ 一轮轮改对（改一轮，提交一次）→ 沉淀成 Skill（意见写进步骤和自检）→ 新会话里测（该来的来，不该来的不来）
沉淀这一步可以请 skill-creator 来做：“把前面几轮的意见归纳进步骤、口径和自检清单，不要写死这次的数，先给我看草稿。”写进去的每一条，都是你亲眼见它出过错、亲手纠正过的。
教材第 7 章
VI路径二

路径二：先设计，再让它写

开工前讲清三件事
  • 想做什么
  • 准备怎样做
  • 这个 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 ↗
VI路径三

路径三：只给目标，让它自己找路

你给一类任务的目标，加一条做法要求：逐个实测，每个写报告。
上网调研现有
工具和方案→写成这类任务
的流程→逐个
跑测试→按方案和踩坑结果
打包成 Skill→端到端
再测一遍

方向

有没有现成的开源封装？

验收

看完测试报告，再决定做不做

纠错

它做错了，让它改

你管三个关口。人写得最少，所以验收最重。
课程材料
VI路径三 · 只给目标，让它自己去试

我只说了四句话：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
VI任务卡 · 练习一

练习一：从 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-slides
7自然说一句：把素材做成 6 页网页演示
8/html-slides 点名，再加一页
9打开 SKILL.md，认出 name、description、正文
找不到 .claude？以点开头的文件夹默认隐藏，在 VS Code 文件栏里操作最方便
怎样算重开？连按两次 Ctrl+C 退出，再输入 claude，就是一个新会话
告诉它：“不要配图，不做截图审阅，不导出 PDF，只做 HTML。”
课程仓库 sysu-awesome-cc/skills ↗ · 详细步骤见上机手册
VI任务卡 · 练习二

练习二：两个 Skill 接力，做一份宏观基本面汇报

进阶做完练习一再做。题目：当前中国宏观基本面：近三年指标走势与我的判断
  1. 新项目，装 macro-data 与 html-slides，退出重开
  2. 先让它读 macro-data，讲清要装什么，等你确认；第一次调用时 Skill 会引导智能体检查并安装环境
  3. 取数：至少四个指标，覆盖增长、价格、景气、金融中三类以上；先看最新一期是哪个月
  4. 先写事实，再写你的判断，让它帮你找支撑与反例
  5. 用 html-slides 出 8–10 页
  6. 对照自查清单查一遍，提交一次
三条硬要求

数字写得出来源与发布日期二手接口写接口名和取数日期，至少一个关键数字回原发布核一次

每条判断下面挂依据哪个指标、哪几期、数值多少

事实与判断分开标注不写投资建议，不预测具体数值

取不到数，改用材料包里的备用 CSV，页面上写明；取不到的写“未取到”，不补造。
课程仓库 sysu-awesome-cc/skills ↗ · 详细步骤见上机手册
VI任务卡 · 练习三

练习三：一轮轮改，再沉淀成你的 Skill

沉淀做完练习二再做。这是路径一的实践。
A多轮反馈

从指标、口径、图表、结论表述、版式五方面提具体意见，至少两轮；改一轮提交一次，记进 反馈记录.md

B用 skill-creator 沉淀

从课程仓库装 skill-creator（Codex 自带）；结合 macro-data 取数、html-slides 出页和你的每轮反馈；反馈归纳进步骤、口径、自检清单；不写死这次的数；放进 .claude/skills/（Codex 放 .agents/skills/）；先看草稿，不跑评测

C新会话里测

两句该来、一句不该来；换一个时间窗口或指标组合再做一次，输出到新文件夹

D单独提交

新 Skill 和测试记录单独提交一次，看一眼历史图：每轮反馈一次提交，新 Skill 一次

反馈要具体到能写进步骤：“做得好看点”写不进去，“PMI 加一条 50 的荣枯线”写得进去。
课程仓库 sysu-awesome-cc/skills ↗ · 详细步骤与沉淀指令全文见上机手册
VI复盘

复盘：三层各念一遍

练习一

Skill 放在哪一串路径下；自然说的那句话是什么；description 说它什么时候用

练习二

挑一条“我的判断”，指出它的依据和数据来源

练习三

读两条反馈，指出它们进了新 Skill 的哪一步；三句测试，来没来

两句重申：描述决定它来不来，想不起来就点名；装别人的 Skill 先读一遍，签字的是你。
课程材料
三句话带走

先把一次任务做对，
再把做对的方法写成 Skill

CLAUDE.md 是入职手册，Skill 是岗位作业指导书
书架上常驻的是书脊，用到才翻开正文