Claude Code Skills 完整指南

什么是 Claude Code Skills

Skills 是 Anthropic 在 Claude Code 中引入的核心扩展机制：通过一个个独立的「技能定义」告诉 Agent 「遇到 X 场景时，应该怎么做」。Skills 让 Claude Code 从「通用 AI 编程助手」升级为「懂你团队规范、懂你业务领域的 AI 工程师」。

Anthropic 官方推荐：所有企业团队部署 Claude Code 时，必须基于 Skills 做团队规范化沉淀。

Skills vs Plugins vs Commands 对比

1. Commands（命令）：固定流程的快捷指令，参数透明，行为可预期
2. Plugins（插件）：第三方集成包，扩展 Claude Code 的工具集
3. Skills（技能）：上下文敏感的规则、流程、SOP，由 Agent 自动激活

三者并不互斥，Skills 与 Commands 是最常用的组合：Commands 触发流程、Skills 注入领域规则。

一个 Skill 的标准结构

每个 Skill 通常包含 4 个要素：

1. name：唯一标识，如 «java-spring-boot-conventions»
2. description：什么场景下激活（Agent 用它来判断是否调用此 Skill）
3. guidance：具体规则、SOP、风格约束
4. examples（推荐）：1-2 个正反例，让 Agent 直观理解期望

5 类企业最常用的 Skills

1. 语言/框架规范类：Spring Boot 项目结构、React 组件规范、Python Pydantic 模式
2. 领域语义类：业务术语、领域事件命名、领域模型 schema 规则
3. 测试规范类：单测覆盖、Mock 策略、集成测试模板、E2E 用例
4. 安全合规类：敏感信息处理、SQL 注入防护、依赖审计规则
5. 团队工作流类：PR 描述格式、Commit Message 规范、Code Review checklist

团队 Skills 工程化治理

很多团队上手 Skills 后陷入「写完就忘」的状态：30+ 个 Skills 散落在每个人本地，半年后没人维护。我们建议建立 4 个治理动作：

1. 仓库化：把团队 Skills 沉淀到独立 git 仓库，所有人共用同一份
2. 版本化：Skills 变更走 PR + Review，避免单方修改
3. 覆盖率追踪：每月统计哪些 Skills 被实际激活、哪些从未被用过
4. 季度复盘：基于近 3 个月 Code Review 发现的新问题，回流到 Skills 库

这套 Skills 治理体系是红烁 AI 的 Claude Code 企业培训中的标配内容。

→ Claude Code 培训详情 · → Claude Code MCP 集成 · → AI 编程规则模板

红烁四大解决方案

业务、研发、管理三线一体落地