切换上机材料(4 篇)
本页目录
开始之前先看上机导航“开始之前”一节:在终端里用 Claude Code;要交什么见导航页“做完要交什么”。
任务
做一份宏观基本面分析演示文稿(HTML,在浏览器里翻页),题目“当前中国宏观基本面:近三年指标走势与我的判断”。不是把走势图堆在一起,要在几个宏观指标近三年走势的基础上,落到你自己对当前中国宏观基本面的判断,做成可以上台讲的演示文稿。
- 指标:至少四个,覆盖增长、价格、景气、金融四类中的三类以上。可以参考:GDP 当季同比(增长);CPI 同比、PPI 同比(价格);制造业 PMI(景气);社会融资规模存量同比或 M2 同比(金融)。
- 时间:近三年。月度指标约 36 期,季度指标约 12 期;写明数据截至哪一期。
- 页面(建议 8–10 页左右):封面(题目、数据截至哪一期、取数日期、作者)→ 数据与口径(每个指标一行:来源机构、原发布链接、取数接口或文件、口径、最新一期)→ 各指标走势(一页一到两张图,图下写“事实”)→ 我的判断(两到三条,每条下面挂依据)→ 局限与待确认。
三条硬要求
- 每个数字可追溯、有留痕:布置取数任务时就要求 AI,下载到的每一条数据同时记下获取时间、来源机构、原始来源链接(原发布页面的 URL)和引用信息(发布标题、发布日期);经 AKShare 等二手接口取的,同时写接口名。数据文件逐行带这些来源列,
取数记录.md按指标汇总。演示文稿里的每个数字,都能顺着这些记录找回原发布。 - 结论有数据支撑:每条判断下面写明依据哪个指标、哪几期、数值多少,这些数字在页面上找得到。
- 事实与判断分开:“事实”只描述数据(升了还是降了、高点低点、连续几期);“我的判断”是你的解读。两者用不同标签和版式区分。不写投资建议,不预测具体数值。
完整的任务说明与自查清单也放在材料包 02_宏观汇报/口径与要求/汇报要求.md。
🎬 讲解录播
时长 6 分 54 秒,带讲解和字幕。播放器右下角可以全屏。
分段导览
点击时间会打开视频对应位置,不是同页播放器内跳转。导言之外,左侧节点对应六步操作。
| 时间 | 步骤 | 看什么 |
|---|---|---|
| 0:00 | 导言 | 场景、材料、两个要回答的问题,六步流程和要留意的人的判断 |
| 0:54 | 装技能 | 把 macro-data、html-slides 装进 .workbuddy/skills/;新建任务后输入 /ma 看技能列表 |
| 1:40 | 配环境 | 先读 SKILL.md、先别装;装 akshare 被沙箱拦下,叫停绕过,改走备用路线 |
| 3:02 | 取数留痕 | CPI、M2 从统计局取,其余四项从备用数据取;每行带来源列,取数记录逐项汇总 |
| 3:55 | 看数定判断 | AI 只描述走势;人写三条判断,再让它找依据和反例 |
| 5:05 | 出页 | html-slides 出 11 页演示文稿:数据与口径、六张走势图、我的判断、局限 |
| 5:50 | 自查 | 按清单自查;挑 PPI 两个点回原发布核对;看哪些项没过 |
录播说明
- 等待画面已加速(取数约 27 分钟、出页约 18 分钟),操作间停顿已压缩。
- 自查时还有几项没完全通过(如判断页反例里的个别数字在走势页找不到出处),留到练习三一轮轮反馈修改。
- 判断页的三条判断是教学示范,不构成投资建议。
准备
材料包 02_宏观汇报/ 里有:
| 文件或文件夹 | 用途 |
|---|---|
宏观数据_备用/ | 一份现成的宏观月度数据 CSV(2024-01 至 2026-08,GDP 到 2026Q2,逐行附来源机构、来源网址与发布日期)和它的来源说明。取不到数时用,只读 |
口径与要求/汇报要求.md | 任务说明与自查清单,只读 |
模板/CLAUDE_模板.md | 项目规则模板,改名 CLAUDE.md 放项目根目录 |
模板/gitignore_白名单.txt | 用 Git 的,改名 .gitignore 放项目根目录 |
模板/取数记录_模板.md | 取数记录模板,放进项目的 协作记录/,练习二要交 |
模板/反馈记录_模板.md、触发测试记录_模板.md | 练习三的个人笔记模板,想另记一份时再拷进 协作记录/;可选,不用交 |
模板/沉淀指令_示范.md | 练习三给 skill-creator 的示范指令 |
第 1 步:建项目,装两个 Skill
做什么
- 新建项目文件夹
宏观基本面汇报,用 VS Code 打开。 - 把材料包
02_宏观汇报/里的宏观数据_备用、口径与要求两个文件夹拷进项目;把模板/CLAUDE_模板.md拷进项目根目录并改名CLAUDE.md;新建文件夹协作记录,把取数记录模板拷进去,去掉文件名里的“_模板”(另两份个人笔记模板想用时再拷)。 - 用练习一的办法,从课程仓库把
macro-data和html-slides两个文件夹拷进项目的.claude/skills/。练习一下载解压过的仓库文件夹可以直接用。 - 在终端里启动
claude,输入/skills,列表里有macro-data和html-slides两个。 - 建议开启 Git 版本记录,后面每轮改完提交一次,改坏了可以退回:把
模板/gitignore_白名单.txt拷进项目根目录并改名.gitignore(前面有点,没有.txt),再对它说:“在这个项目里开启 Git 版本记录,先告诉我.gitignore会让哪些文件进版本记录,等我确认再做第一次提交。”确认清单里没有.claude/skills/macro-data、.claude/skills/html-slides(下载来的技能随时能重新下载,不进版本记录),再让它提交。
用 WorkBuddy 的:第 3 小步把两个文件夹放进项目的 .workbuddy/skills/,也可以选好 宏观基本面汇报 作为工作空间,让它把下载文件夹里仓库的这两个文件夹整个复制过去。第 4 小步没有 /skills:装好后点“新建任务”、重新选 宏观基本面汇报 作为工作空间(同一个任务里刚装的技能不会出现在列表里),在输入框打 /ma 或 /html,弹出的“技能”列表里能看到两项,看完清空,不要发送。下文提示词里的 .claude/skills/,WorkBuddy 换成 .workbuddy/skills/。
做对了会看到:/skills 列表里 macro-data、html-slides 两行都在,后面都标着 project。项目文件栏大致是这样(.gitignore 是开启了 Git 才有的):
宏观基本面汇报/
├── CLAUDE.md
├── .gitignore
├── .claude/skills/
│ ├── html-slides/
│ └── macro-data/
├── 宏观数据_备用/ 只读
├── 口径与要求/ 只读
└── 协作记录/ 取数记录.md(反馈记录.md、触发测试记录.md 是可选的个人笔记,不交)
改名时看不到 .txt 后缀:Windows 资源管理器“查看 → 显示 → 文件扩展名”;Mac 在 VS Code 文件栏里右键“重命名”最方便。
第 2 步:先读 Skill,再配环境
macro-data 要用 Python 和 AKShare 等程序取数。装别人的 Skill,先读一遍它要你装什么。
做什么:对它说:
先读 .claude/skills/macro-data/SKILL.md,告诉我:要取近三年中国的 GDP、CPI、PPI、PMI、社融或 M2,
按它的路由表走哪个数据源、要装什么、在我这台电脑上最少要装什么。先别装,讲完等我确认。
它讲完后,按它的说明决定。第一次用 macro-data 时,它会先检查你电脑上的环境;缺什么,它会说明要装什么、装到哪里、大约多久,按提示确认后再装。安装过程中每条命令都会请你批准;有需要你自己动手的步骤(例如双击安装包、勾选某个选项),它会一步一步说。
做对了会看到:它说清了要走的数据源和要装的东西;装完后它会跑一次测试取数,告诉你环境可用,并报出测试取到的是哪个指标、哪一期。
环境装了很久还跑不通,不要一直耗着,直接走本练习末尾的“取不到数怎么办”。
用 WorkBuddy 的:默认权限下装包不会逐次请你批准。它自带的 Python 环境装 akshare 可能报错(解压时 mkdir 失败,被 WorkBuddy 的沙箱拦下);如果它开始想办法绕过沙箱或代理,点停止,不要让它绕过安全机制。改走“取不到数怎么办”:macro-data 里的 scripts/nbs_fetch.py 只用 Python 标准库,不用装包,能从国家统计局取到的指标用它取,其余从备用 CSV 补。
第 3 步:取数,逐条留痕
做什么:布置取数任务时,就把留痕要求一起说清。对它说:
用 macro-data 取近三年中国的 GDP 当季同比、CPI 同比、PPI 同比、制造业 PMI、社融存量同比(或 M2 同比),
原始数据存进 宏观数据/,每个指标一份 CSV 文件。
下载到的每一条数据都要同时记下:获取时间、来源机构、原始来源链接(原发布页面的 URL)、
发布标题、发布日期;经 AKShare 等二手接口取的,再加一列接口名。这些作为数据文件的列,逐行写。
找不到原发布链接的写“未找到”,不要编。
每取完一个指标,在 协作记录/取数记录.md 里汇总一行:指标、接口或文件、获取时间、来源机构、
最新一期的原发布链接和发布日期、覆盖期间、最新一期是哪个月、有没有滞后。
取不到的写“未取到”,不要补造。
取到之后先看每个指标的最新一期是哪个月。有的接口会滞后很久(macro-data 的 SKILL.md 里写了这类坑),滞后的让它换接口重取。
再打开一两份数据文件看看:来源列有没有空着的、链接是不是指向国家统计局或中国人民银行的原发布页面。有空着或写“未找到”的,让它说明原因,能补的补上。
做对了会看到:屏幕上出现过 Skill(macro-data);宏观数据/ 里每个指标一份数据文件,每一行都有获取时间、来源机构、原始来源链接、发布标题、发布日期(二手接口另有接口名);取数记录.md 每个指标汇总一行。用 WorkBuddy 的:屏幕上不会出现 Skill(macro-data),展开过程,看它有没有读 .workbuddy/skills/macro-data/ 下的 SKILL.md 或运行其中的脚本。
第 4 步:看数,定判断
做什么
- 让它把每个指标的走势用三五句话描述出来,只说事实:升还是降、高点低点在哪一期、最近连续几期怎样。
- 你读完,自己写两三条判断。判断是你的,它负责找数据。
- 把你的判断发给它:“为这几条判断各找支撑的数据和可能的反例,写明哪个指标、哪几期、数值多少。”
做对了会看到:每条判断下面有两三条依据,也有它找到的反例;依据里的数字都能在 宏观数据/ 的文件里找到,那一行带着来源链接。
💡 事实和判断怎么分
“CPI 同比连续三个月低于 1%”是事实,数据自己会说;“需求偏弱”是判断,是你的解读,要挂依据。写“事实”时不用“说明”“意味着”这类词。
第 5 步:出页
做什么:对它说:
用 html-slides 把上面的内容做成 8–10 页左右的宏观基本面分析演示文稿,结构按 口径与要求/汇报要求.md。
图用内嵌 SVG 或页面内脚本绘制,不引外部图表库;每张图下写单位和来源。
“数据与口径”页每个指标写来源机构、原发布链接、获取时间。
“事实”与“我的判断”用不同标签区分。不要配图,不做截图审阅,不导出 PDF。
做对了会看到:屏幕上出现过 Skill(html-slides);双击生成的 index.html,浏览器里能翻页,每张图下有单位和来源;“我的判断”那一页每条判断下面挂着依据,标签和版式与“事实”页不同。用 WorkBuddy 的:不会出现 Skill(html-slides),看过程里有没有“查看 SKILL.md”;生成的文件夹和文件名不固定,做完后右侧会自动打开预览,点一下预览再按方向键翻页。
第 6 步:自查
按下面的清单逐项查一遍,没过的让它改。审阅时发现的问题,一次说清楚要它怎么改,这些来回都会留在交互记录里。用 Git 的,都过了之后对它说:“把这一版提交,提交说明写‘练习二:宏观基本面分析演示文稿初版’。”这一版是练习三的起点,也是练习二要交的那一版:练习三的修改在这一版之后另存,不要覆盖它。
✅ 练习二自查
/skills里有macro-data与html-slides;取数和出页时屏幕上各出现过调用那一行(WorkBuddy:新任务里打/ma、/html弹出的技能列表里有两项;取数和出页的过程里读过对应的SKILL.md)- 数据文件每一行都带获取时间、来源机构、原始来源链接、发布标题、发布日期;二手接口取的带接口名
取数记录.md每个指标汇总一行;滞后的写明- 任选一张图上的两个点,回
宏观数据/找到那两行,打开来源链接,原发布里的数字与发布日期对得上 - 每条“我的判断”下面有依据,依据里的数字在页面上找得到
- 事实与判断分开标注;没有投资建议,没有具体数值预测
- 取不到的指标写“未取到”,没有补造
- 断网后双击
index.html,所有页和图都能显示 - 用了 Git 的:下载来的两个技能文件夹没有进版本记录(
git status或 VS Code 源代码管理面板里看不到它们)
本练习要交:交互记录(/export 导出的 .txt 或 .md,可多份);宏观基本面分析演示文稿 HTML(有外部文件就连同打成 ZIP),加上 协作记录/取数记录.md。交练习三修改之前的那一版。
取不到数怎么办
- 全部改用备用数据:对它说“
macro-data取数没跑通,改用宏观数据_备用/宏观月度数据_2024-2026.csv,数据与口径页写明来源是这份文件以及文件里每行的来源机构、原发布网址和发布日期”。这份 CSV 每行已带来源机构、原发布网址和发布日期,是课程组 2026-09-21 从国家统计局、中国人民银行官网整理的;取数记录.md里获取方式写“课程备用数据”。这份数据从 2024 年 1 月开始,不到三年,题目改成“2024 年以来”,在“局限”页写明。 - 部分取到:取到几个用几个,其余从备用 CSV 补,数据与口径页逐个标来源。
- 两种情况都照样用
html-slides出页,自查清单照样适用。在取数记录.md里写清卡在哪一步、报的什么错,这也是一条可以写进练习三 Skill 的经验。