Przejdź do treści
Biblioteka skilli
Dane i analityka · Planowanie

schema-designer

/schema-designer

Pomaga projektować schematy baz danych, tworzyć tabele i planować modele danych.

Repozytorium
whodb ↗
Licencja
Apache-2.0
Ostatnia zmiana repozytorium
25.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 25.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

Co robi i kiedy

Pomaga projektować schematy baz danych, tworzyć tabele i planować modele danych.

Oryginalny opis (EN)

Help design database schemas, create tables, and plan data models. Activates when users ask to create tables, design schemas, or model data relationships.

Jak działa

  1. When to Use
  2. Workflow
  3. Data Type Guidelines
  4. Common Patterns
  5. Best Practices
  6. Migration Safety
Sekcje z nagłówków SKILL.md, w oryginale · 189 linii, 800 słów
Podgląd SKILL.md
---
name: schema-designer
description: Help design database schemas, create tables, and plan data models. Activates when users ask to create tables, design schemas, or model data relationships.
---

# Schema Designer

Help users design database schemas, create tables, and model data relationships.

These database-only MCP tools require the database module enabled through `whodb setup`. Keep the MCP command at `whodb mcp serve`. For platform resources, use the WhoDB skill and discover available `whodb_platform_*` tools instead.

## When to Use

Activate when user asks:
- "Create a table for storing orders"
- "Design a schema for a blog"
- "Add a column to track user preferences"
- "How should I model this relationship?"

## Workflow

### 1. Understand Requirements
Ask clarifying questions:
- What data needs to be stored?
- What are the relationships between entities?
- What queries will be common?
- What's the expected data volume?

### 2. Check Existing Schema
```
whodb_tables() → See what already exists
whodb_columns(table="related_table") → Understand existing structure
```

### 3. Design the Schema
Follow database design principles:
- Normalize to reduce redundancy
- Use appropriate data types
- Define primary keys
- Establish foreign key relationships
- Add indexes for common queries

### 4. Generate DDL
Provide CREATE TABLE statements with explanations.

## Data Type Guidelines

### Identifiers
| Use Case | PostgreSQL | MySQL | SQLite |
|----------|------------|-------|--------|
| Auto-increment ID | `SERIAL` / `BIGSERIAL` | `INT AUTO_INCREMENT` | `INTEGER PRIMARY KEY` |
| UUID | `UUID` | `CHAR(36)` | `TEXT` |

### Text
| Use Case | PostgreSQL | MySQL | SQLite |
|----------|------------|-------|--------|
| Short text (<255) | `VARCHAR(n)` | `VARCHAR(n)` | `TEXT` |
| Long text | `TEXT` | `TEXT` | `TEXT` |
| Fixed length | `CHAR(n)` | `CHAR(n)` | `TEXT` |

### Numbers
| Use Case | PostgreSQL | MySQL | SQLite |
|----------|------------|-------|--------|
| Integer | `INTEGER` | `INT` | `INTEGER` |
| Big integer | `BIGINT` | `BIGINT` | `INTEGER` |
| Decimal (money) | `NUMERIC(10,2)` | `DECIMAL(10,2)` | `REAL` |
| Float | `REAL` | `FLOAT` | `REAL` |

### Dates
| Use Case | PostgreSQL | MySQL | SQLite |
|----------|------------|-------|--------|
| Date only | `DATE` | `DATE` | `TEXT` |
| Timestamp | `TIMESTAMP` | `DATETIME` | `TEXT` |
| With timezone | `TIMESTAMPTZ` | `TIMESTAMP` | `TEXT` |

### Boolean
| PostgreSQL | MySQL | SQLite |
|------------|-------|--------|
| `BOOLEAN` | `TINYINT(1)` | `INTEGER` |

## Common Patterns

### Users Table
```sql
CREATE TABLE users (
    id SERIAL PRIMARY KEY,
    email VARCHAR(255) NOT NULL UNIQUE,
    password_hash VARCHAR(255) NOT NULL,
    name VARCHAR(100),
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

CREATE INDEX idx_users_email ON users(email);
```

### One-to-Many (Orders → Order Items)
```sql
CREATE TABLE orders (
    id SERIAL PRIMARY KEY,
    user_id INTEGER NOT NULL REFERENCES users(id),
    status VARCHAR(20) DEFAULT 'pending',
    total NUMERIC(10,2),
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

CREATE TABLE order_items (
    id SERIAL PRIMARY KEY,
    order_id INTEGER NOT NULL REFERENCES orders(id) ON DELETE CASCADE,
    product_id INTEGER NOT NULL REFERENCES products(id),
    quantity INTEGER NOT NULL DEFAULT 1,
    unit_price NUMERIC(10,2) NOT NULL
);

CREATE INDEX idx_order_items_order ON order_items(order_id);
```

### Many-to-Many (Users ↔ Roles)
```sql
CREATE TABLE roles (
    id SERIAL PRIMARY KEY,
    name VARCHAR(50) NOT NULL UNIQUE
);

CREATE TABLE user_roles (
    user_id INTEGER NOT NULL REFERENCES users(id) ON DELETE CASCADE,
    role_id INTEGER NOT NULL REFERENCES roles(id) ON DELETE CASCADE,
    PRIMARY KEY (user_id, role_id)
);
```

### Soft Delete Pattern
```sql
CREATE TABLE posts (
    id SERIAL PRIMARY KEY,
    title VARCHAR(255) NOT NULL,
    content TEXT,
    deleted_at TIMESTAMP NULL,  -- NULL = not deleted
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

-- Query active posts
SELECT * FROM posts WHERE deleted_at IS NULL;
```

### Audit Trail Pattern
```sql
CREATE TABLE audit_log (
    id SERIAL PRIMARY KEY,
    table_name VARCHAR(50) NOT NULL,
    record_id INTEGER NOT NULL,
    action VARCHAR(10) NOT NULL,  -- INSERT, UPDATE, DELETE
    old_values JSONB,
    new_values JSONB,
    user_id INTEGER REFERENCES users(id),
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

CREATE INDEX idx_audit_table_record ON audit_log(table_name, record_id);
```

## Best Practices

1. **Always define PRIMARY KEY** - Every table needs one
2. **Use foreign keys** - Enforce referential integrity
3. **Add NOT NULL** - Unless the column is truly optional
4. **Create indexes** - On foreign keys and frequently queried columns
5. **Use appropriate types** - Don't store numbers as strings
6. **Add timestamps** - `created_at` and `updated_at` are almost always useful
7. **Name consistently** - `user_id` not `userId` or `UserID`
8. **Avoid reserved words** - Don't name columns `order`, `user`, `group`

## Migration Safety

When modifying existing tables:

```sql
-- Safe: Adding nullable column
ALTER TABLE users ADD COLUMN phone VARCHAR(20);

-- Safe: Adding column with default
ALTER TABLE users ADD COLUMN active BOOLEAN DEFAULT true;

-- Caution: Adding NOT NULL (requires default or backfill)
ALTER TABLE users ADD COLUMN status VARCHAR(20) NOT NULL DEFAULT 'active';

-- Caution: Dropping column (data loss)
ALTER TABLE users DROP COLUMN old_column;

-- Caution: Changing type (may fail on existing data)
ALTER TABLE users ALTER COLUMN age TYPE INTEGER;
```

Wersje

RepozytoriumWynikLicencja
Ta strona · clidey/whodb100Apache-2.0
clidey/whodb100Apache-2.0
armanzeroeight/fastagent-plugins100MIT

Migawka bazy z 13.11.2026 · wersja paczki 476a487aa763 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 1 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100database-designer
    Pomaga projektować schematy baz danych, planować migracje danych, optymalizować zapytania, wybierać między SQL a NoSQL i modelować relacje.
  • 100designing-database-schemas
    Pomaga projektować schematy baz danych i migracje: modelowanie danych oraz tworzenie migracji.
  • 100designing-database-schemas
    Pomaga projektować schematy baz danych i migracje: modelowanie danych oraz tworzenie migracji.
  • 100database-schema-designer
    Tworzy diagramy ERD, normalizuje schematy baz danych, projektuje relacje między tabelami i planuje migracje schematu.
  • 100database-schema-designer
    Projektuje schematy baz SQL i NoSQL gotowe do produkcji: tabele, diagramy ERD, model danych, normalizacja, plan migracji i strategia indeksów.
  • 100dba-designer
    Wciela się w architekta baz danych i pomaga projektować schematy, strategie wydajności i bezpieczeństwo oraz recenzować modele danych, indeksy i diagramy ER.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.