切换上机材料(4 篇)
W04 学生材料包
ZIP · 约 0.9 MB
解压到桌面或下载文件夹,按手册把需要的文件拷进项目;保留一份不动,改坏了可以重新复制。含练习一的背景素材、练习二的备用宏观数据与要求、几个记录模板,以及手册(含配图)与常见问题的离线副本。Skill 本身不在包里,按手册从课程仓库下载。
本页目录
三个练习,一个比一个进一步,三个都要完成:
| 练习 | 做什么 | 用到的 Skill | 项目文件夹 |
|---|---|---|---|
| 练习一:从 GitHub 装 html-slides,做一份网页演示文稿 | 从 GitHub 下载 html-slides,装进项目,用它做一份网页演示文稿 | html-slides | 网页演示练习/ |
| 练习二:两个 Skill 接力,做一份宏观基本面分析演示文稿 | 用 macro-data 取近三年中国宏观数据,再用 html-slides 做一份宏观基本面分析演示文稿,写出你对当前中国宏观基本面的判断 | macro-data + html-slides | 宏观基本面汇报/ |
| 练习三:一轮轮改,再沉淀成你的 Skill | 对练习二的演示文稿一轮轮提意见、让它改;再用 skill-creator 把取数、出页和你的意见沉淀成一个新 Skill,并测试它 | 前两个 + skill-creator | 同练习二 |
练习一学会的装法、重开、确认,练习二开头会再做一遍;练习二的演示文稿是练习三的起点。
本手册用到的 Skill 都在课程组的公开仓库 https://github.com/ai-lingnan/sysu-awesome-cc 的 skills/ 文件夹里,从那里下载,材料包里不附。材料包里有练习一的素材、练习二的备用数据和几个模板,见各练习“准备”一节。
每一步写两样:做什么;做对了会看到什么,可以逐项对照检查。几处附了实际画面的截图,供对照。灰底方框是电脑常识,已经会的跳过。
做完要交什么
练习一、二、三都要完成,三个都要交,缺一个就是没交齐。每个练习都交两部分:交互记录和最终产物。本周不交 Git 截图。
- 交互记录:你和 Claude Code 的对话,交
.txt或.md文本文件,不收截图。在会话里输入/export 文件名导出(见文末“导出对话”);这个练习用过几段会话就导出几份,不用合并。交互记录里要能看出你审阅了 AI 的产物、提出了具体反馈、让它修改过;把手册整份丢给它“替我全部做完”,记录里看不出这些。 - 最终产物:
| 练习 | 最终产物 |
|---|---|
| 练习一 | 网页演示文稿的 HTML(它生成的 html_deck_…/index.html);文件夹里还有图片、样式等外部文件的,把整个文件夹打成 ZIP。已经跟老师带做过的那一份,直接交那一份,不用再做一遍 |
| 练习二 | 宏观基本面分析演示文稿的 HTML(有外部文件就连同打成 ZIP),加上 协作记录/取数记录.md。交练习三修改之前的那一版 |
| 练习三 | 新 Skill 文件夹 macro-fundamentals-report/(打成 ZIP),加上改过的演示文稿 HTML(有外部文件就连同打成 ZIP) |
练习三的几轮修改意见和触发测试,都在对话里完成,交互记录里看得到;不用另交反馈记录、触发测试记录。
会话做到一半被压缩的:先 /export 导出当前这份记录,压缩之前导出过的那份也交,压缩前后的记录都交;不要让 AI 回忆着补写。
这三个练习和阶段作业 1 是两回事,阶段作业 1 的要求另行说明。
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 步)。
附:回看这次协作
导出对话
在终端里运行的 Claude Code 输入:
/export 协作记录/对话记录_练习二.txt
会把这次会话的对话和工具输出写成一个文本文件。不带文件名只输入 /export,会弹出菜单,可以选复制到剪贴板或保存为文件。几段会话就导出几份:之前的会话用 claude --resume 从列表里找回,再 /export。
会话很长时,Claude Code 会自动“压缩”(屏幕上出现 Conversation compacted),把前面的对话换成一段摘要。压缩之后再 /export,导出的是摘要加压缩之后的内容,前面的原话不在里面。做到一半被压缩的,先 /export 导出当前记录,压缩之前导出过的那份也交,压缩前后的记录都交,不要让 AI 回忆着补写。所以做长任务时,在每个练习做完时就导出一次;已经压缩了的,见常见问题“会话被压缩后导出不全”。
要记住的四件事
- Skill 就是一个文件夹加一个
SKILL.md,放在项目的.claude/skills/里(Codex 是.agents/skills/);第一次放进去后退出重开。 - 它平时只带着描述,用到才读正文;描述决定它来不来,想不起来就点名
/技能名。 - 装别人的 Skill 先读一遍:它要装什么、要做什么,签字的是你。
- 先把一次任务做对,再把做对的方法写成 Skill;写完在新会话里测:该来的来,不该来的不来。