---
name: 接口标识与需求规格说明
description: 在编写接口设计文档或需要明确定义多个实体间交互需求时，为系统接口、CSCI接口和用户接口分配唯一标识、绘制接口图，并编制结构化的接口需求规格说明（IRS）。当系统包含多个实体（如系统、子系统、HWCI、CSCI、人工操作等）且需确保接口可验证、可测试时使用本技能。
---

# 接口标识与需求规格说明

## 适用场景
- 正在编写接口设计文档
- 已识别接口边界并存在多个接口实体
- 需要将接口需求作为系统/软件需求规格说明（SRS/SSS）的补充
- 系统涉及外部系统或未完全定义的实体

## 执行步骤
1. **分配接口唯一标识符**：为每个接口分配项目唯一ID（如 `IF-001`）。
2. **标识接口实体**：使用名称、编号、版本和文档引用明确接口两端的实体（系统、CSCI、用户等）。
3. **区分实体开发状态**：
   - **固定接口特性实体**：直接列出其接口需求
   - **开发/修改中实体**：说明其当前已知的接口需求
   - **外部/未涵盖实体**：以假设形式描述（例如：“当[外部系统]执行X时，[本系统]将响应Y”）
4. **绘制接口图**：展示实体间连接、数据流向及接口类型（如同步/异步、实时/批处理）。
5. **编制接口需求规格说明（IRS）核心内容**：
   - **范围**：接口完整标识、系统概述、文档概述
   - **引用文档**：列出相关标准、协议或数据字典
   - **接口需求章节**：
     a) 包含接口标识与接口图（复用步骤1–4）
     b) 按接口ID分节（如 `3.1 IF-001`），每节包含：
        - 接口优先级
        - 接口类型要求（如实时数据传送、数据存储检索）
        - **数据元素特征**：名称/标识符、数据类型、大小与格式、计量单位、值范围、精度、时序约束、保密性、来源与接收者
        - **数据组合体特征**（如消息、记录、文件）：结构、媒体、视听特性（颜色/字体/图标）、组合关系、保密性
6. **引用外部标准**：可引用通信协议、数据字典或用户界面标准替代冗长描述。

> 注意：IRS不描述接口实现细节，仅聚焦于接口需求本身；IRS与SRS/SSS共同构成设计与合格性测试基础。