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…