Claude Code 进阶指南:Skills、Subagents 和 MCP,官方文档没写的实战经验<

一、这篇文章是写给谁的

你用过 Claude Code,觉得还行,但总感觉没发挥出全部实力。

前面的那篇「Claude Code 完全指南:一位资深工程师的实战心得」,讲的是基础用法和常见的坑。这篇是第二部分,直接进深水区:Skills(技能)、SubAgents(子代理)、MCP(模型上下文协议)。

这三个功能官方文档都有。问题是文档只说是什么,不说怎么组合、哪些配置有用。Eyad 花了几周才搞明白,有些靠反复试错。他写出来,省别人的时间。

本文编译自 Eyad Khrais 的 Twitter 长文《The Claude Code Tutorial Level 2》。Eyad 是 7 年经验的工程师,在 Amazon、Disney、Capital One 待过,写的代码服务过数百万用户。我在翻译的基础上加了些自己的理解。

读完的感受:这不是功能介绍,是实战手册。


二、上下文窗口

讲高级特性之前,有个底层问题要说清楚。

你可能觉得不同 AI 编程工具处理上下文的方式差不多。不是的。

Qodo 工程团队做过对比:Claude Code 提供货真价实的 200K token 上下文窗口。Cursor 理论上也是 200K,实际使用往往达不到,因为内部有截断机制控制性能和成本。这些机制静默执行,你不知道上下文被砍了。

这不是说 Cursor 不好。工具针对不同场景优化。小项目、文件关系简单,Cursor 够用。但大型项目里,认证系统连着 API 路由、API 路由连着数据库 schema,上下文完整性就很重要了。

Skills、Subagents、MCP 在 Claude Code 里效果好,原因之一就是它们依赖可预测的完整上下文。


三、Skills:把工作流教给 Claude

3.1 什么是 Skill

Skill 是一个 Markdown 文件,告诉 Claude 如何处理特定任务。你的问题命中适用场景,Claude 自动调用。


结构简单:

全局 Skill(所有项目生效):

~/.claude/skills/your-skill-name/SKILL.md

项目级 Skill(和团队共享):

.claude/skills/your-skill-name/SKILL.md

3.2 怎么写 SKILL.md

每个 SKILL.md 以 YAML frontmatter 开头:

---
name: code-review-standards
description: Apply our team's code review standards when reviewing PRs or suggesting improvements. Use when reviewing code, discussing best practices, or when the user asks for feedback on implementation.
---

description 字段很关键。Claude 根据它判断什么时候用这个 Skill,要写具体,把触发条件说清楚。

你也可以直接告诉 Claude "使用 xxx skill",它会照做。但理想状态是让它自己识别。

一个 Git 提交消息生成的例子:

---
name: commit-messages
description: Generate commit messages following our team's conventions. Use when creating commits or when the user asks for help with commit messages.
---

# Commit Message Format

All commits follow conventional commits:

-feat: new feature
-fix: bug fix
-refactor: code change that neither fixes nor adds
-docs: document ationonly
-test: adding or updating tests

Format: `type(scope):description`

Example: `feat(auth): add password resetflow`

描述保持 50 字符以内。如果需要更多上下文,加一个空行然后写正文。

Eyad 说一开始用这种格式写 commit message 有点别扭,毕竟正常人不这么写句子,但质量提升肉眼可见。

3.3 渐进式加载

架构上有个关键设计:Claude 启动时只预加载每个 Skill 的名称和描述,大概每个 100 token。完整指令只在需要时才加载。

你可以装几十个 Skill,不会让上下文臃肿。

Skill 需要引用大量参考资料的话,放单独文件里,在 SKILL.md 中引用。Claude 需要时才读。

3.4 Skill 不只写代码

Eyad 见过工程师用 Skill 做各种事:

  • 自家数据库 schema 的查询模式
  • 公司 API 文档格式
  • 会议记录模板
  • 个人生活流程,做饭计划、旅行预订

发现规律:你反复向 Claude 解释同一件事,就可以做成 Skill。

查看当前加载了哪些 Skill:直接问 Claude 「你有哪些可用的 skills?」


四、Subagents:隔离上下文并行处理

4.1 什么是 Subagent

Subagent 是独立的 Claude 实例,有自己的上下文窗口、系统提示和工具权限。

Claude 把任务委派给 Subagent,Subagent 独立运行,完成后把总结返回给主对话。

为什么需要?上下文质量随着使用下降。Eyad 提到,上下文占用超过 45% 时效果就开始变差。Subagent 让你把复杂任务"外包"给新鲜的上下文,只带回相关结果。主对话保持干净。

4.2 内置三个 Subagent

Explo…

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