Claude Code 教程丨Skill 与 MCP:工作流与外部工具

 

你有没有遇到过这种情况:每次让 Claude 做代码审查,都要重复说一遍"先看改动范围,再检查测试覆盖,最后按风险分级输出"?

说多了,真的挺累的。

Skill 要解决的就是这个问题:把工作方法写下来,让 Claude 记住,以后直接执行。

而 MCP 解决的是另一个问题:让 Claude 能连上 GitHub、Notion、Slack 这些外部系统。

这两个配合起来,才能真正实现"一句话交代,AI 自主完成":


先把背景说清楚

Claude Code 里的 Skill 不是随手起的功能名。官方把它定位为可重用的知识和可调用的工作流。我们平时看到的 SKILL.md、/review-pr、/deploy,都是这一类。

更重要的是,Claude Code 的 skills 遵循 Agent Skills 开放标准。这是 Anthropic 参与制定的开放规范,不只是 Claude Code 能用,其他支持这个标准的 AI 工具也能用。

MCP(Model Context Protocol)则是另一条线。这是 Anthropic 在 2024 年 11 月开源的协议,目标很明确:让模型能接上外部系统——数据库、GitHub、Slack、Notion、浏览器等。

把这几个概念分清楚,后面就不容易混:

  • • Skill:用自然语言写的工作流定义
  • • Agent Skills:Skill 遵循的开放标准
  • • MCP:连接外部工具的开放协议
  • • Plugin:把 skills、hooks、agents、MCP servers 打包分发的机制

Skill:用自然语言写工作流

Skill 是一份用自然语言写的操作说明。它告诉 Claude:这类任务先做什么、中间查什么资料、哪些地方要小心、最终以什么格式交付。

最简单的 Skill 示例

文件结构:

.claude/
  skills/
    review-pr/
      SKILL.md

SKILL.md 内容:

---
name: review-pr
description: 审查当前改动,按风险、可读性和测试覆盖整理结论
disable-model-invocation: true
---


按下面顺序完成审查:

1.
 先看当前分支的改动范围
2.
 再看受影响的核心文件
3.
 检查有没有明显的范围问题和回归风险
4.
 检查测试是否覆盖到关键改动
5.
 最后用"高风险 / 中风险 / 低风险 / 建议"四段格式输出

这份 Skill 没有写业务代码,但已经把完整的审查流程交给了 Claude。

输入 /review-pr,Claude 就会按这个流程执行。


Skill 和脚本的区别

Skill 最适合那些会反复出现,每次顺序都差不多的任务。

代码审查、发布说明整理、日报周报、部署前检查,这类任务的特点是:有稳定步骤,但不是固定脚本能一次写死的。

举个例子——发布说明整理:

脚本能做的:把 git log 拉出来。

Skill 能做的:告诉 Claude 先看这次改动涉及哪些模块,再按"新增 / 修复 / 调整"分组,如果有对用户可见的变化要单独提出来,最后整理成适合发公告的版本说明。

这就是核心区别:

  • • 脚本:固定命令序列,死板执行
  • • Skill:带判断的流程说明,Claude 能根据上下文调整

脚本是死的,Skill 是活的——因为执行者是能理解的 AI,不是机械的解析器。


最值得先记住的一个设置

Skill 的 frontmatter 字段不少,但真正最值得先记住的是 disable-model-invocation: true。

只要这份 Skill 会发消息、会部署、会提交、会改远端资源,就把它设成手动触发。这样做不是更麻烦,而是把主动权掌握在自己手里。

  • • /review-pr 这种审查类 Skill,自动调用问题不大
  • • /deploy、/send-slack 这种会产生结果的 Skill,最好手动调用

怎么写出好用的 Skill

很多人第一次写 Skill,容易把它写成"什么都想交代"的大杂烩——项目背景写一段,接口文档贴一段,注意事项写十几条。看起来很完整,用起来反而散。

一份好用的 Skill,通常有三个特点:

  1. 1. 主文件短:只写目标、顺序、判断和交付
  2. 2. 资料分散:大段内容放到 examples.md、template.md,需要时再加载
  3. 3. 关键操作手动触发:会改远端资源的动作,默认加上 disable-model-invocation: true

SKILL.md 负责告诉 Claude "这类事该怎么做",不负责替项目 wiki 兜底。


不好的写法

  • • 把所有背景资料一次性塞进去
  • • 每条都像规定,但轻重缓急不分
  • • 没有交付格式
  • • 没有判断标准

结果:Claude 每次都能做一点,但每次做出来都不太一样。


更好的写法

文件结构清晰:

.claude/
  skills/
    release-note/
      SKILL.md
      examples.md
      template.md

SKILL.md 里只保留几件事:

  • • 这份 Skill 是拿来做什么的
  • • 先做哪一步,再做哪一步
  • • 哪些地方不要乱猜
  • • 最终以什么格式交付

发布说明这类任务,真正值钱的不是"会不会跑 git log",而是能不能分清改动范围、能不能把用户能感知的变化单独提取出来。

Skill 不是把代码搬进自然语言,而是把一套长期重复的做事方式写清楚。


一个实用的 Skill 范例

下面这份发布说明 Skill,比"字段列一排、规则写一堆"的写法更实用:

---
name: rele…
— 以上为试看内容(约 40%),开通会员后阅读全文 —