Claude Code Skills 完整指南

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

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

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

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

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

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

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

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

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

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

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