今天讨论 Claude Code 的扩展体系，很容易卡在一个看似简单的问题上，已经有了 Skill，为什么还要 Subagent。两者都能让 Claude Code 变强，都能封装经验，都能减少重复沟通，但它们解决的不是同一类问题。Skill 更像我们放在团队工具箱里的标准件，API 设计规范、发布流程、代码审查清单、故障排查步骤，都可以做成可复用内容。Subagent 更像临时拉出来的一位独立同事，自己开一个上下文窗口，自己读文件、查日志、跑搜索，做完以后把结论带回主对话。Claude Code 官方文档对 Skill 的定位很清楚，创建一个SKILL.md文件，Claude 就能把它加入自己的工具箱，相关时自动使用，也可以通过/skill-name直接调用。更关键的是，Skill 的正文并不像CLAUDE.md那样每次会话都完整进入上下文，完整内容通常只在被调用时才加载，所以长参考资料在未使用之前不会持续挤占主上下文。(Claude Platform Docs)这就解释了一个工程实践里的常见选择。项目里有一套固定的 REST API 风格，命名规则、错误格式、分页约定、审计字段写法都很稳定，这类内容适合做 Skill。因为它不是一次性任务，而是我们希望 Claude Code 在多个上下文里都能复用的知识。拿 SAP Fiori / RAP 项目来说，消费视图的注解组织方式
