Deze handleiding beschrijft hoe je Skills ontwikkelt en integreert in het PMA framework.
Skills zijn gespecialiseerde AI-assistenten die complexe taken automatiseren binnen PMA. Ze combineren:
| Skill | Beschrijving | Aanroep |
|---|---|---|
/install-service |
Nieuwe service installeren | /install-service |
/add-sso |
SSO configuratie | /add-sso SERVICE |
/retro |
Retrospective analyse | /retro |
/standup |
Dagelijkse standup rapport | /standup |
Skills worden opgeslagen in .claude/commands/:
.claude/
commands/
install-service.md # Service installatie
add-sso.md # SSO configuratie
retro.md # Retrospective
standup.md # Standup rapport
touch .claude/commands/my-skill.md
Een skill bestand volgt deze structuur:
Maak bijbehorende just commands in scripts/modules/my-skill.just:
# My Skill Commands
# Learnings:
# - Documenteer wat je geleerd hebt
my-skill-run:
@echo "Running my skill..."
Voeg toe aan scripts/modules/imports.just:
import "my-skill.just"
Bij het maken van een nieuwe skill, verifieer ALLE punten:
.claude/commands/{name}.mdscripts/modules/{name}.justscripts/modules/imports.justscripts/pma.sh) als user-facinginstall-service.md - als relevant voor nieuwe servicespackage-install.py - post-install hints tonenjust --list | grep {name} toont commands/retro check passeert (PMA Dashboard Integriteit)Skills moeten een specifieke, afgebakende taak hebben:
Skills moeten veilig meerdere keren uitgevoerd kunnen worden:
# Check eerst of al geconfigureerd
just sso-check SERVICE && exit 0
# Anders configureren
just sso-add SERVICE
# Bied preview optie
just sso-add SERVICE --dry-run
# Preflight checks
just sso-preflight SERVICE || exit 1
# Rollback bij fout
just sso-add SERVICE || just sso-rollback SERVICE
Voeg learnings toe aan just files:
# Service Commands
# Learnings:
# - API vereist header X-Custom-Header
# - Container moet 30s wachten op startup
Deze skill begeleidt de installatie van een nieuwe service:
just package create SERVICEjust package install SERVICEDeze skill configureert Single Sign-On: