adventure-manager

name	adventure-manager
description	Gère les aventures/campagnes BFRPG. Crée et charge des aventures, gère le groupe de personnages, l'inventaire partagé, les sessions de jeu et le journal automatique. Utilisez pour toute gestion de campagne.
allowed-tools	["Bash","Read"]

Adventure Manager - Gestionnaire d'Aventures BFRPG

Skill pour créer et gérer des aventures/campagnes dans Basic Fantasy RPG.

Utilisation Rapide

# Compiler si nécessaire
go build -o sw-adventure ./cmd/adventure

# Créer une aventure
./sw-adventure create "La Mine Perdue" "Une aventure dans les montagnes"

Commandes Disponibles

Gestion des Aventures

# Créer une aventure
./sw-adventure create "La Mine Perdue" "Description optionnelle"

# Lister les aventures
./sw-adventure list

# Afficher une aventure
./sw-adventure show "La Mine Perdue"

# Statut complet
./sw-adventure status "La Mine Perdue"

# Supprimer
./sw-adventure delete "La Mine Perdue"

Gestion du Groupe

# Ajouter un personnage à l'aventure
./sw-adventure add-character "La Mine Perdue" "Aldric"
./sw-adventure add-character "La Mine Perdue" "Lyra"

# Retirer un personnage
./sw-adventure remove-character "La Mine Perdue" "Aldric"

# Afficher le groupe
./sw-adventure party "La Mine Perdue"

Inventaire Partagé

# Voir l'inventaire
./sw-adventure inventory "La Mine Perdue"

# Ajouter de l'or
./sw-adventure add-gold "La Mine Perdue" 50 "Trésor gobelin"
./sw-adventure add-gold "La Mine Perdue" -10 "Achat de rations"

# Ajouter des objets
./sw-adventure add-item "La Mine Perdue" "Potion de soin" 3
./sw-adventure add-item "La Mine Perdue" "Corde 50 pieds"

# Retirer des objets
./sw-adventure remove-item "La Mine Perdue" "Potion de soin" 1

Sessions de Jeu

# Démarrer une session
./sw-adventure start-session "La Mine Perdue"

# Terminer une session
./sw-adventure end-session "La Mine Perdue" "Le groupe a exploré le premier niveau"

# Lister les sessions
./sw-adventure sessions "La Mine Perdue"

Journal Automatique

# Ajouter une entrée au journal
./sw-adventure log "La Mine Perdue" combat "Le groupe affronte 3 gobelins"
./sw-adventure log "La Mine Perdue" loot "Trouvé 20 po et une dague +1"
./sw-adventure log "La Mine Perdue" story "Les aventuriers arrivent à Valdris"
./sw-adventure log "La Mine Perdue" quest "Nouvelle quête: Retrouver le marchand"

# Voir le journal
./sw-adventure journal "La Mine Perdue"

# Journal d'une session spécifique
./sw-adventure journal "La Mine Perdue" --session=1

# Dernières entrées
./sw-adventure journal "La Mine Perdue" --recent=10

Types d'Entrées Journal

Type	Icône	Usage
combat	⚔️	Rencontres et combats
loot	💰	Trésors trouvés
story	📖	Progression narrative
note	📝	Notes diverses
quest	🎯	Quêtes et objectifs
npc	👤	Interactions PNJ
location	📍	Nouveaux lieux
rest	🏕️	Repos
death	💀	Morts de personnages
levelup	⬆️	Montées de niveau

Structure des Fichiers

Une aventure crée le répertoire suivant :

data/adventures/la-mine-perdue/
├── adventure.json         # Métadonnées de l'aventure
├── party.json             # Groupe et formation
├── inventory.json         # Inventaire partagé
├── sessions.json          # Historique des sessions
├── journal-meta.json      # Métadonnées journal (NextID, Categories)
├── journal-session-0.json # Journal hors session
├── journal-session-1.json # Journal session 1
├── journal-session-N.json # Journal session N
├── state.json             # État du jeu
├── images/
│   ├── session-0/         # Images hors session
│   ├── session-1/         # Images session 1
│   └── session-N/         # Images session N
└── characters/            # Copies des personnages
    ├── aldric.json
    └── lyra.json

Note : Le journal est organisé par session pour optimiser les performances. Les commandes CLI fonctionnent de manière transparente avec cette structure.

Workflow Typique

1. Créer l'aventure

./sw-adventure create "La Mine Perdue" "Les aventuriers explorent une mine abandonnée"

2. Ajouter les personnages

./sw-adventure add-character "La Mine Perdue" "Aldric"
./sw-adventure add-character "La Mine Perdue" "Lyra"
./sw-adventure add-character "La Mine Perdue" "Gorim"

3. Démarrer une session

./sw-adventure start-session "La Mine Perdue"

4. Pendant la partie

# Noter les événements importants
./sw-adventure log "La Mine Perdue" story "Les aventuriers arrivent à l'entrée de la mine"
./sw-adventure log "La Mine Perdue" combat "Combat contre 4 gobelins - victoire"
./sw-adventure add-gold "La Mine Perdue" 35 "Butin gobelins"
./sw-adventure log "La Mine Perdue" loot "Trouvé: épée courte, 35 po"

5. Terminer la session

./sw-adventure end-session "La Mine Perdue" "Premier niveau de la mine exploré"

6. Consulter le statut

./sw-adventure status "La Mine Perdue"

Intégration avec autres Skills

• dice-roller : Pour les jets de dés pendant la partie
• character-generator : Pour créer les personnages avant de les ajouter

Exemple de Sortie

Commande status

# La Mine Perdue

*Les aventuriers explorent une mine abandonnée*

## Informations
- **Statut** : active
- **Sessions** : 3
- **Dernière partie** : 15/12/2024 20:30

## Groupe
**Formation** : travel
- Aldric (human fighter N1) - PV: 9/9
- Lyra (elf magic-user N1) - PV: 5/5
- Gorim (dwarf cleric N1) - PV: 7/7

## Inventaire
**Or** : 185 po
**Objets** : 5

## Derniers événements
- `15/12 20:15` 📖 Découverte d'une salle secrète
- `15/12 20:00` ⚔️ Combat contre le chef gobelin
- `15/12 19:45` 💰 Trouvé coffre: 50 po, potion

Conseils d'Utilisation

• Démarrez toujours une session avant de jouer pour tracker le temps
• Utilisez log régulièrement pour maintenir un historique
• Les événements sont automatiquement horodatés
• L'or peut être négatif pour les dépenses (utilisez un nombre négatif)
• Le journal génère automatiquement un résumé par session

Utilisé par

Ce skill est utilisé par les agents suivants :

Agent	Usage
dungeon-master	Gestion sessions, journal, inventaire

Type : Skill autonome, peut être invoqué directement via /adventure-manager

Dépendances : Utilise dice-roller et character-generator en complément