Claude Code 自定义 Skill 开发指南

本文记录 Claude Code v2.1 新发布的 Skills 功能，以及如何创建第一个个人级别的技能——技术博客生成器。

一、Skills 功能概述

Claude Code v2.1 引入了 Agent Skills 功能，允许用户创建个人级别的自动化技能，实现特定任务的定制化执行。

1.1 核心能力

• 自定义触发条件：根据特定关键词或模式启动
• 个性化提示词：定义技能的行为规范和输出格式
• 自动化执行：结合对话历史自动完成任务

1.2 Skill 存放位置

~/.claude/skills/
└── [技能名称]/
    ├── skill.json    # 触发条件配置
    └── skill.md      # 核心提示词

二、技能设计：技术博客生成器

2.1 需求背景

在日常开发中，经常需要将技术问题、bug 解决方案整理成文档。这个 Skill 旨在自动将对话内容转化为结构化的技术博客。

2.2 触发条件（skill.json）

{
  "name": "技术博客生成器",
  "description": "将技术知识点转化为结构化、易读的技术博客文档",
  "trigger": {
    "patterns": [
      "请你结合刚才的.*bug",
      "请你根据.*对话.*总结.*生成技术文档",
      "生成技术文档",
      "总结.*技术文档",
      "把.*整理成文档"
    ]
  },
  "action": {
    "type": "custom"
  }
}

触发示例：

"请你根据刚才修复的 bug，总结归纳，生成技术文档"

2.3 核心提示词（skill.md）

内容结构规范

# 主标题（核心主题）
> 一句话概括本文解决什么问题

## 一、前置知识
## 二、核心概念（是什么）
## 三、原理/机制（为什么）
## 四、实现/应用（怎么做）
## 五、实战场景
## 六、总结要点

代码处理规范

# 标注语言类型
def example():
    # 核心逻辑：xxx
    pass

# 注意：边界条件处理
# /* 时间复杂度：O(n) */

可视化规范（Mermaid）

graph TD
    A[开始] --> B{判断条件}
    B -->|是| C[执行逻辑]
    B -->|否| D[异常处理]

所有标点使用英文半角符号，避免图表渲染失败

语言风格指南

三、创建步骤

3.1 创建目录结构

mkdir -p ~/.claude/skills/技术博客生成器

3.2 创建触发配置（skill.json）

定义技能名称、描述和触发模式。

3.3 创建核心提示词（skill.md）

编写详细的执行规范，包括：

• 内容结构
• 代码处理
• 可视化要求
• 语言风格
• 输出格式

3.4 启用 Skill

重启 Claude Code 使新技能生效。

四、使用方法

4.1 触发方式

在对话中自然表达：

"请你根据刚才的 xxx bug，总结归纳，生成技术文档"

"请你根据这几次的对话，总结归纳，生成技术文档"

4.2 执行流程

flowchart LR
    A[用户触发] --> B{对话历史分析}
    B --> C[提取技术知识点]
    C --> D[按结构组织内容]
    D --> E[生成Mermaid图表]
    E --> F[添加代码示例]
    F --> G[保存到D:\docs]
    G --> H[返回文件路径]

五、输出规范

六、实践案例

6.1 生成文档示例

结合 Claude Code 升级和 Skills 安装的实际对话，生成了以下文档：

1. Claude_Code升级_20260112.md - 记录升级过程和解决方案
2. Claude_Code_Skills开发_20260112.md - 记录技能开发全过程

6.2 输出效果

• 结构清晰，便于阅读
• 代码有完整注释
• 流程有 Mermaid 图示
• 可直接导入 Notion/语雀

七、总结要点

• 技能定位：将对话转化为结构化技术文档
• 核心价值：自动化知识整理，提升文档效率
• 触发方式：特定关键词匹配
• 输出质量：专业深度 + 通俗易懂

八、扩展建议

1. 多场景适配：增加需求文档、API 文档等模板
2. 标签系统：自动添加分类标签
3. 模板市场：分享优秀 Skill 给社区