OpenCode 添加 Skill 实战指南：从零构建可扩展的技能系统

2次阅读

共计 1887 个字符，预计需要花费 5 分钟才能阅读完成。

OpenCode 的 Skill 系统采用微内核架构，核心包含三个模块：

注册中心 ：采用 etcd 存储 Skill 元数据（名称、版本、输入输出契约），通过 Watch 机制实现动态发现
执行引擎 ：基于轻量级线程池处理请求，支持同步 / 异步调用模式
上下文服务 ：维护会话状态，处理 Skill 间数据传递

优点：低延迟（进程内调用）、调试方便
缺点：语言耦合度高、隔离性差
适用场景：快速验证原型、单一语言栈

优点：支持多语言、独立部署伸缩
缺点：RPC 开销、版本管理复杂
适用场景：生产环境、异构系统

# 元数据定义 (skill_meta.py)
from dataclasses import dataclass
from typing import Callable

@dataclass
class SkillMeta:
    name: str
    version: str 
    input_schema: dict
    output_schema: dict
    executor: Callable

# 执行逻辑 (currency_skill.py)
def convert_currency(params: dict) -> dict:
    try:
        rate = get_exchange_rate(params['from'], params['to'])
        return {'result': params['amount'] * rate,
            'metadata': {'rate': rate}
        }
    except KeyError as e:
        raise InvalidInputError(f"Missing required field: {e}")
    except RateUnavailableError:
        raise SkillExecutionError("Service temporarily unavailable")

# 注册入口 (register.py)
from opencode_sdk import SkillRegistry

registry = SkillRegistry("etcd://localhost:2379")
registry.register(
    SkillMeta(
        name="currency_converter",
        version="1.0",
        input_schema={"from": "str", "to": "str", "amount": "float"},
        output_schema={"result": "float", "metadata": "dict"},
        executor=convert_currency
    )
)

使用有向无环图（DAG）记录 Skill 调用关系
启动时拓扑排序检查循环依赖

基于 OAuth2 的 JWT 令牌校验

在注册中心存储 ACL 策略（示例配置）：

permissions:
  - skill: "payment_processor"
    allowed_roles: ["finance"]
    max_call_rate: 10/1m

Prometheus 埋点指标示例：

from prometheus_client import Counter

SKILL_ERRORS = Counter(
    'skill_errors_total', 
    'Total skill execution errors',
    ['skill_name', 'error_type']
)

# 在异常处理中埋点
SKILL_ERRORS.labels(
    skill_name="currency_converter", 
    error_type="invalid_input"
).inc()