Claude Code 实战系列一：全局技能 + 项目级技能搭建

前言

Claude Code 的 Skill 可分为全局 Skills和项目级 Skills。 全局技能对本地全部项目生效，本地所有项目都可以使用；项目级技能只在当前项目内可见。本文手把手带你搭建全局Skills和项目级Skills

环境说明：Mac 系统，trae+Claude Code 插件

一、全局Skills搭建

在/Users/<用户名>/.claude目录下，创建skills文件夹，skills目录下创建codereview文件夹，搭建一个codereview的技能。全局目录结构如下：

/Users/<用户名>/.claude/skills
└── codereview # 代码质量审查技能
└── SKILL.md

1.1 搭建codereview代码审查技能

codereview文件夹下创建SKILL.md

—
name: code-review-light
description: 轻量代码审查，快速检查缺陷、风格、安全与性能，输出可落地建议
—

待审查代码：**$ARGUMENTS**

请按下面维度快速审查代码：
1. 代码风格：命名、格式、缩进是否规范
2. 逻辑缺陷：边界条件、空值、异常遗漏
3. 安全风险：硬编码密钥、输入未校验等问题
4. 性能点：循环、重复计算、资源释放
5. 可维护性：函数职责、注释情况

输出格式：
🔴严重问题：（必须修复）
– 位置：
– 问题：
– 建议：

🟡改进建议：（建议优化）
– 位置：
– 问题：
– 建议：

🟢小提示：（可选优化）

> 只输出分析与建议，不要改写代码。

💡占位符说明

• $ARGUMENTS：接收调用时传入的全部参数；
• 也支持 $1 $2 位置参数，依次获取每一个传入参数；
• 如果 Skill 没有定义$ARGUMENTS，调用时传入的内容会自动追加到 Skill 末尾。

1.2 测试全局skills

1）先在trae中打开claude code终端，/Open Claude in Terminal命令打开终端窗口，然后输入claude命令，然后就可以通过对话方式与claude code进行交互

2）查看全局技能

终端输入/skills 展示全局技能列表

3）测试技能

打开snake-game项目，在终端输入/code-review @index.html

输入上述命令回车，对当前项目中的index.html进行按照技能要求进行代码审查

上述是全局技能的搭建方式

二、项目级skills

2.1搭建代码优化技能

项目级skills只对当前项目可见，还是以snake-game项目为例，创建一个代码优化的技能。搭建过程如下：

在项目根目录下创建路径： snake-game/.claude/skills/optimize/SKILL.md

注意：不是用户目录下的.claude，是项目内部的 .claude目录。

完整文件：.claude/skills/optimize/SKILL.md

—
name: optimize
description: 为指定代码提供详细的优化建议和改进方案
—

# 智能代码优化器

正在分析文件: $ARGUMENTS

## 代码分析维度

### 1. 性能优化分析
– 算法时间复杂度评估
– 内存使用效率检查
– 渲染性能优化
– 网络请求优化建议

### 2. 代码质量评估
– 可读性和可维护性分析
– 代码重复率识别
– 函数复杂度检查
– 错误处理完整性评估

### 3. 最佳实践应用
– 设计模式应用建议
– 架构改进方案
– 类型安全增强
– 测试覆盖建议

## 请执行以下分析步骤

### 第一步：代码结构分析
1. 请读取并理解目标文件的结构
2. 分析模块划分是否合理
3. 检查导入导出关系

### 第二步：性能问题识别
1. 查找可能的性能瓶颈
2. 识别重复计算或不必要的操作
3. 分析内存使用情况
4. 检查网络请求优化空间

### 第三步：代码质量问题
1. 检查函数长度和复杂度
2. 识别重复代码
3. 评估命名规范和注释质量
4. 分析错误处理机制

### 第四步：架构和设计
1. 检查是否遵循SOLID原则
2. 分析代码耦合度
3. 评估扩展性
4. 检查设计模式应用

## 优化建议输出格式

请按以下格式输出优化建议：

### 📊 代码概况
– 文件类型: [HTML/JS/CSS等]
– 主要功能: [简述]
– 代码规模: [预估]

### 🎯 主要发现

#### 🔴 高优先级问题
1. **[问题类型]** 问题描述
– 位置: [大致位置]
– 影响: [对性能/可维护性的影响]
– 建议: [具体优化方案]
– 代码示例: [优化前后的对比]

#### 🟡 中优先级改进
1. **[问题类型]** 问题描述
– 位置: [大致位置]
– 影响: [中等影响]
– 建议: [改进方案]

#### 🟢 低优先级优化
1. **[优化类型]** 优化描述
– 位置: [大致位置]
– 收益: [预期改善]
– 建议: [可选优化]

### 📈 预期效果
– 性能提升: [预估百分比]
– 代码质量提升: [描述性指标]
– 维护成本降低: [预估]

## 优化原则
1. 保持功能不变的前提下进行优化
2. 优先解决影响用户体验的问题
3. 平衡优化成本和收益
4. 确保优化方案可测试、可验证

请基于以上分析框架，为指定代码提供详细的优化建议，将建议写在项目根目录下“optimization_report.md”的md文档中。

2.2 测试项目技能

1）查看技能是否创建成功

同样进入到snake-game项目目录，执行/skills

看到多了一个技能，是我们刚创建的代码优化技能

2）调用项目技能：

在终端执行

/optimize @index.html

技能会完成对index.html文件的代码优化

注意：每次增加技能一定先进行保存然后在执行命令，这样技能才能被识别的到

三、全局技能和项目技能对比