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

AI资讯 1个月前 charles
70 0

一、认识 Claude Skills

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

Skills 的核心作用

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

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

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

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

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

Skills 的实际价值

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

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

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

现状问题

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

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

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

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

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

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

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

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

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

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

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

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

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

解决方案

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

Claude Skills 实操:自动化版本发布归档流程
  • 自动生成符合规范的 HTML 发布文档

    • 根据 versions.md 内容自动生成
    • 保持与历史版本的格式一致
    • 自动更新总索引页面
  • 自动导出标准化的 DDL 脚本

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

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

三、执行配置与实际操作

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

第一步:创建 Skill 文件结构

首先,在项目中创建 Skills 的目录结构。在项目根目录下新建 .claude/skills/ 文件夹(如果不存在的话):

mkdir -p .claude/skills/release-summary

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

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

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

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 Skills 实操:自动化版本发布归档流程

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

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

/release-summary

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

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

第六步:查看执行成果

执行完成后,你会获得以下成果:

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

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

登录查看剩余 70% 内容

版权声明:charles 发表于 2026年6月9日 pm2:16。
转载请注明:Claude Skills 实操:自动化版本发布归档流程 | AI工具大全&导航

相关文章