Claude Code 支持 Skills：Agent 能力复用从代码到 Markdown

2026-06-18 · Anthropic 文档

要点

Skills 系统上线：SKILL.md 格式定义 Agent 能力，按需加载不占 context
零代码：纯 Markdown + 可选脚本，非工程师也能写 Skill
社区爆发：GitHub 上已有 200+ 共享 Skills（部署、审计、迁移、文档生成）
Claude Code / Claude Desktop 均支持：Agent 模式自动识别和调用

它是什么

Skills 是 Claude Code 的「能力包」——你可以在项目根目录放一个 SKILL.md 文件，定义一组操作流程，让 Claude Code 在遇到相关任务时自动调用。

# SKILL.md
name: deploy-to-production
description: 标准化生产部署流程
trigger: deploy, 发布, rollout
steps:
  - 运行测试套件
  - 创建 Git tag
  - 触发 CI/CD pipeline
  - 验证部署状态
  - 发送 Slack 通知

Agent 遇到「帮我部署」这类请求时，会自动读取并执行这些步骤。

核心特性

1. 纯 Markdown 定义，无需写代码

# SKILL.md
name: database-migration
description: 安全执行数据库迁移
trigger: migrate, 迁移

steps:
  - 确认迁移脚本已 review
  - 在 staging 环境先跑
  - 备份当前数据
  - 执行 migration
  - 验证数据完整性

非工程师也能编写和维护——只要会写 Markdown 就能定义团队规范。

2. 自动触发，不占用 prompt

Claude Code 会解析 SKILL.md 的 trigger 字段，在遇到相关关键词时自动加载。不会像 system prompt 那样占用宝贵的 context 空间。

3. 可执行脚本

# SKILL.md
name: security-audit
description: 运行安全扫描

steps:
  - 运行 `npm audit --audit-level=high`
  - 检查依赖漏洞报告
  - 如有高危漏洞，列出修复方案

scripts:
  scan: npx security-checker scan .
  report: npx security-checker report --format=markdown

支持嵌入 Shell / Node.js / Python 脚本，Skills 可以真正执行操作。

4. 版本可控，Git 管理

Skills 放项目仓库里，可以：

随代码一起 review
分支管理，测试通过再合并
版本历史，回溯能力变更

社区 Skills 生态

GitHub 上已经涌现 200+ 共享 Skills：

类别	代表 Skill	功能
部署	`skill-deploy-vercel`	Vercel 一键部署
审计	`skill-security-audit`	依赖安全扫描
迁移	`skill-db-migration`	数据库迁移流程
文档	`skill-api-docs`	自动生成 OpenAPI 文档
测试	`skill-test-coverage`	提升测试覆盖率
CI/CD	`skill-github-actions`	GitHub Actions 工作流

Skills vs MCP：互补关系

很多人把 Skills 和 MCP 混为一谈，其实定位不同：

维度	MCP	Skills
解决的问题	「AI 能调用哪些外部工具」	「AI 怎么用这些工具」
格式	JSON Schema（代码）	Markdown（文档）
门槛	需要写代码注册	纯 Markdown，会写字就会
典型场景	连接 API、数据库、文件系统	定义部署流程、代码规范、审批流程
生命周期	工具级别的原子操作	流程级别的复合操作

最佳实践：用 MCP 接外部能力（工具），用 Skills 定义操作流程（规范）。

实际案例

案例 1：新工程师 Onboarding

# SKILL.md
name: project-onboarding
description: 新工程师环境配置

trigger: setup, onboard, 环境

steps:
  - 检查操作系统类型
  - 运行环境检测脚本
  - 安装依赖（npm install / pip install）
  - 复制环境变量模板
  - 启动本地开发服务
  - 运行 smoke test 验证
  - 输出下一步操作建议

新工程师说「帮我配置环境」，Claude Code 自动跑完整流程。

案例 2：Code Review 规范

# SKILL.md
name: code-review-checklist
description: 代码审查检查清单

trigger: review, pr, 代码审查

steps:
  - 检查是否有测试用例
  - 验证类型定义完整
  - 检查是否有安全漏洞（SQL注入、XSS等）
  - 验证错误处理
  - 检查命名规范
  - 输出审查报告

每次 PR review 都按团队标准走，不遗漏关键检查项。

AIHO 观点

Skills 的意义不在于「教 AI 新知识」，而在于**「固化团队最佳实践」**。

之前 Agent 的能力是代码——写一个 Python function，注册成 tool。门槛高、不可移植、改一次要发版。

Skills 降维到 Markdown 后：

新人不用看文档——说"部署"就按规范执行
能力可共享——一个 SKILL.md 文件发到 Slack 就能传播
版本可控——Skill 放 Git 仓库，随代码一起 review

预计 Skills 会成为 Agent 生态的「配方标准」——类似 Dockerfile 之于容器。

如何开始

在项目根目录创建 SKILL.md
参考 Anthropic 官方文档
从社区 Skills 库复制模板：Awesome Claude Skills
逐步把团队规范沉淀成 Skills