📘 第 8 课：Skills（技能）

官方课程名：Skills（Curriculum 第二段「Teaching your Agent」收官课） 官方地址：https://anthropic.skilljar.com/claude-platform-101 归档路径：Claudeexams/20-课程/课程003 the AI Platform 101/ 针对认证：CCAR-P（架构师 Professional） 归档日期：2026-10-14 ⚠️ 语料来源：官方 Skilljar 课程正文（用户提供，需登录）。CC BY-NC-SA 4.0，仅供个人学习。

⭐⭐ 本课权重提示：领域 2 复用策略的「正名课」。CCAR-P 考纲领域 2 白纸黑字写着「实现提示复用策略（caching、模块化提示、Skills）」—— 本课就是那个 Skills 在平台侧的落地讲。同时命中领域 3（19%）的扩展机制（挂载点、beta 通道、与 code execution 组合）与领域 7（7%）的团队标准化叙事。与第 7 课合读：工具三分法管 what，本课的 Skills 管 how。 🔗 跨课对照：课程 001《Introduction to agent skills》讲的是 Skills 在 AI Code Assistant 语境（PROJECT.md、Hooks、allowed-tools 白名单）；本课是同一概念在 Platform / API 语境（SKILL.md 上传、container 挂载、beta 端点）。两课共享「渐进式披露（progressive disclosure）」同一机制。

🎯 本课学习目标

⚠️ 本课官方未提供 What you'll learn 区块。以下按文稿结构反推：

1. 能说清 Skills 是什么：指令 + 脚本 + 资源的文件夹，核心是一份 SKILL.md，上传一次、挂到任意 messages.create 调用。
2. ⭐⭐ 能背出 Skills vs. tools 判别句：tools 是 what the AI can do，Skills 是 how you want it done。
3. ⭐⭐ 能讲清渐进式加载机制：启动只装 name + description，agent 判定相关才把全量 Skill 装进上下文。
4. ⭐⭐ 能写出 / 读懂上传（client.beta.skills.create）与挂载（container.skills + betas）两段代码。
5. ⭐ 能说清 Skills 与 code execution 的搭配理由：Skill 规程要干真活（跑脚本）。
6. 能讲出生产价值：一个团队用同一 Skill 端点让所有人的输出同构同序。

📖 一、Skills 是什么（What Skills are）

官方原句： Skills are folders of instructions, scripts, and resources that the AI loads dynamically to improve performance on specialized tasks.* At the core of every Skill is a SKILL.md file — a packaged set of instructions you upload once and then attach to any messages.create call*.

精译：Skills 是指令、脚本与资源的文件夹，the AI 会动态加载它们来提升在专门任务上的表现。每个 Skill 的核心是一份 SKILL.md 文件 —— 一套打包好的指令，你上传一次，然后挂到任意一次 messages.create 调用上。

官方原句： You're teaching the AI how you do something*: your status report format, your review checklist, your release notes. the AI reads the Skill, follows the procedure, and produces output in your shape.***

精译：你在教 the AI 你做某件事的方法：你的状态报告格式、你的审查清单、你的发布说明。the AI 读这个 Skill、照着规程执行，然后产出符合你形状的输出。

⭐⭐ 三个记忆锚点

📖 二、Skills vs. Tools（本课第一判别句）

官方原句： Tools connect the AI to data and actions.* "Look up this code section," "send this email" — the AI calls the tool, and something else runs.***

精译：工具把 the AI 接到数据与动作上。「查这段代码」「发这封邮件」 —— the AI 调用工具，别的东西去运行。

官方原句： Skills teach the AI a procedure.* "Generate the daily status report following this template" — it's a playbook the AI reads and follows, which sometimes means running bundled scripts itself*.

精译：Skills 教 the AI 一套规程。「按这个模板生成每日状态报告」 —— 它是一本 the AI 读了照办的战术手册，有时这意味着亲自运行捆绑的脚本。

⭐⭐ 判别句（必背）

A simple way to remember it: tools are about what the AI can do, while Skills are about how you want it done. 「工具关乎 the AI 能做什么；Skills 关乎你想让它怎么做。」

⭐⭐ 渐进式加载（渐进式披露的平台版）

官方原句： Skills don't load fully into context on startup.* Only the name and description load at first. When your agent decides a Skill is relevant, it then loads the full Skill into context. That keeps your context lean* even when many Skills are available.

精译：Skills 不会在启动时全量装进上下文。起初只加载名称与描述。当你的 agent 判定某个 Skill 相关时，才把完整 Skill 装进上下文。这样即使挂了很多 Skills，你的上下文依然精简。

🔗 与课程 001 的「渐进式披露（progressive disclosure）」同一机制（表 01-047 disclosure 已收）；也与课程 002 的 4D 动态性呼应：Skill 是动态资源，不是一次性序列（表 02-063）。

📖 三、上传 Skill（Uploading a Skill）

官方原句： Skills are uploaded once to your workspace, then referenced by ID. You can upload directly on the the AI Platform, or do it programmatically.

精译：Skills 上传一次到你的工作区，之后按 ID 引用。可以直接在 the AI Platform 页面上传，也可以以编程方式上传。

skill = client.beta.skills.create(
    display_title="Status Report Generator",
    files=files_from_dir("status-report-skill"),  # folder containing SKILL.md
)

print(skill.id)  # reference this ID in future requests

代码拆解

官方原句： All the rules for what makes a good status report — sections, tone, how to summarize, how to handle blockers — live in a Skill packaged ahead of time. The activity log itself is just a string passed in at request time.

精译：一份好状态报告的所有规则 —— 章节、语气、怎么汇总、怎么处理阻塞项 —— 都住在提前打包好的 Skill 里。活动日志本身只是请求时传入的一个字符串。

⭐⭐ 「提前打包 vs. 请求时传入」是本课的分工公式：怎么写进 Skill（静态、复用）；数据本身走请求参数（动态、每次变）。这正是缓存与复用的架构直觉。

📖 四、挂载到请求（Attaching a Skill）

官方原句： Skills attach to a request through the container configuration — a skills array inside the container, where each entry names a skill_id and version.

精译：Skills 通过容器配置挂到请求上 —— 容器里有个 skills 数组，每个条目写明 skill_id 与 version。

response = client.beta.messages.create(
    model="current-model-fast",
    max_tokens=4096,
    betas=["skills-2025-10-02", "code-execution-2025-08-25"],
    container={
        "skills": [
            {
                "type": "custom",
                "skill_id": skill.id,
                "version": "latest",
            }
        ]
    },
    tools=[
        {
            "type": "code_execution_20250825",
            "name": "code_execution",
        }
    ],
    messages=[
        {
            "role": "user",
            "content": f"Generate the daily status report from this activity log:\n\n{activity_log}",
        }
    ],
)

官方点名的三个要点

📖 五、运行与生产价值（Running it）

官方原句： The output is a status report formatted exactly the way the Skill says to format it. Sections, tone, blocker handling — all of it comes from the SKILL.md file you uploaded. The user prompt is one line; the procedure lives in the Skill.**

精译：输出是一份完全按 Skill 说的格式排版的状态报告。章节、语气、阻塞项处理 —— 全部来自你上传的那份 SKILL.md。用户提示词只有一行；规程住在 Skill 里。

官方原句： In a production app, this is how a team standardizes output across an entire feature. With this daily status report endpoint, every PM gets the same structure, the same tone, the same sections, in the same order — without anyone copy-pasting a template into a prompt.

精译：在生产应用里，这就是一个团队让整个功能的输出标准化的方法。有了这个每日状态报告端点，每个 PM 拿到的都是同样的结构、同样的语气、同样的章节、同样的顺序 —— 没有任何人需要把模板复制粘贴进提示词。

⭐⭐ 领域 7 叙事：复用的收益不只是省 token，而是组织级一致性 —— 把「格式约定」从人脑与聊天记录里搬进版本化的 Skill 资产。

📌 六、Recap（官方六条要点）

🧠 本课 → CCAR-P 考点映射

⭐ 战略结论：本课短小但考点密度高 —— 领域 2 考纲原词直接命中，判断题（Skill 还是 tool）、机制题（挂载点、三处 beta）、场景题（团队标准化）三种题型都能从这里出。

🔤 本课新生词（已回灌 30-单词表/03，2026-10-14）

✅ 本课进度

• [x] 全文精译与架构师级拆解（2026-10-14）
• [x] ⭐⭐ 记录 Skills vs. tools 判别句与渐进式加载机制
• [x] 记录上传 / 挂载两段代码与「三处 beta」要点
• [x] 生词回灌 30-单词表/03-考试核心生词与术语表.md（2026-10-14：新增速查 39 条 → 全表 340 条；新升级精讲 6 条 029–034）
• [x] 保存本课英文原文（23-English-08-Skills.md）
• [ ] 跑通本课 runnable demo（需 Console 账号 + API key + 预付费额度）
• [ ] 官方未提供 What you'll learn 与练习区块 —— 若后续页面补全，需回填

🔗 关联

• 本课英文原文：23-English-08-Skills.md ✅ 已存（2026-10-14）
• 上一课对照：第 7 课 Built-in tools（工具三分法 → 本课 Skills 是「how」的那一半）
• 跨课同源：课程 001 导读（Skills 在 AI Code Assistant 语境）
• 课程大纲：01-课程导读与大纲全景
• 考纲：00-CCAR-P备考蓝图
• 生词表：30-单词表/03-

⚠️ 语料说明：英文原文中的 model="current-model-fast" 等为抓取/去品牌化残留；其余英文引句均为官方原句，未作改动。