---
name: 定义数据元素特征
description: 当接口、消息或数据库涉及数据元素传输时，使用本技能为每个数据字段定义完整的特征集（包括名称、类型、格式、值域、精度、约束等），以生成标准化的数据字典条目。适用于接口设计、数据建模和信息工程场景。
---

# 定义数据元素特征

## 何时使用
- 接口涉及数据元素传输
- 存在跨系统或模块的数据交换需求
- 需要编写接口规范文档或数据字典
- 已识别接口数据流且需明确字段语义与技术细节

> **注意**：不适用于无数据交换的控制信号（如纯状态标志或触发信号）。

## 执行步骤

1. **名称/标识符定义**
   - 分配项目唯一标识符
   - 提供自然语言名称（业务含义）
   - 给出标准数据元素名称
   - 指明技术名称（如变量名、数据库列名、JSON键名）
   - 列出常用缩写或同义名

2. **指定数据类型**
   - 明确为以下之一：字符串（STRING）、整数（INTEGER）、浮点数（FLOAT）、布尔值（BOOLEAN）、日期时间（DATETIME）等

3. **定义大小和格式**
   - 字符串：最大长度、允许字符集、标点规则
   - 日期：统一格式（如 YYYY-MM-DD）
   - 数值：是否带符号、小数位数

4. **标注计量单位**
   - 如米（m）、千克（kg）、秒（s）、百分比（%）等

5. **设定值域**
   - 数值范围（如 0~99）
   - 枚举列表（如 ['ACTIVE', 'INACTIVE', 'PENDING']）

6. **明确精度要求**
   - 准确度（是否必须真实反映物理量）
   - 有效数字位数（如保留3位有效数字）

7. **声明约束条件**
   - 业务规则（如“订单金额必须大于0”）
   - 时序要求（如“创建时间不得晚于更新时间”）
   - 更新权限（谁可修改）
   - 优先级或必填性

8. **注明保密性约束**
   - 是否需加密传输或存储
   - 访问控制级别（如公开、内部、机密）

9. **记录来源与接收者**
   - 发送实体（如“用户服务模块”）
   - 接收实体（如“支付网关”）

## 输出结果
生成结构化的数据字典条目，可直接用于接口规范文档、数据库设计说明书或API契约。