跳到主内容

course materials · 2026 秋季本科

上机材料:三个练习导航

Week 4 · 2026-09-29 · 上机材料

返回本周材料

W04 三个递进练习的导航:每个练习做什么、用哪个 Skill;做完要交什么、开始之前在终端里用 Claude Code、导出对话与要记住的四件事。

切换上机材料(4 篇)

W04 学生材料包

ZIP · 约 0.9 MB

解压到桌面或下载文件夹,按手册把需要的文件拷进项目;保留一份不动,改坏了可以重新复制。含练习一的背景素材、练习二的备用宏观数据与要求、几个记录模板,以及手册(含配图)与常见问题的离线副本。Skill 本身不在包里,按手册从课程仓库下载。

下载材料包
本页目录

W04 材料入口 · 常见问题

三个练习,一个比一个进一步,三个都要完成:

练习做什么用到的 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 截图。

  1. 交互记录:你和 Claude Code 的对话,交 .txt 或 .md 文本文件,不收截图。在会话里输入 /export 文件名 导出(见文末“导出对话”);这个练习用过几段会话就导出几份,不用合并。交互记录里要能看出你审阅了 AI 的产物、提出了具体反馈、让它修改过;把手册整份丢给它“替我全部做完”,记录里看不出这些。
  2. 最终产物:
练习最终产物
练习一网页演示文稿的 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 回忆着补写。所以做长任务时,在每个练习做完时就导出一次;已经压缩了的,见常见问题“会话被压缩后导出不全”。

要记住的四件事

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