03. Claude Skills 与办公自动化

课时信息

📅 时间：课后 / 选修 🎯 目标：掌握 "Claude Code" 的核心扩展机制——Skills，让 AI 真正成为你的定制化 Agent

1. 什么是 Claude Skills?

你可能听说过 "Function Calling" (函数调用)，但 Claude Skills 是针对 Claude Code (CLI) 的一套更高级、更模块化的扩展标准。

它不仅仅是一个 JSON 定义，而是一个包含说明书和工具代码的完整能力包。 通俗理解：如果 Claude Code 是一个操作系统，那么 Skills 就是你可以安装的 "APP"。

• 传统 Tools: 只是告诉 AI "我有这个 API"。
• Claude Skills: 告诉 AI "这是怎么做这件事的完整SOP（标准作业程序）"，并附带了执行所需的脚本。

2. 核心结构：SKILL.md

一个标准的 Claude Skill 通常是一个文件夹，核心必须包含一个 SKILL.md 文件。

2.1 目录结构示例

my-pdf-skill/
├── SKILL.md          <-- 核心说明书
├── convert_pdf.py    <-- 具体的执行脚本
└── template.html     <-- 模板文件 (可选)

2.2 SKILL.md 怎么写？

这其实就是写给 AI 看的 "Prompt + 接口文档"。

# PDF Converter Skill

## Description
此技能用于将 Markdown 文件转换为精美的 PDF 报告。
当用户说 "把这个文档转成 PDF" 时，请激活此技能。

## Tools
主要的执行脚本是 `python convert_pdf.py`。

### convert_pdf
- 描述: 执行转换逻辑
- 命令: `python convert_pdf.py --input <input_file> --output <output_file>`
- 参数:
  - input_file:源 md 文件路径
  - output_file: 目标 pdf 路径

3. 工作原理：渐进式披露 (Progressive Disclosure)

Claude Code 并不是一次性把所有 Skill 的所有代码都塞进 Context (那样太费 Token 了)。它采用了一种极其聪明的机制：

1. Metadata Scan: 启动时，只读取所有 Skill 的 Description (极短，约100 tokens)。
2. Instruction Load: 当用户意图匹配某个 Skill 时（例如 "帮我生成 PDF"），才加载该 Skill 的完整 SKILL.md。
3. Execution: 只有真正执行时，才读取和运行具体的 Python/Bash 脚本。

这种设计让你安装几百个 Skills 也不会让 AI 变笨或变慢。

4. 如何获取与安装

4.1 官方与社区资源

• Skills Marketplace: skillsmp.com (查找现成 Skill 的好去处)
• Awesome Claude Skills: GitHub 上的 awesome-claude-skills 仓库收集了大量好用的工具。

4.2 安装方法

通常有两种方式：

1. 全局安装: 把 Skill 文件夹复制到 ~/.claude/skills/。
2. 项目级安装: 把 Skill 文件夹复制到你项目的 .claude/skills/ 目录下。

一旦文件就位，Claude Code 会自动识别，无需重启。

5. 实战：你的第一个 Skill

假设你想让 Claude 拥有一键 "格式化并检查代码风格" 的能力。

1. 创建文件夹 ~/.claude/skills/code-police/。
2. 创建 SKILL.md:

   # Code Police
   
   ## Description
   用于检查项目代码规范，并自动修复简单的格式错误。
   
   ## Tools
   ### run_check
   Running `npm run lint -- --fix` to auto-fix issues.

3. 下次你对 Claude 说 "检查一下代码规范"，它就会自动识别并运行这个命令，而不需要你每次都告诉它 "请运行 npm run lint"。

总结

Claude Skills 是 "Prompt Engineering + Scripting" 的完美结合。它把复杂的任务封装成简单的自然语言指令，是打造个人 AI 工作流的终极武器。