---
name: structured-data-collection-specification
description: 定义结构化数据集合体（如消息、文件、数据库记录或API响应体）的完整特征规范。当接口传输复合结构化数据且需明确其组成、约束与使用上下文时使用此技能。
---

# 结构化数据集合体特征定义规范

## 何时使用
- 接口涉及复合数据传输（非单个数据元素）
- 数据以结构化形式在系统间交换（如JSON、XML、数据库记录、二进制消息）
- 需为协议设计、系统集成或数据治理提供明确的数据契约

## 执行步骤

1. **名称与标识符**
   - 分配项目唯一标识符（用于追踪和版本管理）
   - 提供自然语言名称（例如“飞行状态报告”）
   - 指明技术名称（如C结构体名、Protobuf消息名、JSON Schema ID）
   - 列出常用缩写或同义名称

2. **内部结构**
   - 明确数据元素组成及其数据类型
   - 定义字段编号顺序（若适用）
   - 描述分组逻辑（如嵌套对象、数组、联合体）

3. **存储媒体**
   - 说明载体类型（内存、磁盘、网络包等）
   - 指定媒体内结构（如文件路径、数据库表名、Kafka主题）

4. **视听特性（仅适用于输出型集合体）**
   - 定义颜色、版面布局、字体、图标、声音提示、亮度等呈现属性

5. **关系特性**
   - 说明排序规则（升序/降序、自定义比较逻辑）
   - 定义索引方式（主键、唯一索引、全文索引）
   - 描述访问路径（如外键关联、REST资源路径）

6. **约束条件**
   - 设置优先级、传输频率、容量上限（记录数或字节数）
   - 明确修改权限（只读、可更新字段）
   - 标注适用的业务规则

7. **保密性约束**
   - 指明整体加密要求（如TLS、字段级加密）
   - 定义访问控制策略（RBAC、ABAC规则）

8. **来源与接收者**
   - 标识设置/发送实体（系统、服务、角色）
   - 标识使用/接收实体

完成以上步骤后，输出一份完整的数据集合体规范文档，用于接口协议设计、系统开发或合规审查。