gh-gijsbartman-hogeschool-utrecht-plugins-open-ict/skills/competenties/vaardigheden.md

Studentvaardigheden

Overview

Deze sectie beschrijft hoe je studentvaardigheden uit het Open-ICT competentiekader kunt ophalen. Het framework bevat tien kernvaardigheden die worden beoordeeld in het Open-ICT curriculum, elk met vier niveaus die oplopende complexiteit en zelfstandigheid representeren.

Beschikbare Vaardigheden

De volgende tien vaardigheden zijn beschikbaar:

1. Juiste kennis ontwikkelen: Het vermogen om relevante kennis te identificeren, te verwerven en toe te passen
2. Kwalitatief product maken: Het vermogen om producten te maken die voldoen aan kwaliteitscriteria
3. Overzicht creëren: Het vermogen om informatie te verzamelen en overzichtelijk weer te geven
4. Kritisch oordelen: Het vermogen om verkregen informatie te verwerken en onderbouwde conclusies te trekken
5. Samenwerken: Het vermogen om effectief samen te werken in teams
6. Boodschap delen: Het vermogen om informatie en ideeën duidelijk te communiceren
7. Plannen: Het vermogen om activiteiten te plannen en te organiseren
8. Flexibel opstellen: Het vermogen om flexibel te reageren op veranderende omstandigheden
9. Pro-actief handelen: Het vermogen om proactief te handelen en initiatief te nemen
10. Reflecteren: Het vermogen om te reflecteren op eigen handelen en leerproces

Workflow Scenarios

Scenario 1: Overzicht en Onderzoek (VERPLICHT: Alle Vaardigheden Ophalen)

Wanneer te gebruiken:

• Wanneer het nog niet duidelijk is aan welke vaardigheid er wordt gewerkt
• Wanneer de gebruiker wilt weten welke vaardigheden relevant zijn voor een bepaald bewijsstuk
• Wanneer je een overzicht nodig hebt van alle beschikbare vaardigheden en hun niveaus
• Bij het analyseren van bewijsstukken om te bepalen welke vaardigheden van toepassing zijn

VERPLICHTE WORKFLOW:

1. VOER UIT: python scripts/vaardigheden.py (zonder enige argumenten of filters)
2. GEBRUIK ALLEEN: De data die wordt gereturned door het script
3. VERBODEN: Het is NIET TOEGESTAAN om zelf criteria voor vaardigheden in te vullen of te verzinnen
4. VERBODEN: Het is NIET TOEGESTAAN om alleen een subset van vaardigheden op te halen in dit scenario
5. ANALYSEER: Gebruik de volledige dataset om te bepalen welke vaardigheden relevant zijn

Voorbeeld gebruik:

python scripts/vaardigheden.py

Resultaat: JSON object met alle tien vaardigheden, elk met alle vier niveaus (1-4). Gebruik deze volledige dataset om te analyseren welke vaardigheden relevant zijn.

Scenario 2: Specifieke Vaardigheid Bekend

Wanneer te gebruiken:

• Wanneer er al duidelijk is aan welke specifieke vaardigheid wordt gewerkt
• Wanneer de gebruiker expliciet vraagt naar een specifieke vaardigheid
• Wanneer je alleen informatie nodig hebt over één of meerdere specifieke vaardigheden

WORKFLOW:

2a. Één Specifieke Vaardigheid

Wanneer: Er is één specifieke vaardigheid bekend

VOER UIT:

python scripts/vaardigheden.py --skill "Vaardigheidsnaam"

BELANGRIJK:

• Gebruik de exacte vaardigheidsnaam zoals vermeld in de lijst hierboven
• Voeg GEEN --level filter toe tenzij expliciet gevraagd naar een specifiek niveau
• Haal alle niveaus op voor de vaardigheid, tenzij expliciet anders gevraagd

Voorbeeld:

python scripts/vaardigheden.py --skill "Samenwerken"

Resultaat: JSON object met alleen de "Samenwerken" vaardigheid, inclusief alle vier niveaus.

2b. Meerdere Specifieke Vaardigheden

Wanneer: Er zijn meerdere specifieke vaardigheden bekend

VERPLICHTE WORKFLOW:

1. VOER MEERDERE REQUESTS UIT: Maak voor elke vaardigheid een aparte request naar het Python script
2. GEEN COMBINATIE: Je kunt niet meerdere vaardigheden in één request ophalen
3. VOOR ELKE VAARDIGHEID: Voer python scripts/vaardigheden.py --skill "Vaardigheidsnaam" uit

Voorbeeld bij 3 vaardigheden:

python scripts/vaardigheden.py --skill "Samenwerken"
python scripts/vaardigheden.py --skill "Kritisch oordelen"
python scripts/vaardigheden.py --skill "Reflecteren"

Resultaat: Drie aparte JSON objecten, één voor elke vaardigheid met alle vier niveaus.

2c. Specifiek Niveau (Alleen Wanneer Expliciet Gevraagd)

Wanneer: De gebruiker vraagt expliciet naar een specifiek niveau (bijv. "niveau 2", "level 3")

VERPLICHTE WORKFLOW:

1. GEBRUIK --level FILTER: Voeg --level toe aan de command alleen wanneer expliciet gevraagd
2. COMBINEER MET --skill: Als er ook een specifieke vaardigheid bekend is, combineer beide filters
3. GEEN NIVEAU FILTER: Als er geen specifiek niveau wordt genoemd, haal alle niveaus op

Voorbeelden:

# Specifieke vaardigheid op specifiek niveau (expliciet gevraagd)
python scripts/vaardigheden.py --skill "Reflecteren" --level 3

# Alle vaardigheden op specifiek niveau (expliciet gevraagd)
python scripts/vaardigheden.py --level 2

# Specifieke vaardigheid zonder niveau (geen niveau genoemd)
python scripts/vaardigheden.py --skill "Samenwerken"

Kritieke Regels

VERPLICHT: Gebruik Alleen Gereturned Data

KRITIEK: Je MOET alleen de data gebruiken die wordt gereturned door het Python script.

VERBODEN:

• ❌ Het verzinnen of invullen van criteria voor vaardigheden
• ❌ Het gebruik van kennis over vaardigheden die niet in de gereturned data staat
• ❌ Het aannemen van wat een vaardigheid zou moeten zijn zonder de data te raadplegen

VERPLICHT:

• ✅ Gebruik alleen de title en info velden uit de gereturned JSON
• ✅ Baseer alle analyses en conclusies op de daadwerkelijke data
• ✅ Raadpleeg altijd de volledige dataset wanneer onzekerheid bestaat

VERPLICHT: Scenario 1 bij Onzekerheid

KRITIEK: Wanneer het niet duidelijk is welke vaardigheid relevant is, MOET je Scenario 1 gebruiken (alle vaardigheden ophalen).

VERBODEN:

• ❌ Het gissen naar welke vaardigheid relevant zou kunnen zijn
• ❌ Het ophalen van alleen een subset van vaardigheden "omdat je denkt dat die relevant zijn"
• ❌ Het overslaan van het ophalen van alle data bij onzekerheid

VERPLICHT:

• ✅ Bij twijfel: gebruik altijd Scenario 1
• ✅ Haal alle vaardigheden op wanneer je moet bepalen welke relevant zijn
• ✅ Analyseer de volledige dataset om te bepalen welke vaardigheden van toepassing zijn

VERPLICHT: Meerdere Requests voor Meerdere Vaardigheden

KRITIEK: Wanneer je meerdere specifieke vaardigheden nodig hebt, maak je meerdere aparte requests.

VERBODEN:

• ❌ Het proberen om meerdere vaardigheden in één request te combineren
• ❌ Het ophalen van alle vaardigheden wanneer je alleen specifieke nodig hebt (tenzij Scenario 1 van toepassing is)

VERPLICHT:

• ✅ Maak voor elke vaardigheid een aparte request
• ✅ Voer elk script commando apart uit
• ✅ Verwerk de resultaten van elke request afzonderlijk

VERPLICHT: Niveau Filter Alleen bij Expliciete Vraag

KRITIEK: Gebruik de --level filter alleen wanneer de gebruiker expliciet vraagt naar een specifiek niveau.

VERBODEN:

• ❌ Het toevoegen van --level "omdat je denkt dat het handig is"
• ❌ Het filteren op niveau zonder expliciete vraag van de gebruiker
• ❌ Het aannemen van een niveau zonder dat dit wordt genoemd

VERPLICHT:

• ✅ Gebruik --level alleen wanneer expliciet gevraagd (bijv. "niveau 2", "level 3", "op niveau 4")
• ✅ Haal standaard alle niveaus op voor de geselecteerde vaardigheid(en)
• ✅ Laat de gebruiker alle niveaus zien tenzij specifiek anders gevraagd

Script Gebruik

Basis Commando

Het Python script scripts/vaardigheden.py wordt gebruikt om vaardigheden op te halen:

python scripts/vaardigheden.py [--skill SKILL] [--level LEVEL]

Argumenten en Opties

• --skill SKILL: De naam van een specifieke vaardigheid om op te halen

  • Als niet opgegeven: haalt alle vaardigheden op (Scenario 1)
  • Moet exact overeenkomen met een van de tien geldige vaardigheidsnamen
  • Hoofdlettergevoelig

• --level LEVEL: Filter op specifiek niveau (1, 2, 3, of 4)

  • ALLEEN gebruiken wanneer expliciet gevraagd naar een specifiek niveau
  • Optioneel: kan gecombineerd worden met --skill
  • Als niet opgegeven: haalt alle niveaus op voor de geselecteerde vaardigheid(en)

• -h of --help: Toont gebruiksinformatie en sluit af

Response Formaat

Scenario 1 - Alle vaardigheden (zonder argumenten):

{
  "Juiste kennis ontwikkelen": {
    "1": {
      "title": "Student bepaalt welke kennis..."
    },
    "2": {
      "title": "niveau 1 + \n\nStudent kijkt naar gangbare..."
    },
    "3": {
      "title": "niveau 2 + \n\nStudent kijkt zelfstandig..."
    },
    "4": {
      "title": "niveau 3 + \n\nStudent laat zien..."
    }
  },
  "Kwalitatief product maken": {
    "1": { "title": "..." },
    "2": { "title": "..." },
    "3": { "title": "..." },
    "4": { "title": "..." }
  },
  ...
}

Scenario 2a - Specifieke vaardigheid (zonder niveau filter):

{
  "Samenwerken": {
    "1": { "title": "..." },
    "2": { "title": "..." },
    "3": { "title": "..." },
    "4": { "title": "..." }
  }
}

Scenario 2c - Specifieke vaardigheid op specifiek niveau:

{
  "Reflecteren": {
    "3": {
      "title": "..."
    }
  }
}

Sommige niveaus kunnen ook een info veld bevatten met aanvullende informatie, links naar bronnen, of voorbeelden.

Validatie en Foutafhandeling

Validatie

Het script valideert automatisch:

1. Vaardigheidsnaam: Controleert of de opgegeven naam exact overeenkomt met een van de tien geldige vaardigheden
2. Niveau: Controleert of het niveau een geldige waarde is (1, 2, 3, of 4)
3. Data bestand: Controleert of het benodigde JSON bestand bestaat

Foutmeldingen

Ongeldige vaardigheidsnaam:

Error: Invalid skill: Ongeldige naam
Valid skills: Juiste kennis ontwikkelen, Kwalitatief product maken, ...

Ongeldig niveau:

Error: Invalid level: 5 (must be 1-4)

Ontbrekend data bestand:

Error: Data file not found: /path/to/vaardigheden-nl.json

Geen resultaten:

No skills found with the specified filters

Alle foutmeldingen worden naar stderr geschreven. Het script eindigt met exit code 1 bij fouten.

Exit Codes

• 0: Succesvol uitgevoerd
• 1: Fout opgetreden (ongeldige input, ontbrekend bestand, geen resultaten)

Best Practices Samenvatting

1. Bij onzekerheid: Gebruik altijd Scenario 1 (alle vaardigheden ophalen)
2. Gebruik alleen gereturned data: Verzin geen criteria, gebruik alleen wat het script retourneert
3. Meerdere vaardigheden: Maak meerdere aparte requests
4. Niveau filter: Alleen gebruiken wanneer expliciet gevraagd
5. Exacte namen: Vaardigheidsnamen zijn hoofdlettergevoelig en moeten exact overeenkomen
6. Alle niveaus: Haal standaard alle niveaus op tenzij expliciet anders gevraagd