数据交换格式规范 v1.0

通用数据结构

{
  "metadata": {
    "schema_version": "1.0",
    "generated_at": "ISO8601格式时间戳",
    "source_skill": "技能名称及版本"
  },
  "data": {
    // 实际数据内容
  }
}

2. 在技能中添加格式验证：

   def validate_data_format(data):
       """验证数据是否符合共享格式规范"""
       required_fields = ["metadata", "data"]
       for field in required_fields:
           if field not in data:
               raise ValueError(f"数据缺少必要字段: {field}")
               
       if "schema_version" not in data["metadata"]:
           raise ValueError("数据缺少schema_version")
           
       # 版本兼容性处理
       if data["metadata"]["schema_version"] not in ["1.0", "1.1"]:
           raise ValueError(f"不支持的数据格式版本: {data['metadata']['schema_version']}")
   

3. 使用版本适配层实现平滑过渡：

   def data_adapter(data):
       """数据格式适配层，实现不同版本间的转换"""
       version = data["metadata"]["schema_version"]
       
       if version == "1.0":
           # 将v1.0格式转换为内部使用的v1.1格式
           return {
               "metadata": {
                   "schema_version": "1.1",
                   "generated_at": data["metadata"]["generated_at"],
                   "source_skill": data["metadata"]["source_skill"],
                   "converted_from": "1.0"
               },
               "data": enhance_v1_data(data["data"])
           }
       return data