章节主旨
现场演示用 Claude Skills 格式构建一个名为 generate-report 的技能:把免费天气 API 与一份 Canva 模板 PDF 喂给 Claude Code,让它自动产出一份加拿大周天气报告 PDF,借此说明资产生成工作流的通用套路。
核心论点
- Claude Skills 与 Claude Code 的 do 格式本质相同,只是高度 Claude 特定的一种封装。(→ 详解1)
- 生成资产型 skill 只需三样:数据源 + 模板 + 等它自退火约 5 分钟,拖一份 PDF 进去就能当模板。(→ 详解1、详解4)
- skill 的 YAML front matter 按需加载,只有在决定用哪个 skill 前才读入 context,因此省 token。(→ 详解2)
- 遇到 API 不免费,直接让 agent 换免费替代源,不必自己纠结。(→ 详解3)
知识点详解
1. 构建 generate-report skill 的流程 2:32:15
任务很简单:创建一个新 skill generate-report,用某个公开天气 API 生成加拿大的周天气报告。Nick 直接 Google 「weather API」把链接贴进去,坦言不确定能不能用,边做边试。
模板部分,他去网上下载一份免费的 report 模板,在 Canva 里导出为 PDF(全页),再把这个 PDF 文件拖给 Claude Code,并注明「这是我要你用的橙黑现代年报模板」。
因为 Claude Code 原生就懂如何生成 Claude skill,它随即创建 skill 的目录结构、写入带指令的 skill.md,并去抓取天气数据。整个过程基本是它自己跑完。
2. skill 的目录结构与 YAML front matter 2:34:26
生成出来的 skill 里有一个 skill.md,还有一个 scripts 文件夹用来放脚本。skill.md 顶部是一段 YAML front matter(三条短横线之间的部分)。
front matter 包含 name、简短 description,以及 allowed tools。allowed tools 让你能很细粒度地控制 agent 对这些工作流的访问权限。
关键机制:这段 front matter 只有在 agent 决定要用哪个 skill 之前才被加载进 context。这样它不必读取每个文件的全部内容,能省下不少 token。
3. API 不免费就换免费源 2:34:39
拿 API key 时踩坑:OpenWeatherMap 号称免费,实际要注册并填支付信息。Nick 没去填,而是直接告诉 agent「它不免费,去找一个真正免费的源」。
agent 随即找到一个免费替代源(open-meteo),并据此重写脚本。这体现了概率系统的一种用法——把「找可用替代方案」这类判断直接外包给 agent,而不是人工逐个排查。
改完后它自行测试这个 skill,自退火(self-annealing)收敛,最终生成出文件。
4. 资产生成工作流的通用性 2:35:52
打开生成的 PDF:「Canada Weekly Weather 2025」,含目录、全国概览、天气亮点、西海岸 / 草原 / 中部加拿大等分区。用一份 PDF 当模板,拖进去就能得到能调用工具、产出干净排版文档的原生智能。
这只是众多资产生成工作流之一。同一套路可以秒生成 proposal、任意 PDF、定制资产或幻灯片。
通用配方就一句话:一个数据源、一份模板本身,再等它自退火约 5 分钟生成。
术语
- Claude Skills(Claude 技能):Claude 特定的一种能力封装格式,含
skill.md+ scripts,与 Claude Code 的 do 格式本质相同。 - YAML front matter(前置元数据):
skill.md顶部三条短横线之间的配置块,含 name / description / allowed tools。 - allowed tools(允许工具):front matter 中声明该 skill 可用哪些工具,用于细粒度权限控制。
- self-anneal(自退火):agent 反复测试并自我修正直到收敛可用的过程。