Claude Skills 实操：自动化版本发布归档流程

一、认识 Claude Skills

Claude Skills 是一套强大的能力扩展机制，让 Claude 可以根据实际需求自动执行特定的工作流程。简单来说，它就是一套"工作手册"，告诉 Claude 在什么场景下应该做什么事。

Skills 的核心作用

1. 自动知识补充
当你遇到新的问题或任务时，Claude 可以自动识别并加载相关的 Skills。这些 Skills 包含了特定领域的知识、最佳实践和工作规范，让 Claude 能够更准确地理解你的需求。

2. 工作流程标准化
对于那些重复性的、有固定步骤的工作，比如版本发布、代码审查、文档生成等，Skills 可以将这些流程标准化和自动化。不需要每次都手动告诉 Claude 应该做哪些步骤。

3. 快捷命令支持
Skills 支持通过斜杠命令（如 /release-summary）直接调用。这样就能快速触发特定的工作流，不需要用自然语言解释需求。

4. 灵活的调用控制
你可以配置 Skills 的调用权限——有些 Skills 由 Claude 自动判断是否需要使用，有些 Skills 则需要你主动触发。

Skills 的实际价值

在实际项目中，Skills 特别适合处理以下情况：

版本发布工作：自动生成发布文档、导出数据库脚本
代码规范检查：根据项目的编码规范进行代码审查
文档生成：按照统一模板生成各类文档
工程化任务：部署、构建、测试等自动化工作流

二、需求背景：为什么需要自动化版本发布归档流程

现状问题

目前正在开发AIS知识库引擎系统，在每次发布新版本时，团队都需要做2件事：

一、整理当前版本的版本日志（Markdown文档的形式），并且最终整理成Html版本，直接内置到系统里面，在用户使用时，直接可以点开版本日志，看当前版本或者历史版本更新了哪些内容，如下图：

虽然这个界面也是让AI生成了，但是每次去做就很繁琐，需要一个标准流程来固化下来。

二、当前版本的SQL表结构备份归档。

我们会有很多试用客户需要部署AIS知识库的版本，每一次版本发布，需要人来整理数据库的表结构、必要的初始化数据等内容，也是一件机器繁琐，难以重复执行的事情，人来做，有时候会遗漏某一些表或者数据，能难流程化。这件事不管是开发干，还是运维干，都是比较枯燥无味。

在项目目录下，团队规范定义了一个SQL文件夹，包含两个文件夹：

development：开发阶段，以每日日期格式命名，每个日期下，存储当前日期，会修改的SQL脚本ddl，方便版本发布时，按日期，逐个执行
published：某一个正式版本的总SQL归档，data.sql(初始化表结构数据)、db.sql(初始化数据库)、table.sql(初始化表结构)

通过这样的一个规范，在这个项目中，每次版本发布，或者给新客户部署，都可以拉published下的版本SQL，不会出错。

标记时间也是方便，如果后续的客户做升级，那么就拉development下的某些日期的版本，逐步升级执行SQL即可。

针对这两件事，人来执行做，都是比较繁琐的，现在有了Claude Skills，那么就可以让AI来处理这个流程了。

解决方案

通过 Claude Skills 的 release-summary 技能，我们实现了版本发布流程的自动化归档：

自动生成符合规范的 HTML 发布文档

根据 versions.md 内容自动生成
保持与历史版本的格式一致
自动更新总索引页面

自动导出标准化的 DDL 脚本

一键导出数据库结构和初始化数据
生成的脚本格式统一且可重复执行
自动包含所有必需的初始化数据和角色权限

流程可复现且版本可追溯

每个版本的发布步骤完全一致
生成的脚本带有版本号和日期信息
便于快速定位和解决问题

三、执行配置与实际操作

只要思路流程梳理清楚，下面这些内容都可以让AI大模型生成。不用实际编写。

第一步：创建 Skill 文件结构

首先，在项目中创建 Skills 的目录结构。在项目根目录下新建 .claude/skills/ 文件夹（如果不存在的话）：

mkdir -p .claude/skills/release-summary

第二步：读取数据库表结构&初始化数据

考虑到我需要链接数据库，获取真实的表结构，因此这个步骤，我写了一个python脚本，用python代码的方式，来获取当前db数据库的表结构信息，以及初始化的数据。

1. SKILL.md – Skill 定义文件

---
name: release-summary
description: 自动生成版本发布总结，包括生成HTML版本文档和创建数据库DDL脚本。用于版本发布准备工作。
---

# 版本发布总结技能

...（包含详细的功能说明）

2. generate_ddl.py – DDL 导出脚本
这个 Python 脚本负责：

读取数据库配置
连接到数据库
导出表结构和初始化数据
生成标准化的 SQL 文件

3. config.yaml – 数据库连接信息

编辑 config.yaml，填写你的数据库连接信息：

database:
  host:localhost           # 数据库主机地址
port:3306               # 数据库端口
user:root               # 数据库用户名
password:"your_password"# 数据库密码
database:ais_server     # 数据库名称

4. get_current_date.py – 日期工具脚本
提供获取当前日期的功能，用于生成带日期戳的目录。

第四步：安装 Python 依赖

确保已安装脚本所需的 Python 依赖：

pip install pymysql PyYAML

依赖说明：

pymysql：Python 连接 MySQL 数据库的驱动
PyYAML：YAML 文件解析库，用于读取配置文件

第五步：触发 Skill 执行

方式一：通过 Claude 对话自动触发

当你在 Claude 中提到版本发布相关的内容时，比如说：

版本发布

Claude 会自动识别这是一个版本发布任务，加载 release-summary 技能，并执行相应的操作。

方式二：使用斜杠命令直接调用

在 Claude 的对话中直接使用命令：

/release-summary

Claude 会执行所有的发布准备工作。

第六步：查看执行成果

执行完成后，你会获得以下成果：

HTML 发布文档

位置：src/main/resources/static/ais/release-notes/{version}/index.html
内容：

版本号和发布日期
本版本的新增功能、缺陷修复、改进内容等
与历史版本保持一致的样式和格式
自动生成的导航和链接

数据库脚本文件

位置：sql/published/{version}-{date}/ 目录下

包含三个文件：

1. db.sql – 数据库初始化脚本

CREATE DATABASE IF NOT EXISTS ais_server
  CHARACTER SET utf8mb4
  COLLATE utf8mb4_general_ci;

用于在新环境中创建数据库。

2. table.sql – 表结构脚本

DROP TABLE IF EXISTS `table_name`;
CREATE TABLE `table_name` (
  -- 完整的表定义
);

包含所有表的完整定义，可以直接执行创建表结构。

3. data.sql – 初始化数据脚本

INSERT INTO saas_sys_role VALUES (...);
INSERT INTO saas_sys_perm VALUES (...);
-- 其他初始化数据

包含系统必需的初始化数据，包括：

系统角色（租户管理员、后台管理员等）
菜单资源和权限配置
默认用户和用户权限
用户角色关系

四、总结

Claude Skills 是一套强大的工作流自动化工具。通过简单的配置和几个关键文件，就能实现复杂业务流程的自动化——无论是版本发布、代码审查还是文档生成。

对于国内团队，完全可以基于这套理念，使用国内的 LLM 服务（GLM、MiniMax、Kimi等）实现相同的功能。关键是要理解 Skill 的核心概念，然后根据实际的 API 服务进行适配。

附录

https://code.claude.com/docs/en/skills

{{userData.name}}已认证