Claude Code Skills 系列的第一篇

大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。

你是否有过这样的经历：每次打开 Claude 对话框，都要粘贴一段几百字的”背景说明”；团队里每个人对 AI 的用法各有一套，协作时鸡同鸭讲；辛苦调教出来的 Prompt 存在备忘录里，下次又忘了复制——

这些痛点，Claude Code Skills（技能）系统正是为此而生。

本文是 Claude Code Skills 系列的第一篇，带你彻底搞清楚：Skills 是什么、解决什么问题、从哪里开始。

Claude Code 是 Anthropic 推出的官方命令行工具（CLI），让你在终端里直接与 Claude 协作写代码。它不只是一个简单的聊天界面，而是一个具备文件读写、代码执行、Git 操作等能力的智能编程助手。

# 安装 npm install -g @anthropic-ai/claude-code # 启动 claude

Claude Code 的核心扩展机制，就是本系列要讲的主角：Skills（技能）。

问题描述 Prompt 重复粘贴每次对话都要重新说明项目背景、技术栈、代码规范团队不一致不同同事对 AI 的指令风格各异，输出质量参差不齐工作流不可复用好不容易调出来的工作流，下次还得重新摸索上下文容易遗忘长对话中 Claude 容易"忘记"早期的约定

Skills 本质上是可复用的、可共享的 AI 工作流配置文件。你把工作流、规范、知识封装进一个 SKILL.md 文件，Claude 就能随时"加载"并精确执行——无需重复说明。

每个 Skill 是一个目录，核心文件是 SKILL.md：

.claude/skills/my-first-skill/ └── SKILL.md

SKILL.md 由两部分组成：

① YAML 前置配置（Frontmatter）

--- name: commit-helper description: 生成符合 Conventional Commits 规范的提交信息。当用户说"帮我写提交信息"或"生成 commit message"时触发。 allowed-tools: [Read, Bash, Edit] user-invocable: true ---

② Markdown 正文（指令内容）

 工作流程 1. 运行 `git diff --staged` 查看暂存的变更 2. 分析变更类型（feat/fix/docs/refactor/chore 等） 3. 生成符合格式的提交信息：` 
        
          ( 
         
           ): 
          
            ` 
           
          
          格式规范 - 标题不超过 72 个字符 - 使用祈使句，如"Add"而非"Added" - 如有 Breaking Change，标注 `BREAKING CHANGE:`

手动触发（斜杠命令）：

/commit-helper

自动触发（语义匹配）： Claude 在会话开始时读取所有 Skill 的 description 字段，当你的自然语言请求与描述匹配时，自动加载对应 Skill。

你：帮我写一下这次的提交信息 Claude：（自动加载 commit-helper Skill，分析 git diff 后生成规范的提交信息）

位置作用范围适用场景 ~/.claude/skills/ 全局（个人）跨项目的个人习惯 .claude/skills/ 项目级团队共用，提交到 Git

优先级：项目级 > 全局级

推荐将项目级 Skills 提交到 Git 仓库，这样整个团队都能使用同一套 AI 工作流。

在你创建自己的 Skills 之前，Claude Code 已经内置了一批实用命令：

命令功能 /help 列出所有可用命令（含自定义） /clear 清除当前对话历史 /compact 压缩历史记录，节省上下文空间 /model 切换 AI 模型 /config 打开配置界面 /hooks 管理生命周期钩子 /permissions 查看和管理工具权限 /status 查看当前配置层级状态 /init 自动生成项目 CLAUDE.md 文件

除了 Skills，Claude Code 还有一个重要文件：CLAUDE.md。

它是 Claude 在每次会话开始时自动读取的项目说明文档，相当于给 AI 的”入职指南”：

# 项目说明

技术栈 - 前端：React 18 + TypeScript - 后端：FastAPI + PostgreSQL - 包管理：pnpm

开发规范 - 提交信息遵循 Conventional Commits - 所有函数必须有 JSDoc 注释 - 禁止使用 any 类型

常用命令 - 启动开发服务器：pnpm dev - 运行测试：pnpm test - 代码检查：pnpm lint

**实践：CLAUDE.md 保持简洁，详细规范通过链接指向其他文档，而不是全部塞进来。

mkdir -p .claude/skills/code-review

--- name: code-review description: 执行代码审查，检查代码质量、安全漏洞和性能问题。当用户说"帮我 review 代码"或"代码审查"时触发。 allowed-tools: [Read, Grep] user-invocable: true ---  代码审查清单 请按照以下维度检查指定文件或当前变更：  1. 代码质量 - 函数是否职责单一？ - 变量命名是否清晰？ - 是否有重复代码？  2. 安全性 - 是否存在 SQL 注入风险？ - 用户输入是否经过校验？ - 敏感信息是否硬编码？  3. 性能 - 是否有 N+1 查询问题？ - 循环内是否有不必要的计算？ 输出格式：使用 Markdown 表格，列出文件名、问题描述、严重程度（高/中/低）和修改建议。

在 Claude Code 中输入：

/code-review

或自然语言：

帮我 review 一下 src/api/auth.ts 这个文件

不必所有 Skill 都自己写，社区已经有大量现成的：

skills.sh：官方 Skill 市场，通过 npx skills add 一键安装
awesome-claude-code：GitHub 上的精选 Claude Code 资源列表

安装社区 Skill：

npx skills add anthropics/commit-helper npx skills add community/playwright-qa

概念一句话说明 Skills 可复用的 AI 工作流配置，封装在 SKILL.md 中 SKILL.md 包含 YAML 配置 + Markdown 指令的核心文件自动触发 Claude 根据 description 字段语义匹配用户请求手动触发通过斜杠命令 /skill-name 显式调用 CLAUDE.md 项目级的 AI 入职文档，每次会话自动加载

下一篇我们将手把手创建一个完整的生产级 Skill——从零开始打造你的专属斜杠命令。

Claude Code Skills 系列的第一篇

相关推荐