第28讲：Skill 部署与发布

掌握 Skill 的部署发布流程，让你的 Skill 正式上线服务用户。

一、部署前准备

1.1 发布检查清单

□ 功能完整性
  □ 核心功能已实现
  □ 异常处理完善
  □ 边界情况覆盖

□ 代码质量
  □ 代码审查通过
  □ 测试覆盖率达标
  □ 无安全漏洞

□ 文档完善
  □ 使用说明文档
  □ API 文档
  □ 更新日志

□ 配置准备
  □ 生产环境配置
  □ 密钥和凭证
  □ 监控告警配置

1.2 环境配置

# config.py
import os

class Config:
    """基础配置"""
    DEBUG = False
    LOG_LEVEL = 'INFO'
    
class DevelopmentConfig(Config):
    """开发环境"""
    DEBUG = True
    LOG_LEVEL = 'DEBUG'
    DATABASE_URL = 'sqlite:///dev.db'

class ProductionConfig(Config):
    """生产环境"""
    LOG_LEVEL = 'WARNING'
    DATABASE_URL = os.getenv('DATABASE_URL')
    API_KEY = os.getenv('API_KEY')
    
config = {
    'development': DevelopmentConfig,
    'production': ProductionConfig,
    'default': DevelopmentConfig
}

二、各平台部署流程

2.1 Coze 部署

步骤：

创建 Bot
- 登录 Coze 平台
- 点击 "Create Bot"
- 填写名称和描述

配置 Prompt

# Role
你是财务智能助手，专门帮助财务人员处理发票和报表。

# Skills
- 发票识别与录入
- 财务报表生成
- 数据统计分析

# Constraints
- 只处理财务相关数据
- 保护用户数据隐私

添加插件
- 搜索并添加所需插件
- 配置插件参数
测试验证
- 在测试窗口验证功能
- 检查响应是否符合预期
发布上线
- 点击 "Publish"
- 选择发布渠道（Discord、Telegram 等）

2.2 OpenClaw 部署

步骤：

准备代码

# 项目结构
my_skill/
├── skill.py          # Skill 主文件
├── requirements.txt  # 依赖
└── README.md         # 说明文档

编写 Skill

# skill.py
from openclaw import Skill, Tool

class MySkill(Skill):
    name = "财务智能助手"
    description = "自动化财务处理"
    
    @Tool
    def recognize_invoice(self, image: str) -> str:
        """识别发票"""
        # 实现逻辑
        return "识别结果"

配置依赖

# requirements.txt
openpyxl>=3.0.0
pandas>=1.3.0
paddleocr>=2.6.0

提交部署

1 2	# 使用 OpenClaw CLI openclaw deploy .

2.3 飞书 CLI 部署

步骤：

创建应用
- 登录飞书开放平台
- 创建企业自建应用
- 获取 App ID 和 App Secret
配置权限
- 申请所需权限
- 配置事件订阅

开发 Skill

from lark_cli import Skill, Message

class FeishuSkill(Skill):
    def on_message(self, message: Message):
        # 处理消息
        reply = self.process(message.text)
        self.send_message(message.chat_id, reply)

部署上线
- 配置服务器地址
- 发布应用版本
- 提交审核

三、版本管理

3.1 版本号规范

采用语义化版本（Semantic Versioning）：

版本格式：主版本号.次版本号.修订号
示例：1.2.3

主版本号：重大更新，不兼容的 API 修改
次版本号：功能新增，向下兼容
修订号：问题修复，向下兼容

3.2 版本发布流程

1. 开发完成 → 2. 测试通过 → 3. 更新版本号
      ↓
4. 更新 CHANGELOG → 5. 打标签 → 6. 部署上线
      ↓
7. 验证功能 → 8. 通知用户

3.3 CHANGELOG 模板

# Changelog

## [1.2.0] - 2024-01-15

### Added
- 新增发票批量识别功能
- 支持 PDF 格式发票

### Changed
- 优化报表生成速度，提升 50%

### Fixed
- 修复日期格式识别错误

## [1.1.0] - 2024-01-01
...

四、监控与运维

4.1 日志监控

# utils/logger.py
import logging
import sys

class SkillLogger:
    """Skill 日志记录器"""
    
    def __init__(self, name: str):
        self.logger = logging.getLogger(name)
        self.logger.setLevel(logging.INFO)
        
        # 控制台输出
        console_handler = logging.StreamHandler(sys.stdout)
        console_handler.setLevel(logging.INFO)
        
        # 文件输出
        file_handler = logging.FileHandler(f'logs/{name}.log')
        file_handler.setLevel(logging.DEBUG)
        
        # 格式化
        formatter = logging.Formatter(
            '%(asctime)s - %(name)s - %(levelname)s - %(message)s'
        )
        console_handler.setFormatter(formatter)
        file_handler.setFormatter(formatter)
        
        self.logger.addHandler(console_handler)
        self.logger.addHandler(file_handler)
    
    def info(self, message: str):
        self.logger.info(message)
    
    def error(self, message: str, exc_info=False):
        self.logger.error(message, exc_info=exc_info)
    
    def metric(self, name: str, value: float):
        """记录指标"""
        self.logger.info(f"METRIC: {name}={value}")

4.2 健康检查

# health_check.py
from typing import Dict
import time

class HealthChecker:
    """健康检查"""
    
    def __init__(self):
        self.checks = {}
    
    def register(self, name: str, check_func):
        """注册检查项"""
        self.checks[name] = check_func
    
    def check_all(self) -> Dict:
        """执行所有检查"""
        results = {}
        
        for name, check_func in self.checks.items():
            try:
                start = time.time()
                check_func()
                elapsed = time.time() - start
                results[name] = {
                    'status': 'healthy',
                    'response_time': elapsed
                }
            except Exception as e:
                results[name] = {
                    'status': 'unhealthy',
                    'error': str(e)
                }
        
        return results

# 使用示例
health_checker = HealthChecker()

# 注册数据库检查
health_checker.register('database', lambda: db.ping())

# 注册 API 检查
health_checker.register('api', lambda: requests.get('/health'))

五、故障处理

5.1 故障分级

级别	描述	响应时间	处理措施
P0	服务完全不可用	15分钟	立即回滚
P1	核心功能异常	1小时	紧急修复
P2	非核心功能异常	4小时	计划修复
P3	轻微问题	24小时	下次迭代

5.2 回滚策略

# rollback.py
class RollbackManager:
    """回滚管理器"""
    
    def __init__(self):
        self.versions = []
        self.current_version = None
    
    def deploy(self, version: str):
        """部署新版本"""
        # 保存当前版本
        if self.current_version:
            self.versions.append(self.current_version)
        
        # 部署新版本
        self._do_deploy(version)
        self.current_version = version
    
    def rollback(self):
        """回滚到上一版本"""
        if not self.versions:
            raise Exception("没有可回滚的版本")
        
        previous_version = self.versions.pop()
        self._do_deploy(previous_version)
        self.current_version = previous_version
    
    def _do_deploy(self, version: str):
        """执行部署"""
        # 实际部署逻辑
        pass