建筑数据标准合规检查

技能文档

---
name: datadrivenconstruction-standards-compliance-checker
title: 建筑数据标准合规检查
description: 按 ISO 19650、IFC、COBie、UniFormat、MasterFormat 等建筑行业数据标准校验项目数据的合规性，输出结构化合规报告，支持单条与批量检查、自定义规则扩展。当用户需要校验 BIM 数据、建筑文件命名、构件数据质量、交付物合规性、建筑数据标准化检查时触发。
category: 法律合规
---

# 建筑数据标准合规检查

对建筑项目数据做标准合规自动化检查，覆盖 ISO 19650、IFC、COBie、UniFormat、MasterFormat、OmniClass 六大标准的命名、格式与必填字段规则。

## 技能工作流

### 步骤1：确认数据与目标标准

从用户处收集待检查数据（CSV、Excel、JSON 或直接输入的字段值），并确认目标标准。数据字段与标准不匹配时先向用户澄清。检查器仅要求 Python 3 环境（`python3`）。

### 步骤2：加载检查器

检查器实现位于 [scripts/standards_compliance_checker.py](scripts/standards_compliance_checker.py)：

```python
from standards_compliance_checker import StandardsComplianceChecker, Standard

checker = StandardsComplianceChecker()
```

### 步骤3：执行合规检查

```python
data = {
    "filename": "PRJ-ARC-MOD-0001-DWG-PLAN-001",
    "status": "S3",
    "revision": "P01"
}

report = checker.check_compliance(data, Standard.ISO_19650)
```

也支持批量与多标准检查：

```python
# 批量检查
batch_report = checker.check_batch(records, Standard.ISO_19650)

# 多标准交叉检查
reports = checker.check_multiple_standards(data, [Standard.ISO_19650, Standard.IFC])
```

### 步骤4：输出合规报告

用 `generate_report_summary` 生成可读摘要，或直接读取 `ComplianceReport` 的结构化字段：

```python
print(checker.generate_report_summary(report))
# Compliance Report: ISO_19650
# Total Rules: 3 / Passed: 3 / Failed: 0 / Warnings: 0
# Status: COMPLIANT
```

报告包含：总规则数、通过/失败/警告计数、合规等级（COMPLIANT / MINOR_ISSUES / MAJOR_ISSUES / NON_COMPLIANT）与逐条问题明细（规则编号、严重度、字段、原因）。

### 步骤5：按需扩展与跟进

- 自定义规则：`checker.add_custom_rule(standard, rule)`，规则结构与内置规则一致（`id`、`name`、`field`，可选 `pattern` / `values` / `required`）
- 用户数据可导出时，主动提供 Excel/CSV/JSON 导出选项
- 对失败项给出修复建议后，可重跑检查验证修复效果

## 内置规则速览

| 标准 | 检查项示例 |
|------|-----------|
| ISO 19650 | 文件命名约定、状态码取值（WIP/S0–S4/A/B/CR）、版本号格式（P01/C01） |
| IFC | GlobalId 22 位格式、Name 与 ObjectType 必填 |
| COBie | 设施名、空间名格式、构件类型、厂商信息必填 |
| UniFormat | 一级代码取值（A–G/Z）、编码格式（字母+4 位数字） |
| MasterFormat | 分部号（2 位数字）、分节号格式 |

完整规则定义见 [scripts/standards_compliance_checker.py](scripts/standards_compliance_checker.py) 中的 `_load_rules`。

使用说明

# 建筑数据标准合规检查

按 ISO 19650、IFC、COBie、UniFormat、MasterFormat 等建筑行业数据标准，自动校验项目数据的合规性并输出结构化报告。

## 能做什么

- 单条或批量校验建筑数据：文件命名、状态码、版本号、构件字段、必填项
- 多标准交叉检查，输出合规等级（合规 / 轻微问题 / 重大问题 / 不合规）
- 支持自定义规则扩展
- 报告含逐条问题明细（规则编号、严重度、字段、原因），便于整改

## 何时使用

- 校验 BIM 数据、IFC/COBie 交付物质量
- 检查建筑图纸/文档命名是否符合 ISO 19650
- 建筑数据入库前的标准化检查

## 快速上手

```python
from standards_compliance_checker import StandardsComplianceChecker, Standard

checker = StandardsComplianceChecker()
data = {"filename": "PRJ-ARC-MOD-0001-DWG-PLAN-001", "status": "S3", "revision": "P01"}
report = checker.check_compliance(data, Standard.ISO_19650)
print(checker.generate_report_summary(report))
```

依赖：Python 3（无第三方依赖）。

## 目录结构

- `SKILL.md`：工作流与用法说明
- `scripts/standards_compliance_checker.py`：检查器实现与内置规则

如何安装此技能？

访问技能市场，点击「安装」按钮，按提示将技能包放入 AI 编程助手的 skills 目录即可。