📘 课程 001：Introduction to Agent Skills（智能体技能体系导论）

归属体系：Anthropic 官方课程体系 / Claude 认证核心学习模块
存放路径：_Claude-exams/课程001 Introduction to agent skills/
学习目标：掌握 Claude Code 与 Agent Skills 核心机制，理解 Skills 与 CLAUDE.md、Hooks、Subagents 的架构边界，掌握渐进式信息披露与排障方法。

🎯 课程简介与导读 (About This Course)

📌 英文原版 (Original Text)

About this course
In this course, you'll learn how to stop repeating yourself and start teaching Claude once. You'll discover what Skills are and how they differ from other Claude Code customization options like CLAUDE.md, hooks, and subagents. You'll create your first Skill from scratch — writing the SKILL.md frontmatter, crafting effective descriptions that reliably trigger matching, and organizing your skill directory with progressive disclosure to keep context windows efficient. You'll also explore advanced configuration options like restricting tool access with allowed-tools and using scripts that execute without consuming context.

Beyond building individual Skills, you'll learn how to share them with your team by committing them to a repository, distribute them more broadly through plugins, and deploy them organization-wide using enterprise managed settings. You'll see how to wire Skills into custom subagents for isolated, expert task delegation, and you'll walk through a complete troubleshooting guide for diagnosing issues — from skills that won't trigger to priority conflicts and runtime errors. By the end, you'll have the knowledge to build a full Skills-based workflow that keeps Claude consistent, context-efficient, and aligned with your team's standards.

🇨🇳 架构师级精译中文版 (Professional Translation)

关于本课程
在本课程中，你将学会如何告别低效的重复指令，真正实现“一次教会 Claude，处处长期生效”。你将深入理解什么是 Skills（智能体技能），以及它与 Claude Code 体系中其他自定义配置选项（如 CLAUDE.md、Hooks（生命周期钩子） 和 Subagents（子智能体））的本质区别。

你将从零开始构建你的第一个 Skill —— 亲手编写 SKILL.md 的 Frontmatter（YAML 元数据前言），撰写能确保可靠触发语义匹配的高效 Description（描述字段），并通过 Progressive Disclosure（渐进式信息披露） 原则组织技能目录结构，从而最大限度保持 Context Windows（上下文窗口）的高效精简。你还将探索高级配置特性，例如通过 allowed-tools 严格限制工具调用权限，以及利用无需消耗上下文即可在后台运行的独立脚本。

除了构建单个技能之外，你还将掌握如何通过 Git 代码仓库提交与团队共享技能，通过 Plugins（插件体系） 进行更广泛的分发，并通过 Enterprise Managed Settings（企业级托管设置） 在全公司范围内统一分发与部署。你将学会如何把技能无缝接入自定义的 Subagents，以实现相互隔离且专业的专家级任务委派。最后，你将跟随一份详尽的 Troubleshooting Guide（故障排查指南） 掌握排查疑难问题的方法 —— 彻底解决从“技能无法触发”、到“优先级冲突”以及“运行时错误”等各类典型故障。

学完本课程后，你将具备完整搭建一套基于 Skills 的高效工作流的实战能力，使 Claude 始终保持回答一致性、上下文高效率，并与团队的技术工程规范严格对齐。

🧩 核心知识点与架构映射拆解 (Knowledge Breakdown)

知识领域	核心概念 / 机制	架构设计要点与考点解析
定制化形态对比	`Skills` vs `CLAUDE.md` vs `Hooks` vs `Subagents`	• `CLAUDE.md`：全局被动上下文规则，每次请求均占用 Token。 • `Skills`：按需动态挂载（On-demand），匹配时才加载内容。 • `Hooks`：确定性事件触发脚本（如执行前/执行后钩子）。 • `Subagents`：独立 Context 隔离的子任务专家。
技能工程结构	`SKILL.md Frontmatter` + 渐进式披露	• Frontmatter：`name` 与 `description` 决定意图匹配路由，必须清晰表述何时触发。 • Progressive Disclosure：只在主文档写核心指令，细节/脚本放在子目录，按需阅读，避免上下文撑爆。
权限与效能控制	`allowed-tools` + 零上下文脚本	• 工具白名单：用 `allowed-tools` 限制该技能只能调用指定工具，遵循最小特权原则。 • 免 Token 脚本：调用外部执行脚本完成重计算，将精简结果返回。
团队分发与治理	Repo 提交 ➡️ Plugins ➡️ 企业托管设置	从个人单机使用，演进到团队 Git 共享，再到跨项目插件包（Plugins），最终到企业 IT 策略统一托管。
故障排查体系	Troubleshooting 核心排错	• 技能不触发：排查 Description 意图描述与关键词覆盖。 • 优先级冲突：排查本地与全局同名 Skill 覆盖规则。 • 运行时错误：排查环境依赖与工具调用权限。

🔤 本课程高频考试生词与术语提炼 (Vocabulary Links)

troubleshooting / troubleshooting common issues：故障排查与疑难解答（对应本课排障指南）。
reusable：可复用的（Skills 本质上就是团队共享的可复用专家能力）。
progressive disclosure：渐进式信息披露（架构师控制上下文 Token 消耗的核心设计原则）。
subagents：子智能体（用于 Context 物理隔离的专家代理）。
frontmatter：元数据前言（Markdown 顶部的 YAML 键值对，用于路由索引）。
customization：定制、自定义、定制化配置（指 Claude Code 的 Skills、CLAUDE.md、Hooks 等多种客制化配置手段）。
scratch / from scratch：从零开始、从头起步；在提示词工程中常指草稿区（<scratchpad> 思考推导标签）。
reliably trigger：可靠触发、稳定激活（指 Skill 的 Description 或 Tool Definition 必须清晰，确保 Agent 语义路由高确定性命中）。
restricting / restrict：限制、约束、收紧权限（在 allowed-tools 中用于工具访问控制，遵循最小特权原则）。
allowed-tools：允许调用的工具白名单（SKILL.md 的 Frontmatter 保留键，用于限制 Agent 工具权限）。
consuming / consume：消耗、占用（指运行脚本时避免将大段文本读入上下文消耗 Token）。
individual：单个的、单独的、独立的（指从单体技能扩展为插件包分发，或子任务独立委派）。
repository (repo)：代码仓库、软件仓库（指将 Skills 提交至 Git 仓库以实现团队级共享与版本控制）。
organization-wide：全组织范围的、全企业级的（指通过企业托管设置 Enterprise Settings 统一向全员分发技能）。