深入解析Spec与Skill的关系与区别：技术选型与最佳实践

5次阅读

没有评论

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

Spec（规范）是系统设计中明确规定的接口、协议或标准，它定义了组件之间交互的边界和规则。例如，REST API 的 OpenAPI 描述文件就是一种典型的 Spec。

技术角色 ：作为契约存在，确保不同模块间的兼容性
典型用途 ：API 设计、数据格式标准化、通信协议定义

Skill（技能）是实现特定功能的能力集合，包含具体的业务逻辑和处理流程。比如图像识别系统中的物体检测能力就是一个 Skill。

技术角色 ：作为能力提供方，实现具体业务价值
典型用途 ：算法实现、业务逻辑封装、领域能力建设

性能瓶颈 ：将应该作为 Skill 实现的复杂计算逻辑错误地写入 Spec 层，导致接口响应缓慢
设计冗余 ：在 Skill 中重复定义本应属于 Spec 的校验规则，造成代码重复
维护困难 ：边界模糊导致修改时牵一发而动全身
扩展性差 ：新功能开发时需要同时修改多个层级

稳定性 ：Spec 应保持相对稳定，Skill 可频繁迭代
抽象层级 ：Spec 定义 ” 做什么 ”，Skill 实现 ” 怎么做 ”
变更影响 ：Spec 变更影响调用方，Skill 变更影响内部实现

是否涉及系统间交互？→ 是：Spec
是否包含具体业务逻辑？→ 是：Skill
是否需要长期保持兼容？→ 是：Spec

# Spec 层：订单服务接口定义
class OrderServiceSpec:
    @abstractmethod
    def create_order(self, user_id: str, items: List[Item]) -> Order:
        """
        规范要求：- 参数校验（user_id 必须为 UUID 格式）- 返回统一的 Order DTO
        """
        pass

# Skill 层：具体订单处理实现
class OrderProcessingSkill(OrderServiceSpec):
    def create_order(self, user_id, items):
        # 实现 Spec 定义的校验（属于 Spec 范畴）validate_uuid(user_id)  

        # 业务逻辑实现（属于 Skill 范畴）inventory_check = self._check_inventory(items)
        fraud_score = self._calculate_fraud_risk(user_id)

        return OrderBuilder.build(
            user_id=user_id,
            items=items,
            status='CREATED'
        )

    # 私有方法封装具体技能
    def _check_inventory(self, items):
        # 实际库存检查逻辑
        pass