切换上机材料（4 篇）
本页目录
开始之前先看上机导航“开始之前”一节：在终端里用 Claude Code；要交什么见导航页“做完要交什么”。
这是“先把一次任务做对，再把做对的方法写成 Skill”的实践：先带着它把练习二的演示文稿一轮轮改对，再请 skill-creator 把你说过的意见整理成一个新 Skill。
练习二、三接着做，A–D 是递进步骤，不是四选一。 在练习二的 宏观基本面汇报/ 项目里，保留练习二的初版，另存修改版，按下面的顺序推进：
练习二初版 → A 多轮反馈与修改 → B 把做法沉淀为新 Skill → C 在新会话里测触发，通过后完整运行 → D 回看版本历史（用了 Git 的）。
A、B、C 依次完成；Git 是建议项，D 的 Git 操作适用于用了 Git 的同学，没用 Git 不必为了 D 另建仓库。新会话不等于新文件夹：触发测试仍在同一个项目里退出重开 Claude Code，不用搬走已有数据、规则或 Skill；完整运行时把新产物另存到项目内的 汇报_测试/，是为了与旧稿区分，不是换一个项目。
练习三要交三样：新 Skill 文件夹、交互记录、改过的演示文稿 HTML。几轮修改意见和触发测试都在对话里完成，交互记录里看得到，不用另交记录文件。
A. 多轮反馈
做什么：对练习二的演示文稿一轮一轮提意见，至少两轮。改的是练习二那一版之后的新版本，练习二那一版留着不动。每一轮：
- 在浏览器里看一遍，找出要改的地方，一次说清楚；
- 它改完，你刷新浏览器再看；
- 在对话里说清你看了之后满不满意、还要改哪里。你说了什么、它改了什么，交互记录里都看得到，不用另外写记录文件。想另记一份
协作记录/反馈记录.md，方便沉淀 Skill 时对照，可以，这是个人笔记，不用交。
建议用 Git 管理版本，每轮改完提交一次，提交说明写“第几轮：改了什么、为什么”，改坏了可以退回。
意见从下面五个方面找，要具体到能写进步骤：
| 方面 | 写得进步骤的意见举例 |
|---|---|
| 指标选择 | “少了金融类指标，加社融存量同比”；“社融增量每月波动太大，换成存量同比” |
| 口径 | “GDP 用当季同比，不用累计同比”；“同比变化写‘百分点’，不写‘%’”；“每条数据都带原发布链接和获取时间” |
| 图表 | “PMI 图加一条 50 的荣枯线”；“单位不同的指标分开画，不共用一根纵轴”；“图下三行：标题、单位、来源” |
| 结论表述 | “每条判断先写依据再写结论”；“‘事实’里不出现‘说明’‘意味着’”；“不写‘强劲复苏’这类没有数据撑着的词” |
| 版式 | “一页一个要点”；“判断页和事实页用不同底色”；“字号放大到后排能看清” |
“做得好看点”“再专业一点”写不进步骤；“PMI 加一条 50 的荣枯线”写得进。
做对了会看到：交互记录里有至少两轮，每轮写了你说的意见和它改了什么；浏览器里刷新后，每轮提的意见都能在页面上找到改动。
B. 用 skill-creator 沉淀
做什么
- 从课程仓库把
skills/skill-creator/整个文件夹拷进项目的.claude/skills/，退出重开 Claude Code，/skills里看得到skill-creator。用 Codex 的不用拷：Codex 自带skill-creator，点名用$skill-creator。 - 在同一个项目里，把下面这段指令发给它。若加载
skill-creator后已换了会话，先让它读取此前导出的真实交互记录，确认能找到你每轮提出的意见；有协作记录/反馈记录.md或 Git 历史的可一并参考，不让它凭记忆补写。示范指令也在材料包模板/沉淀指令_示范.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，不在项目里，也不跟着项目走。
- 读它给的草稿，对照你每一轮提过的意见逐轮看：
- 每一轮的意见都进了 Skill 吗？进在步骤、口径规定还是自检清单里？
- 有没有把这次的具体月份、数值写死（例如“2026 年 8 月 CPI 0.8%”）？有就让它改成做法（例如“先确认最新一期是哪个月”）。
- 正文里是不是写明了先调用
macro-data、再调用html-slides？取数一步有没有写逐条留痕？
- 确认后让它写文件。写完退出重开，
/skills里看得到macro-fundamentals-report。
做对了会看到：.claude/skills/macro-fundamentals-report/SKILL.md 存在，开头两道 --- 之间有 name: macro-fundamentals-report 和一段 description；正文里找得到你每轮反馈的影子，例如你说过“PMI 图加 50 荣枯线”，自检清单里就有这一条。
它开始跑评测、停不下来：按 Esc，再说一遍“不要跑评测，给我看草稿”。
C. 触发测试（在新会话里）
测的是：你照常说话时，它想不想得起这个新技能。要在新会话里测（退出重开），因为刚写完技能的那个会话里它记得前面的对话，测不准。
做什么：留在同一个项目里退出重开 Claude Code，先输入 /skills，确认列表里有 macro-fundamentals-report；没有就先按常见问题第 30a 条排查。确认加载后，不先让它读 SKILL.md，也不手动点名技能，分别发下面三句话（每句看清是否调用后可按 Esc 停下，再退出重开测下一句）：
| 句子 | 应当 |
|---|---|
| “帮我做一份中国宏观基本面分析的演示文稿” | 来：屏幕上出现 Skill(macro-fundamentals-report) |
| “看看近几年中国宏观数据，做几页分析” | 来 |
| “查一下上个月的 CPI 是多少” | 不来：这句只该用 macro-data 或直接回答 |
三句结果不符合预期，先按常见问题第 30a 条排查，不继续生成整份演示文稿：
- 该来没来：先核对当前会话是否加载了新 Skill，再检查
description是否写清任务和你的自然说法；修改后在同项目的新会话里重测。 - 不该来却来了：检查描述的适用范围，补清不适用的任务；修改后在新会话里重测。
- 手动点名可用来排查，但不代替自然触发测试；读了
SKILL.md或生成了 HTML，也不能据此认定触发通过。
三句结果符合预期后，再换一个时间窗口或指标组合完整做一次，例如“做一份近两年中国宏观基本面分析演示文稿，加上工业增加值，输出到项目内的新文件夹 汇报_测试/”。核对实际调用记录和取数过程，看它是按新 Skill 从取数做起，还是照抄项目里已有的演示文稿，再检查数据来源与成品。做完可以问它“你按哪个技能的第几步做的”，但要与过程记录对照。
测试的每句话、它来没来、换窗口那次做出了什么，都在对话里完成，交互记录里看得到，不用另交测试记录。想另记一份 协作记录/触发测试记录.md 也可以，是个人笔记，不用交。
✅ 自查：name 与文件夹同名，只用小写字母、数字和连字符；SKILL.md 第一行就是 ---，前面没有空行；三句测试的结果在对话里都看得到。
D. 回看版本历史（用了 Git 的）
用了 Git 的，把新 Skill 单独提交一次：对它说“把 .claude/skills/macro-fundamentals-report/ 单独提交一次，提交说明写‘沉淀新技能 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 单独一个节点。哪一轮改坏了，可以从这里找回那一轮之前的版本。
✅ 练习三自查
- 交互记录里看得出至少两轮反馈，每轮的意见具体到能写进步骤，也看得出它改了什么
- 新 Skill 在项目的
.claude/skills/macro-fundamentals-report/（Codex：.agents/skills/…），不在个人目录 - 说得出新 Skill 里哪几条来自你哪一轮的反馈
- 新 Skill 里没有写死具体月份和数值；写明了先调用
macro-data、再调用html-slides，取数时逐条留痕 - 新会话里两句该来的来了，一句不该来的没来；换窗口那次没有照抄旧文件
- 三句测试和换窗口那次的过程与结果，在对话里都看得到
本练习要交：新 Skill 文件夹 macro-fundamentals-report/（打成 ZIP）；交互记录（/export 导出的 .txt 或 .md，可多份，几轮修改意见和触发测试都在里面）；改过的演示文稿 HTML（有外部文件就连同打成 ZIP）。不用另交反馈记录、触发测试记录。