Claude Code 完全实战指南 - 第四章:Skill 怎么写

文章目录

    • [第四章:Skill 怎么写](#第四章:Skill 怎么写)
      • [4.1 最小可用 Skill](#4.1 最小可用 Skill)
      • [4.2 Skill 编写规范](#4.2 Skill 编写规范)
      • [4.3 带参数的 Skill](#4.3 带参数的 Skill)
      • [4.5 Skill 调试技巧](#4.5 Skill 调试技巧)

第四章:Skill 怎么写

4.1 最小可用 Skill

创建 .claude/skills/hello.md:

markdown 复制代码
# Hello Skill

## 描述
向用户问好并介绍当前项目。

## 适用场景
- 用户说 "你好"
- 用户说 "介绍项目"

## 执行步骤
1. 读取项目根目录的 README.md
2. 用一句话总结项目用途
3. 列出主要技术栈
4. 友好地向用户问好

## 输出格式
用中文回复,格式如下:

你好!这是 项目名。

项目简介:一句话总结

技术栈:主要技术

有什么可以帮你的?

复制代码

测试 Skill:

bash 复制代码
claude
"你好"
# Claude 会自动加载 hello Skill,按步骤执行

4.2 Skill 编写规范

文件名规范:

  • 使用小写字母 + 连字符:code-review.md ✅
  • 避免空格和特殊字符:code review.md ❌
  • 名字要直观,一看就知道用途

内容规范:

markdown 复制代码
# Skill 名称(简洁明了)

## 描述(1-2 句话说明用途)

## 适用场景(列出触发条件)
- 关键词 1
- 关键词 2

## 执行步骤(编号列表,每一步可执行)
1. 具体动作(如"读取 package.json")
2. 具体动作(如"检查依赖版本")
3. 具体动作(如"输出结果")

## 输出格式(明确结果格式)

## 示例(至少 1 个完整示例)

## 注意事项(边界情况、常见错误)

4.3 带参数的 Skill

Skill 可以接收参数,用 {``{参数名}} 表示:

markdown 复制代码
# API 文档生成 Skill

## 描述
根据代码生成 API 文档。

## 参数
- `language`: 编程语言(默认:python)
- `style`: 文档风格(默认:openapi)

## 执行步骤
1. 扫描 `{{language}}` 源代码文件
2. 提取函数签名和 docstring
3. 按 `{{style}}` 格式生成文档
4. 保存到 `docs/api.md`

## 示例
### 示例:生成 Python API 文档
参数:language=python, style=openapi
输入:
```python
def get_user(user_id: int) -> dict:
    """获取用户信息"""
    ...

输出:

yaml 复制代码
/user/{user_id}:
  get:
    summary: 获取用户信息
    parameters:
      - name: user_id
        in: path
        type: integer
复制代码
### 4.4 Skill 调用 Skill

一个 Skill 可以调用另一个 Skill:

```markdown
# 项目初始化 Skill

## 执行步骤
1. 检查项目类型(Python/Node/Java)
2. 调用对应的 "环境检查 Skill"
3. 调用 "依赖安装 Skill"
4. 调用 "代码规范配置 Skill"
5. 输出初始化报告

4.5 Skill 调试技巧

bash 复制代码
# 技巧 1:查看加载了哪些 Skill
claude
/debug
"帮我写代码"
# 输出中会显示匹配的 Skill

# 技巧 2:强制使用某个 Skill
claude
"使用 code-review Skill 审查 src/main.py"

# 技巧 3:查看 Skill 内容
@file .claude/skills/my-skill.md
"这个 Skill 有什么问题?"

相关推荐
NoteDeep 深度笔记7 分钟前
DOM 被改乱了怎么办?Notedeep 编辑器的 normalize 设计
前端·javascript·编辑器
zhanlang02179 分钟前
HTML 零基础入门到企业实战【第七章 7.2】form 标签属性:action、method、name、target 详解
前端·html
CoderYanger24 分钟前
Java EE 进阶:9.MyBatis 操作数据库(进阶)(第一弹)
java·数据库·spring·面试·java-ee·tomcat·mybatis
码云社区37 分钟前
Java租房平台源码方案:Vue 3房源审核、UniApp预约看房与房东管理
java·vue.js
涛涛ing42 分钟前
面试了20个前端,我发现高薪的都不怎么拼“底层原理”
前端
翼帆1 小时前
我用 AI 复刻了 CodeTank,重温代码坦克
前端·javascript·开源·ai编程·游戏开发·codetank
有趣的老凌2 小时前
学习MarkDown笔记
前端
掘金者阿豪2 小时前
数据库选型到底应该看什么?从业务需求到技术架构的实践分析
前端·后端
codigger2 小时前
ThreadLocal 会内存泄露吗?
java·内存泄漏·threadlocal
挖掘狂人2 小时前
ThreadLocal 会内存泄露吗?
java·安全·架构