К основному содержанию
скилл CX Codex

data-model-designer — скилл для Claude Code

Скилл data-model-designer для Claude Code, Codex, Cursor и других агентов: проектирует модели данных строительных проектов — сущности, связи, схемы. Генерирует SQL DDL, JSON Schema и ER-диаграммы в формате Mermaid.

MIT 116 установок ★ 434 обновлён 2026-10-19

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction --skill data-model-designer -a claude-code
Открыть на GitHub

Что делает data-model-designer

Скилл работает на Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode — на macOS, Linux и Windows. Написан на Python, поэтому python3 должен быть доступен в PATH до запуска.

Внутри — Python-классы ConstructionDataModel, Entity, Field и Relationship. Агент создаёт сущности с полями и типами (STRING, INTEGER, FLOAT, DATE, JSON и другие), задаёт связи 1:1, 1:N и N:M, добавляет ограничения: PRIMARY KEY, FOREIGN KEY, UNIQUE, NOT NULL. Из готовой модели генерируется SQL DDL для PostgreSQL или другой базы, JSON Schema и Mermaid ER-диаграмма.

Скилл ориентирован на строительную предметную область: разрозненные данные по объектам, несогласованные структуры между системами, разрывы между сущностями. Без python3 в окружении скилл не выполнит ни одну из этих задач.

Какие задачи решает

  • Сгенерировать SQL DDL для PostgreSQL по описанию строительного проекта
  • Построить ER-диаграмму в формате Mermaid для набора сущностей
  • Определить JSON Schema для объектов проекта
  • Описать связи между сущностями с типами 1:N и N:M
  • Добавить ограничения PRIMARY KEY и FOREIGN KEY к существующей схеме

Примеры запросов агенту

  • Спроектируй модель данных для строительного проекта: объект, подрядчик, работы, материалы — сгенерируй SQL DDL для PostgreSQL
  • Построй ER-диаграмму в формате Mermaid для сущностей Project, Contractor и Task со связями
  • Создай JSON Schema для сущности WorkOrder с полями дата, статус, стоимость

Как установить data-model-designer

1Через Skills CLI (Vercel)

npx skills add datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction --skill data-model-designer -a claude-code

2Вручную: положить файлы

~/.claude/skills/data-model-designer/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/data-model-designer/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о data-model-designer

Как установить data-model-designer в Claude Code?

Выполните команду npx skills add datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction --skill data-model-designer -a claude-code. После установки скилл доступен по пути ~/.claude/skills/data-model-designer/SKILL.md.

Что делает скилл data-model-designer?

Проектирует модели данных для строительных проектов: создаёт сущности с полями и типами, задаёт связи между ними, генерирует SQL DDL, JSON Schema и ER-диаграммы в формате Mermaid.

Нужен ли Python для работы скилла?

Да, скилл требует python3 в PATH. Без него выполнение невозможно.

Исходный текст

SKILL.md · MIT
---
name: "data-model-designer"
description: "Design data models for construction projects. Create entity-relationship diagrams, define schemas, and generate database structures."
homepage: "https://datadrivenconstruction.io"
metadata: {"openclaw": {"emoji": "📐", "os": ["darwin", "linux", "win32"], "homepage": "https://datadrivenconstruction.io", "requires": {"bins": ["python3"]}}}
---
# Data Model Designer

## Business Case

### Problem Statement
Construction data management challenges:
- Fragmented data across systems
- Inconsistent data structures
- Missing relationships between entities
- Difficult data integration

### Solution
Systematic data model design for construction projects, defining entities, relationships, and schemas for effective data management.

## Technical Implementation

```python
from typing import Dict, Any, List, Optional
from dataclasses import dataclass, field
from enum import Enum
import json


class DataType(Enum):
    STRING = "string"
    INTEGER = "integer"
    FLOAT = "float"
    BOOLEAN = "boolean"
    DATE = "date"
    DATETIME = "datetime"
    TEXT = "text"
    JSON = "json"


class RelationType(Enum):
    ONE_TO_ONE = "1:1"
    ONE_TO_MANY = "1:N"
    MANY_TO_MANY = "N:M"


class ConstraintType(Enum):
    PRIMARY_KEY = "primary_key"
    FOREIGN_KEY = "foreign_key"
    UNIQUE = "unique"
    NOT_NULL = "not_null"


@dataclass
class Field:
    name: str
    data_type: DataType
    nullable: bool = True
    default: Any = None
    description: str = ""
    constraints: List[ConstraintType] = field(default_factory=list)


@dataclass
class Entity:
    name: str
    description: str
    fields: List[Field] = field(default_factory=list)
    primary_key: str = "id"


@dataclass
class Relationship:
    name: str
    from_entity: str
    to_entity: str
    relation_type: RelationType
    from_field: str
    to_field: str


class ConstructionDataModel:
    """Design data models for construction projects."""

    def __init__(self, project_name: str):
        self.project_name = project_name
        self.entities: Dict[str, Entity] = {}
        self.relationships: List[Relationship] = []

    def add_entity(self, entity: Entity):
        """Add entity to model."""
        self.entities[entity.name] = entity

    def add_relationship(self, relationship: Relationship):
        """Add relationship between entities."""
        self.relationships.append(relationship)

    def create_entity(self, name: str, description: str,
                      fields: List[Dict[str, Any]]) -> Entity:
        """Create entity from field definitions."""

        entity_fields = [
            Field(
                name=f['name'],
                data_type=DataType(f.get('type', 'string')),
                nullable=f.get('nullable', True),
                default=f.get('default'),
                description=f.get('description', ''),
                constraints=[ConstraintType(c) for c in f.get('constraints', [])]
            )
            for f in fields
        ]

        entity = Entity(name=name, description=description, fields=entity_fields)
        self.add_entity(entity)
        return entity

    def create_relationship(self, from_entity: str, to_entity: str,
                           relation_type: str = "1:N",
                           from_field: str = None) -> Relationship:
        """Create relationship between entities."""

        rel = Relationship(
            name=f"{from_entity}_{to_entity}",
            from_entity=from_entity,
            to_entity=to_entity,
            relation_type=RelationType(relation_type),
            from_field=from_field or f"{to_entity.lower()}_id",
            to_field="id"
        )
        self.add_relationship(rel)
        return rel

    def generate_sql_schema(self, dialect: str = "postgresql") -> str:
        """Generate SQL DDL statements."""

        sql = []
        type_map = {
            DataType.STRING: "VARCHAR(255)",
            DataType.INTEGER: "INTEGER",
            DataType.FLOAT: "DECIMAL(15,2)",
            DataType.BOOLEAN: "BOOLEAN",
            DataType.DATE: "DATE",
            DataType.DATETIME: "TIMESTAMP",
            DataType.TEXT: "TEXT",
            DataType.JSON: "JSONB" if dialect == "postgresql" else "JSON"
        }

        for name, entity in self.entities.items():
            columns = []
            for fld in entity.fields:
                col = f"    {fld.name} {type_map.get(fld.data_type, 'VARCHAR(255)')}"
                if not fld.nullable:
                    col += " NOT NULL"
                if ConstraintType.PRIMARY_KEY in fld.constraints:
                    col += " PRIMARY KEY"
                columns.append(col)

            sql.append(f"CREATE TABLE {name} (\n" + ",\n".join(columns) + "\n);")

        for rel in self.relationships:
            sql.append(f"""ALTER TABLE {rel.from_entity}
ADD CONSTRAINT fk_{rel.name}
FOREIGN KEY ({rel.from_field}) REFERENCES {rel.to_entity}({rel.to_field});""")

        return "\n\n".join(sql)

    def generate_json_schema(self) -> Dict[str, Any]:
        """Generate JSON Schema representation."""

        schemas = {}
        for name, entity in self.entities.items():
            properties = {}
            required = []

            for fld in entity.fields:
                prop = {"description": fld.description}
                if fld.data_type == DataType.STRING:
                    prop["type"] = "string"
                elif fld.data_type == DataType.INTEGER:
                    prop["type"] = "integer"
                elif fld.data_type == DataType.FLOAT:
                    prop["type"] = "number"
                elif fld.data_type == DataType.BOOLEAN:
                    prop["type"] = "boolean"
                else:
                    prop["type"] = "string"

                properties[fld.name] = prop
                if not fld.nullable:
                    required.append(fld.name)

            schemas[name] = {
                "type": "object",
                "title": entity.description,
                "properties": properties,
                "required": required
            }
        return schemas

    def generate_er_diagram(self) -> str:
        """Generate Mermaid ER diagram."""

        lines = ["erDiagram"]
        for name, entity in self.entities.items():
            for fld in entity.fields[:5]:
                lines.append(f"    {name} {{")
                lines.append(f"        {fld.data_type.value} {fld.name}")
                lines.append("    }")

        for rel in self.relationships:
            rel_symbol = {
                RelationType.ONE_TO_ONE: "||--||",
                RelationType.ONE_TO_MANY: "||--o{",
                RelationType.MANY_TO_MANY: "}o--o{"
            }.get(rel.relation_type, "||--o{")
            lines.append(f"    {rel.from_entity} {rel_symbol} {rel.to_entity} : \"{rel.name}\"")

        return "\n".join(lines)

    def validate_model(self) -> List[str]:
        """Validate data model for issues."""

        issues = []
        for rel in self.relationships:
            if rel.from_entity not in self.entities:
                issues.append(f"Missing entity: {rel.from_entity}")
            if rel.to_entity not in self.entities:
                issues.append(f"Missing entity: {rel.to_entity}")

        for name, entity in self.entities.items():
            has_pk = any(ConstraintType.PRIMARY_KEY in f.constraints for f in entity.fields)
            if not has_pk:
                issues.append(f"Entity '{name}' has no primary key")

        return issues


class ConstructionEntities:
    """Standard construction data entities."""

    @staticmethod
    def project_entity() -> Entity:
        return Entity(
            name="projects",
            description="Construction projects",
            fields=[
                Field("id", DataType.INTEGER, False, constraints=[ConstraintType.PRIMARY_KEY]),
                Field("code", DataType.STRING, False, constraints=[ConstraintType.UNIQUE]),
                Field("name", DataType.STRING, False),
                Field("status", DataType.STRING),
                Field("start_date", DataType.DATE),
                Field("end_date", DataType.DATE),
                Field("budget", DataType.FLOAT)
            ]
        )

    @staticmethod
    def activity_entity() -> Entity:
        return Entity(
            name="activities",
            description="Schedule activities",
            fields=[
                Field("id", DataType.INTEGER, False, constraints=[ConstraintType.PRIMARY_KEY]),
                Field("project_id", DataType.INTEGER, False),
                Field("wbs_code", DataType.STRING),
                Field("name", DataType.STRING, False),
                Field("start_date", DataType.DATE),
                Field("end_date", DataType.DATE),
                Field("percent_complete", DataType.FLOAT)
            ]
        )

    @staticmethod
    def cost_item_entity() -> Entity:
        return Entity(
            name="cost_items",
            description="Project cost items",
            fields=[
                Field("id", DataType.INTEGER, False, constraints=[ConstraintType.PRIMARY_KEY]),
                Field("project_id", DataType.INTEGER, False),
                Field("wbs_code", DataType.STRING),
                Field("description", DataType.STRING),
                Field("budgeted_cost", DataType.FLOAT),
                Field("actual_cost", DataType.FLOAT)
            ]
        )
```

## Quick Start

```python
# Create model
model = ConstructionDataModel("Office Building A")

# Add standard entities
model.add_entity(ConstructionEntities.project_entity())
model.add_entity(ConstructionEntities.activity_entity())
model.add_entity(ConstructionEntities.cost_item_entity())

# Add relationships
model.create_relationship("activities", "projects")
model.create_relationship("cost_items", "projects")

# Generate SQL
sql = model.generate_sql_schema("postgresql")
print(sql)
```

## Common Use Cases

### 1. Custom Entity
```python
model.create_entity(
    name="change_orders",
    description="Project change orders",
    fields=[
        {"name": "id", "type": "integer", "nullable": False, "constraints": ["primary_key"]},
        {"name": "project_id", "type": "integer", "nullable": False},
        {"name": "amount", "type": "float"},
        {"name": "status", "type": "string"}
    ]
)
```

### 2. Generate ER Diagram
```python
er_diagram = model.generate_er_diagram()
print(er_diagram)
```

### 3. Validate Model
```python
issues = model.validate_model()
for issue in issues:
    print(f"Issue: {issue}")
```

## Resources
- **DDC Book**: Chapter 2.5 - Data Models and Standards
- **Website**: https://datadrivenconstruction.io

© datadrivenconstruction · MIT · datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction

Похожие скиллы

Все скиллы по теме «Данные и базы» →
database-scout zebbern Скилл database-scout для чтения схем SQLite и PostgreSQL: показывает таблицы, колонки, связи и рисует Mermaid ER-диаграммы. Запросы только на чтение. CX Codex +1 ★ 4 719звёзд репо data-model-creation TencentCloudBase Скилл data-model-creation для Claude Code описывает сущности базы диаграммами Mermaid и создаёт структуры данных в Tencent CloudBase. Визуально проектирует сложные связи до написания SQL. CX Codex +1 1 000установок database-schema-designer softaworks Плагин database-schema-designer помогает проектировать схемы баз данных SQL и NoSQL: выбрать нормализацию, продумать индексы и подготовить миграции. ★ 2 707звёзд репо schema-designer rohitg00 Плагин schema-designer для Claude Code генерирует диаграммы сущностей и связей (ERD) и помогает проектировать схемы баз данных. Запускается прямо в редакторе, чтобы визуализировать структуру данных и связи между таблицами. ★ 2 858звёзд репо spanner-data cline Скилл spanner-data для изучения структуры Google Cloud Spanner и запуска SQL-запросов. Помогает просматривать таблицы, графы и выполнять выборки данных. CX Codex +1 869установок database-designer Alireza Rezvani Скилл database-designer для Claude Code проектирует схемы БД, анализирует индексы и готовит миграции. Проверяет структуру и помогает изменить её без резкого переключения приложения. CX Codex +1 819установок

Из того же набора156

Весь набор →
toolbox-talk-generator Скилл toolbox-talk-generator генерирует инструктажи по безопасности для строительных бригад с учётом работ, погоды, происшествий и сезонных рисков. Поддерживает несколько языков. CX Codex +1 117установок cwicr-bid-analyzer Скилл cwicr-bid-analyzer сравнивает предложения подрядчиков с базой расценок CWICR. Находит завышенные или заниженные позиции и помогает объективно оценить сметы. CX Codex +1 117установок cwicr-waste-calculator Скилл cwicr-waste-calculator для Claude Code рассчитывает потери материалов по нормам CWICR. Он подключается к запросам о запасе на подрезку, проливы и бой. CX Codex +1 117установок weather-impact-scheduler Скилл weather-impact-scheduler для Claude Code сопоставляет прогноз погоды с графиком стройки, выявляет риски и оценивает задержки. Планирование наружных работ с учётом погоды. CX Codex +1 117установок material-tracker Скилл material-tracker ведёт заказы, поставки и остатки материалов на стройке. Помогает отслеживать сроки доставки и замечать риск нехватки запасов. CX Codex +1 116установок lien-waiver-tracker Скилл lien-waiver-tracker отслеживает отказные расписки (lien waivers) субподрядчиков и контролирует финансовые риски перед выплатами на стройке. Помогает не пропустить обязательные документы до перечисления денег. CX Codex +1 116установок equipment-telematics Скилл equipment-telematics обрабатывает телематику строительной техники: ведёт учёт моточасов, контролирует геозоны, расход топлива и напоминает о сервисном обслуживании. CX Codex +1 116установок predictive-analytics-construction Скилл predictive-analytics-construction прогнозирует перерасход бюджета, задержки сроков и риски строительного проекта по историческим данным. CX Codex +1 116установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой