上机材料：装一个 Skill，用两个 Skill，造一个 Skill

三个练习，一个比一个进一步：

练习一做完就达标。练习一学会的装法、重开、确认，练习二开头会再做一遍；练习二的演示文稿是练习三的起点。

本手册用到的 Skill 都在课程组的公开仓库 https://github.com/ai-lingnan/sysu-awesome-cc 的 skills/ 文件夹里，从那里下载，材料包里不附。材料包里有练习一的素材、练习二的备用数据和几个模板，见各练习“准备”一节。

每一步写两样：做什么；做对了会看到什么，可以逐项对照检查。几处附了实际画面的截图，供对照。灰底方框是电脑常识，已经会的跳过。

做完要交什么

三个练习各交两样：

1. 交互记录：你和 Claude Code 的对话，交 .txt 或 .md 文本文件，不收截图。在会话里输入 /export 文件名 导出（见文末“导出对话”）；这个练习用过几段会话就导出几份，不用合并。交互记录里要能看出你审阅了 AI 的产物、提出了具体反馈、让它修改过；把手册整份丢给它“替我全部做完”，记录里看不出这些。
2. 最终产物：

Git 历史不用另交。建议用 Git 管理版本，每轮改完提交一次，改坏了可以退回。

开始之前

在终端里用 Claude Code

本手册的操作都在终端里运行 claude。用 VS Code 的：菜单“终端 → 新建终端”（英文界面 Terminal → New Terminal），窗口下方出现的就是终端，在里面输入 claude 回车。

💡 常识：VS Code 里的两种 Claude Code

VS Code 里有两种用法：一是在终端里输入 claude（命令行界面），二是点侧边栏或右上角的 Claude 图标打开的图形面板。有些功能只在命令行界面里能用，在图形面板或其他非终端环境里输入 /export 等命令，会看到 /export isn't available in this environment.。本手册的步骤按终端写；图形面板里做不了的，回到终端做。

💡 常识：键盘上的几个键

• Enter（回车）：发送、确认。Mac 键盘上写作 return。
• Tab：键盘左侧、字母 Q 左边的那个键，上面常印着 Tab 或 ⇥。在终端里按它可以补全文件名。
• Ctrl：键盘左下角。Mac 上用的也是 control，不是 command（⌘）。本手册写 Ctrl + C，意思是按住 Ctrl 不放，再按一下 C。
• Esc：键盘左上角。Claude Code 正在干活时按一下，让它停下。
• Shift + Tab：切换 Claude Code 的权限模式，屏幕最下面一行会跟着变。

电脑上没有 VS Code

先按 W01 安装手册装好：https://ai.lingnan.top/materials/2026-autumn/w01/installation。装好之前，练习一可以用 Mac 的“终端”或 Windows 的 PowerShell 启动 claude，文件夹用访达或资源管理器操作（隐藏文件夹怎么显示见练习一第 4 步）。

---

练习一（基础）：从 GitHub 装 html-slides，做一份网页演示文稿

准备

材料包 01_网页演示/素材/ 里有两份背景资料：背景_经济金融类实习市场_教学模拟.md、背景_岗位类别与技能说明.md（教学模拟材料）。

第 0 步：建项目文件夹

做什么

1. 在你平时放作业的位置（桌面、文档，或之前建的 agent-lab 都可以）新建一个文件夹，起名 网页演示练习。
2. 在 网页演示练习 里面再建一个文件夹 素材，把材料包里那两份背景资料拷进去。
3. 打开 VS Code，菜单“文件 → 打开文件夹”，选 网页演示练习，点“打开”。弹出“是否信任此文件夹的作者”时选“是，我信任此作者”。
4. 菜单“终端 → 新建终端”，在下方终端里输入 claude 回车。第一次在这个文件夹里启动时，它会问你是否信任这个文件夹里的文件，用方向键选“是”的那一项（通常是第一项），回车。

做对了会看到：VS Code 左侧文件栏最上面是 网页演示练习，下面有 素材，展开能看到两份 .md 文件；下方终端里出现 Claude Code 的欢迎界面，第三行是你这个文件夹的路径，路径最后一段是 网页演示练习。

💡 常识：文件夹、路径和“建项目”

路径是一个文件夹一层层的地址。同一个文件夹，两种系统写法不同：

	路径长什么样	分隔符
Mac	/Users/你的用户名/Documents/网页演示练习	/
Windows	C:\Users\你的用户名\Documents\网页演示练习	\

Mac 的“文稿”就是 Documents；Windows 的“文档”也是。终端里的 ~ 代表你的用户文件夹（Mac 是 /Users/你的用户名，Windows 是 C:\Users\你的用户名）。

“建项目”就是建一个文件夹，把这件事要用的文件都放进去，再用 VS Code 打开它、在里面启动 claude。在哪个文件夹启动 claude，它就把哪个文件夹当成项目。

第 1 步：打开课程仓库页

做什么：浏览器打开 https://github.com/ai-lingnan/sysu-awesome-cc。页面中间是文件列表，点进 skills 文件夹，里面每个子文件夹就是一个 Skill。点开 html-slides，能看到 SKILL.md 和 assets、references、scripts 等几个子文件夹。

做对了会看到：skills 下有十几个以英文小写和连字符命名的文件夹，其中有 html-slides、macro-data、skill-creator：

点开 html-slides，里面是 assets、evals、references、scripts 四个子文件夹和一个 SKILL.md：

💡 常识：GitHub 是什么

GitHub 是放代码和文件的公共网站，一个项目叫一个“仓库”（repository）。看和下载公开仓库不用注册账号。

第 2 步：下载

两条路，任选一条。没用过 Git 命令的走路一。

路一：下载 ZIP（推荐）

回到仓库首页（点页面左上方的 sysu-awesome-cc 仓库名即可回去），点文件列表右上方的绿色 Code 按钮，在弹出的菜单最下面点 Download ZIP。浏览器会下载一个 sysu-awesome-cc-main.zip（约 1 MB），一般在“下载”文件夹里。

路二：用 Git 克隆（会用 Git 的）

在终端里运行（不是在 Claude Code 里，先退出它，或另开一个终端）：

git clone https://github.com/ai-lingnan/sysu-awesome-cc.git

也可以直接对 Claude Code 说：“把 https://github.com/ai-lingnan/sysu-awesome-cc 克隆到我的‘下载’文件夹。”克隆得到的是普通文件夹，不用解压，跳到第 3 步最后一句去找 html-slides。以后仓库更新了，在这个文件夹里运行 git pull 就能拿到新版。

💡 常识：下载与“下载”文件夹

浏览器下载的文件默认放在“下载”文件夹：Mac 是访达左侧的“下载”（/Users/你的用户名/Downloads），Windows 是资源管理器左侧的“下载”（C:\Users\你的用户名\Downloads）。找不到时，点浏览器右上角的下载图标，再点文件旁的“在文件夹中显示”。

第 3 步：解压

💡 常识：ZIP 与解压

ZIP 是把一堆文件和文件夹打成一个包，方便下载。用之前要“解压”，还原成普通文件夹。

做什么

进 skills，找到 html-slides 文件夹，点进去确认里面有 SKILL.md。

做对了会看到：一个普通的 html-slides 文件夹，里面有 SKILL.md 和 assets、evals、references、scripts 四个子文件夹，和第 1 步在网页上看到的一样。文件夹图标上没有拉链标记，地址栏里没有 .zip 字样（有的话，你看到的还是压缩包里面）。

⚠️ Windows 上直接双击 ZIP，看到的是“预览”，不是解压。从预览窗口里拖出来的文件夹可能缺文件。一定先“全部解压缩”。

第 4 步：把技能文件夹拷到对的位置

Claude Code 在两个位置找 Skill：

用 Codex 的同学：项目级是 .agents/skills/，个人级是 ~/.agents/skills/（~ 见第 0 步常识框）。下文凡写 .claude/skills/ 的，Codex 换成 .agents/skills/。

做什么：在 网页演示练习 里建出 .claude/skills/ 两层文件夹，再把第 3 步找到的整个 html-slides 文件夹放进 skills。三种做法任选：

1. 在 VS Code 里（推荐）：鼠标移到左侧文件栏标题 网页演示练习 那一行，点出现的“新建文件夹”图标，输入 .claude 回车；右键 .claude → “新建文件夹”，输入 skills 回车。然后从访达或资源管理器里，把 html-slides 文件夹拖到 VS Code 文件栏的 skills 上，松手后 VS Code 会复制一份进去。VS Code 文件栏里以点开头的文件夹是看得见的。
2. 让 Claude Code 建文件夹：对它说“在当前项目里新建 .claude/skills 文件夹”，它会请你批准，批准后，再用访达或资源管理器把 html-slides 拖进去。
3. 全在访达或资源管理器里做：先让隐藏文件夹显示出来（见下面的常识框），再新建、拖动。Mac 访达不让直接把新文件夹命名成以点开头的名字，这种情况用做法 1 或 2 建。

做对了会看到：VS Code 文件栏里一层层展开是 网页演示练习/.claude/skills/html-slides/SKILL.md，html-slides 下面还有 assets、references 等子文件夹；.claude 和 素材 并排，都在 网页演示练习 下面一层。

两种常见的放错：

• 多了一层：.claude/skills/sysu-awesome-cc-main/skills/html-slides/…，把整个仓库拷了进去。
• 少了一层：.claude/skills/SKILL.md，只拷了文件，外面没有 html-slides 文件夹。

💡 常识：隐藏文件夹

名字以 . 开头的文件夹（如 .claude、.git）是放配置的，系统默认不显示，不是没有。要显示出来：

• Mac 访达：按 Command + Shift + .（句点），再按一次恢复隐藏。
• Windows 11 资源管理器：顶部“查看 → 显示 → 隐藏的项目”；Windows 10：顶部“查看”选项卡，勾选“隐藏的项目”。
• VS Code 文件栏默认就显示。

第 5 步：退出，重新打开 Claude Code

.claude/skills/ 是 Claude Code 启动之后才建的，要退出再启动一次，它才会去读这个文件夹。

做什么

1. 在运行 Claude Code 的终端里按一次 Ctrl + C，最下面出现 Press Ctrl-C again to exit；紧接着再按一次 Ctrl + C，Claude Code 退出，回到命令行提示符（一行以 %、$ 或 > 结尾、光标在后面闪的文字）。
2. 输入 claude 回车，重新启动。

做对了会看到：按第一次后屏幕最下面出现 Press Ctrl-C again to exit；按第二次后 Claude Code 的界面消失，回到命令行提示符；再输入 claude，重新出现欢迎界面，输入框是空的，上一段对话不在屏幕上。

💡 常识：按一次 Ctrl + C 和按两次；什么是“新会话”

• 按一次：它正在干活时是打断；输入框里有字时是清空；什么都没做时，屏幕提示“再按一次退出”。
• 紧接着按第二次：退出 Claude Code。按两次 Ctrl + C 只是退出，还要再输入 claude 才算重新打开。
• 退出后再输入 claude 启动，就是一个新会话：屏幕上没有上一次的对话，它重新读取项目规则和技能清单。旧对话没有丢，存在你电脑上，想接着上次聊，启动时输入 claude --continue（接最近一次）或 claude --resume（从列表里选），本练习不需要。
• 用 VS Code 图形面板的：关掉面板，重新打开，点“新对话”。

第 6 步：确认它看得到

做什么：在 Claude Code 里输入 /skills 回车。

做对了会看到：弹出一个技能列表，其中一行是 html-slides，后面标着 project（项目级）和一个很小的 token 数（例如 ~40 tok，这就是它平时常驻的那一行描述的大小）。按 Esc 关掉列表。

列表里没有 html-slides：回第 4 步核对那一串路径，确认做过第 5 步；还不行看常见问题。也可以直接问它“你有哪些技能可用”，让它列出来。

第 7 步：自然说话，让它自己来一次

做什么：在输入框里粘贴下面这段话，回车。

把 素材/ 里的两份背景资料做成一份 6 页左右的网页演示文稿，给同学介绍经济金融类实习市场。
不要配图，不做截图审阅，不导出 PDF，只做 HTML。

它开始干活前，屏幕上会出现这样两行：

⏺ Skill(html-slides)
  ⎿  Successfully loaded skill

这说明它读了你的话，自己判断这件事归 html-slides 管，打开了这个技能。之后它会写文件，每次写文件前可能请你批准（选 Yes 回车）。等它说做完了，在 VS Code 文件栏里找它生成的文件夹（一般叫 html_deck_…），里面有 index.html。

做对了会看到：屏幕上出现过上面那两行；在访达或资源管理器里双击 index.html，浏览器打开一份暖纸色底、深红强调色、宋体标题的网页演示文稿；按键盘方向键 → ← 翻页，封面和目录能点。每个人做出来的标题、版式会不一样，下面是一次实测的封面：

💡 常识：用浏览器打开 HTML

.html 文件就是网页，双击会用默认浏览器打开。没反应：右键 → “打开方式” → 选 Chrome 或 Edge。在 VS Code 里不能直接预览网页，要到访达或资源管理器里双击；VS Code 文件栏里右键文件，选“在访达中显示”（Windows 是“在文件资源管理器中显示”）可以跳过去。

它问要不要装 Playwright、要不要生成配图、要不要导出 PDF：回答“不要，只做 HTML”。这几步要另装程序，本练习不需要。

第 8 步：点名，再让它来一次

做什么：输入下面这段话，回车。

/html-slides 在最后加一页“给大二同学的三条找实习建议”，建议只能来自素材里写到的内容。

/html-slides 要写在最前面，后面空一格再写要求。输入 /html 时屏幕上会弹出候选，按 Tab 或回车可以补全。

做对了会看到：它不再自己判断，直接按 html-slides 干活。改完后回到浏览器，按 F5（Mac 按 Command + R）刷新，翻到最后一页，多了“三条找实习建议”，每条建议旁边能看出出自哪份素材：

两种用法的区别：第 7 步是它自己想起来，靠的是技能的描述和你的话对得上；第 8 步是你点名，不管你的话里有没有它认得的词，都用这个技能。它想不起来时，就点名。

第 9 步：打开 SKILL.md 读一遍

做什么：在 VS Code 文件栏点开 .claude/skills/html-slides/SKILL.md。

找出三样东西

• 文件最上面两道 --- 之间：name: html-slides 是技能的名字，和文件夹同名；description: 后面那段是描述。平时它常驻的就是这一段，靠它判断什么时候用这个技能。
• 第二道 --- 以下是正文：它决定用这个技能以后才读。
• 正文里提到的 references/…、scripts/…、assets/… 文件，做到那一步才打开。

然后用自己的话写一句：这个技能在什么时候会被用上？

做对了会看到：文件第 1 行和第 4 行各是一道 ---；第 2 行是 name: html-slides；第 3 行以 description: 开头，是一段中文，讲它做浏览器里放映的 HTML 课件、适用于网页演示文稿；第 4 行以下是正文。

做到这里，练习一达标。

还有余力：用你自己以前做过的一份简报素材，再用 html-slides 做一份，和当时不用 Skill 做的成品放在一起比一比。

✅ 练习一自查

• 路径对得上：网页演示练习/.claude/skills/html-slides/SKILL.md（Codex：.agents/skills/html-slides/SKILL.md）
• /skills 列表里有 html-slides
• 自然说话那次，屏幕上出现过 Skill(html-slides)
• /html-slides 点名那次，最后一页加上了，内容能在素材里找到出处
• 双击 index.html，浏览器里能翻页
• 说得出 name、description、正文各在哪里，用一句话说出这个技能什么时候会被用上

本练习要交：交互记录（/export 导出的 .txt 或 .md，可多份）；网页演示文稿 HTML（有外部文件就把整个 html_deck_… 文件夹打成 ZIP）。

---

练习二（进阶）：两个 Skill 接力，做一份宏观基本面分析演示文稿

任务

做一份宏观基本面分析演示文稿（HTML，在浏览器里翻页），题目“当前中国宏观基本面：近三年指标走势与我的判断”。不是把走势图堆在一起，要在几个宏观指标近三年走势的基础上，落到你自己对当前中国宏观基本面的判断，做成可以上台讲的演示文稿。

• 指标：至少四个，覆盖增长、价格、景气、金融四类中的三类以上。可以参考：GDP 当季同比（增长）；CPI 同比、PPI 同比（价格）；制造业 PMI（景气）；社会融资规模存量同比或 M2 同比（金融）。
• 时间：近三年。月度指标约 36 期，季度指标约 12 期；写明数据截至哪一期。
• 页面（8–10 页）：封面（题目、数据截至哪一期、取数日期、作者）→ 数据与口径（每个指标一行：来源机构、原发布链接、取数接口或文件、口径、最新一期）→ 各指标走势（一页一到两张图，图下写“事实”）→ 我的判断（两到三条，每条下面挂依据）→ 局限与待确认。

三条硬要求

1. 每个数字可追溯、有留痕：布置取数任务时就要求 AI，下载到的每一条数据同时记下获取时间、来源机构、原始来源链接（原发布页面的 URL）和引用信息（发布标题、发布日期）；经 AKShare 等二手接口取的，同时写接口名。数据文件逐行带这些来源列，取数记录.md 按指标汇总。演示文稿里的每个数字，都能顺着这些记录找回原发布。
2. 结论有数据支撑：每条判断下面写明依据哪个指标、哪几期、数值多少，这些数字在页面上找得到。
3. 事实与判断分开：“事实”只描述数据（升了还是降了、高点低点、连续几期）；“我的判断”是你的解读。两者用不同标签和版式区分。不写投资建议，不预测具体数值。

完整的任务说明与自查清单也放在材料包 02_宏观汇报/口径与要求/汇报要求.md。

准备

材料包 02_宏观汇报/ 里有：

第 1 步：建项目，装两个 Skill

做什么

1. 新建项目文件夹 宏观基本面汇报，用 VS Code 打开。
2. 把材料包 02_宏观汇报/ 里的 宏观数据_备用、口径与要求 两个文件夹拷进项目；把 模板/CLAUDE_模板.md 拷进项目根目录并改名 CLAUDE.md；新建文件夹 协作记录，把三份记录模板拷进去，去掉文件名里的“_模板”。
3. 用练习一的办法，从课程仓库把 macro-data 和 html-slides 两个文件夹拷进项目的 .claude/skills/。练习一下载解压过的仓库文件夹可以直接用。
4. 在终端里启动 claude，输入 /skills，列表里有 macro-data 和 html-slides 两个。
5. 建议开启 Git 版本记录，后面每轮改完提交一次，改坏了可以退回：把 模板/gitignore_白名单.txt 拷进项目根目录并改名 .gitignore（前面有点，没有 .txt），再对它说：“在这个项目里开启 Git 版本记录，先告诉我 .gitignore 会让哪些文件进版本记录，等我确认再做第一次提交。”确认清单里没有 .claude/skills/macro-data、.claude/skills/html-slides（下载来的技能随时能重新下载，不进版本记录），再让它提交。

做对了会看到：/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 时，它会先检查你电脑上的环境；缺什么，它会说明要装什么、装到哪里、大约多久，按提示确认后再装。**安装过程中每条命令都会请你批准；有需要你自己动手的步骤（例如双击安装包、勾选某个选项），它会一步一步说。

做对了会看到：它说清了要走的数据源和要装的东西；装完后它会跑一次测试取数，告诉你环境可用，并报出测试取到的是哪个指标、哪一期。

环境装了很久还跑不通，不要一直耗着，直接走本练习末尾的“取不到数怎么办”。

第 3 步：取数，逐条留痕

做什么：布置取数任务时，就把留痕要求一起说清。对它说：

用 macro-data 取近三年中国的 GDP 当季同比、CPI 同比、PPI 同比、制造业 PMI、社融存量同比（或 M2 同比），
原始数据存进 宏观数据/，每个指标一份 CSV 文件。
下载到的每一条数据都要同时记下：获取时间、来源机构、原始来源链接（原发布页面的 URL）、
发布标题、发布日期；经 AKShare 等二手接口取的，再加一列接口名。这些作为数据文件的列，逐行写。
找不到原发布链接的写“未找到”，不要编。
每取完一个指标，在 协作记录/取数记录.md 里汇总一行：指标、接口或文件、获取时间、来源机构、
最新一期的原发布链接和发布日期、覆盖期间、最新一期是哪个月、有没有滞后。
取不到的写“未取到”，不要补造。

取到之后先看每个指标的最新一期是哪个月。有的接口会滞后很久（macro-data 的 SKILL.md 里写了这类坑），滞后的让它换接口重取。

再打开一两份数据文件看看：来源列有没有空着的、链接是不是指向国家统计局或中国人民银行的原发布页面。有空着或写“未找到”的，让它说明原因，能补的补上。

做对了会看到：屏幕上出现过 Skill(macro-data)；宏观数据/ 里每个指标一份数据文件，每一行都有获取时间、来源机构、原始来源链接、发布标题、发布日期（二手接口另有接口名）；取数记录.md 每个指标汇总一行。

第 4 步：看数，定判断

做什么

1. 让它把每个指标的走势用三五句话描述出来，只说事实：升还是降、高点低点在哪一期、最近连续几期怎样。
2. 你读完，自己写两三条判断。判断是你的，它负责找数据。
3. 把你的判断发给它：“为这几条判断各找支撑的数据和可能的反例，写明哪个指标、哪几期、数值多少。”

做对了会看到：每条判断下面有两三条依据，也有它找到的反例；依据里的数字都能在 宏观数据/ 的文件里找到，那一行带着来源链接。

💡 事实和判断怎么分

“CPI 同比连续三个月低于 1%”是事实，数据自己会说；“需求偏弱”是判断，是你的解读，要挂依据。写“事实”时不用“说明”“意味着”这类词。

第 5 步：出页

做什么：对它说：

用 html-slides 把上面的内容做成 8–10 页的宏观基本面分析演示文稿，结构按 口径与要求/汇报要求.md。
图用内嵌 SVG 或页面内脚本绘制，不引外部图表库；每张图下写单位和来源。
“数据与口径”页每个指标写来源机构、原发布链接、获取时间。
“事实”与“我的判断”用不同标签区分。不要配图，不做截图审阅，不导出 PDF。

做对了会看到：屏幕上出现过 Skill(html-slides)；双击生成的 index.html，浏览器里能翻页，每张图下有单位和来源；“我的判断”那一页每条判断下面挂着依据，标签和版式与“事实”页不同。

第 6 步：自查

按下面的清单逐项查一遍，没过的让它改。审阅时发现的问题，一次说清楚要它怎么改，这些来回都会留在交互记录里。用 Git 的，都过了之后对它说：“把这一版提交，提交说明写‘练习二：宏观基本面分析演示文稿初版’。”这一版是练习三的起点。

✅ 练习二自查

• /skills 里有 macro-data 与 html-slides；取数和出页时屏幕上各出现过调用那一行
• 数据文件每一行都带获取时间、来源机构、原始来源链接、发布标题、发布日期；二手接口取的带接口名
• 取数记录.md 每个指标汇总一行；滞后的写明
• 任选一张图上的两个点，回 宏观数据/ 找到那两行，打开来源链接，原发布里的数字与发布日期对得上
• 每条“我的判断”下面有依据，依据里的数字在页面上找得到
• 事实与判断分开标注；没有投资建议，没有具体数值预测
• 取不到的指标写“未取到”，没有补造
• 断网后双击 index.html，所有页和图都能显示
• 用了 Git 的：下载来的两个技能文件夹没有进版本记录（git status 或 VS Code 源代码管理面板里看不到它们）

本练习要交：交互记录（/export 导出的 .txt 或 .md，可多份）；宏观基本面分析演示文稿 HTML（有外部文件就连同打成 ZIP），加上 协作记录/取数记录.md。

取不到数怎么办

1. 全部改用备用数据：对它说“macro-data 取数没跑通，改用 宏观数据_备用/宏观月度数据_2024-2026.csv，数据与口径页写明来源是这份文件以及文件里每行的来源机构、原发布网址和发布日期”。这份 CSV 每行已带来源机构、原发布网址和发布日期，是课程组 2026-09-21 从国家统计局、中国人民银行官网整理的；取数记录.md 里获取方式写“课程备用数据”。这份数据从 2024 年 1 月开始，不到三年，题目改成“2024 年以来”，在“局限”页写明。
2. 部分取到：取到几个用几个，其余从备用 CSV 补，数据与口径页逐个标来源。
3. 两种情况都照样用 html-slides 出页，自查清单照样适用。在 取数记录.md 里写清卡在哪一步、报的什么错，这也是一条可以写进练习三 Skill 的经验。

---

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

这是“先把一次任务做对，再把做对的方法写成 Skill”的实践：先带着它把练习二的演示文稿一轮轮改对，再请 skill-creator 把你说过的意见整理成一个新 Skill。

A. 多轮反馈

做什么：对练习二的演示文稿一轮一轮提意见，至少两轮。每一轮：

1. 在浏览器里看一遍，找出要改的地方，一次说清楚；
2. 它改完，你刷新浏览器再看；
3. 在 协作记录/反馈记录.md 记下：这一轮你说了什么、它改了什么、你看了之后满不满意。

建议用 Git 管理版本，每轮改完提交一次，提交说明写“第几轮：改了什么、为什么”，改坏了可以退回。

意见从下面五个方面找，要具体到能写进步骤：

“做得好看点”“再专业一点”写不进步骤；“PMI 加一条 50 的荣枯线”写得进。

做对了会看到：反馈记录.md 至少两轮，每轮写了你说的意见和它改了什么；浏览器里刷新后，每轮提的意见都能在页面上找到改动。

B. 用 skill-creator 沉淀

做什么

1. 从课程仓库把 skills/skill-creator/ 整个文件夹拷进项目的 .claude/skills/，退出重开 Claude Code，/skills 里看得到 skill-creator。用 Codex 的不用拷：Codex 自带 skill-creator，点名用 $skill-creator。
2. 在同一个项目里（反馈记录都在这里），把下面这段指令发给它。它也在材料包 模板/沉淀指令_示范.md 里。

Claude Code 版

用 skill-creator 帮我把这次做宏观基本面分析演示文稿的做法沉淀成一个新技能，名字叫 macro-fundamentals-report。
这个技能要把三样东西结合起来：
1. 取数：调用 macro-data 取近三年中国宏观指标，写清取哪几类指标、每类首选哪个接口、怎样核最新一期；
   每个数字可追溯、有留痕：下载到的每一条数据同时记下获取时间、来源机构、原始来源链接和引用信息
   （发布标题、发布日期，二手接口加接口名），数据文件逐行带来源列，取数记录逐指标汇总；
2. 出页：调用 html-slides 做演示文稿，写清页面结构（封面、数据与口径、走势页、我的判断、局限）；
3. 我的反馈：读 协作记录/反馈记录.md（用了 Git 的，也读提交历史），把我前面几轮提过的意见逐条归纳进步骤、口径规定和最后的自检清单。
正文里写明：先用 macro-data 取数，再用 html-slides 出页；事实与判断分开；取不到的写“未取到”，不补造；
取数失败时改用项目里 宏观数据_备用/ 的 CSV。
不要把这次的具体月份和数值写进技能。
放到本项目的 .claude/skills/macro-fundamentals-report/。
description 写清：做什么、我平时会怎么说、什么时候不用它（比如只查一个数、写投资建议）。
先访谈我、给我看草稿，我确认后再写文件。不要跑评测。

Codex 版：把倒数第三行（“放到本项目的 .claude/skills/macro-fundamentals-report/。”）换成：

放到本项目的 .agents/skills/macro-fundamentals-report/，不要放到 ~/.codex/skills 或其他个人目录。

这一行不能省：Codex 自带的 skill-creator 不写明位置时，默认把技能写进个人级的旧路径 ~/.codex/skills，不在项目里，也不跟着项目走。

3. 读它给的草稿，对照 反馈记录.md 逐轮看：
   • 每一轮的意见都进了 Skill 吗？进在步骤、口径规定还是自检清单里？
   • 有没有把这次的具体月份、数值写死（例如“2026 年 8 月 CPI 0.8%”）？有就让它改成做法（例如“先确认最新一期是哪个月”）。
   • 正文里是不是写明了先调用 macro-data、再调用 html-slides？取数一步有没有写逐条留痕？
4. 确认后让它写文件。写完退出重开，/skills 里看得到 macro-fundamentals-report。

做对了会看到：.claude/skills/macro-fundamentals-report/SKILL.md 存在，开头两道 --- 之间有 name: macro-fundamentals-report 和一段 description；正文里找得到你每轮反馈的影子，例如你说过“PMI 图加 50 荣枯线”，自检清单里就有这一条。

它开始跑评测、停不下来：按 Esc，再说一遍“不要跑评测，给我看草稿”。

C. 触发测试（在新会话里）

测的是：你照常说话时，它想不想得起这个新技能。要在新会话里测（退出重开），因为刚写完技能的那个会话里它记得前面的对话，测不准。

做什么：退出重开 Claude Code，分别发下面三句话（每句测完可以按 Esc 让它停下，再退出重开测下一句）：

再换一个时间窗口或指标组合完整做一次，例如“做一份近两年中国宏观基本面分析演示文稿，加上工业增加值，输出到新文件夹 汇报_测试/”。看它是按新 Skill 的步骤从取数做起，还是照抄项目里已有的演示文稿。做完问它：“你按哪个技能的第几步做的？”

每次的结果记进 协作记录/触发测试记录.md。

• 该来没来：在 description 里补上你刚才那句话的说法，改完重测这一句。
• 不该来却来了：在 description 里补一句“不用于……”，改完重测这一句。

✅ 自查：name 与文件夹同名，只用小写字母、数字和连字符；SKILL.md 第一行就是 ---，前面没有空行；三句测试的结果都记下了。

D. 回看版本历史（用了 Git 的）

用了 Git 的，把新 Skill 和测试记录单独提交一次：对它说“把 .claude/skills/macro-fundamentals-report/ 和 协作记录/触发测试记录.md 单独提交一次，提交说明写‘沉淀新技能 macro-fundamentals-report 并完成触发测试’。只提交这两样。”

然后打开历史图看一眼：VS Code 左侧点“源代码管理”图标（或按 Ctrl + Shift + G，Mac 同样），面板下方有“源代码管理图”，折叠着的点标题展开。装了 Git Graph 扩展的，也可以点源代码管理面板顶部的 Git Graph 图标，或按 Ctrl + Shift + P（Mac Command + Shift + P）输入 Git Graph: View Git Graph。

做对了会看到：历史图上从下往上依次是：第一次提交 → 初版 → 第一轮 → 第二轮 →（更多轮）→ 沉淀新技能，每轮反馈一个节点，新 Skill 单独一个节点。哪一轮改坏了，可以从这里找回那一轮之前的版本。

✅ 练习三自查

• 反馈记录.md 至少两轮，每轮的意见具体到能写进步骤，写了它改了什么
• 新 Skill 在项目的 .claude/skills/macro-fundamentals-report/（Codex：.agents/skills/…），不在个人目录
• 说得出新 Skill 里哪几条来自你哪一轮的反馈
• 新 Skill 里没有写死具体月份和数值；写明了先调用 macro-data、再调用 html-slides，取数时逐条留痕
• 新会话里两句该来的来了，一句不该来的没来；换窗口那次没有照抄旧文件
• 三句测试和换窗口那次的结果都记在 触发测试记录.md

本练习要交：交互记录（/export 导出的 .txt 或 .md，可多份）；用 skill-creator 沉淀出的 Skill 文件夹 macro-fundamentals-report/（打成 ZIP），加上 协作记录/触发测试记录.md。

---

附：回看这次协作

导出对话

在终端里运行的 Claude Code 输入：

/export 协作记录/对话记录_练习二.txt

会把这次会话的对话和工具输出写成一个文本文件。不带文件名只输入 /export，会弹出菜单，可以选复制到剪贴板或保存为文件。几段会话就导出几份：之前的会话用 claude --resume 从列表里找回，再 /export。

会话很长时，Claude Code 会自动“压缩”（屏幕上出现 Conversation compacted），把前面的对话换成一段摘要。压缩之后再 /export，导出的是摘要加压缩之后的内容，前面的原话不在里面。所以做长任务时，在每个练习做完时就导出一次；已经压缩了的，见常见问题“会话被压缩后导出不全”。

要记住的四件事

1. Skill 就是一个文件夹加一个 SKILL.md，放在项目的 .claude/skills/ 里（Codex 是 .agents/skills/）；第一次放进去后退出重开。
2. 它平时只带着描述，用到才读正文；描述决定它来不来，想不起来就点名 /技能名。
3. 装别人的 Skill 先读一遍：它要装什么、要做什么，签字的是你。
4. 先把一次任务做对，再把做对的方法写成 Skill；写完在新会话里测：该来的来，不该来的不来。