> ## Documentation Index
> Fetch the complete documentation index at: https://docs.baimoqilin.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Personalidad soul

> Crea y cambia archivos soul para definir la identidad, personalidad y estilo de habla de MineClawd.

## Qué es un soul

Un soul es la ficha de personaje de MineClawd.
Define quién es el agente, cómo habla y cómo se comporta con las personas.

Piensa en él como personalidad, no como un script de tareas.

* Buen contenido para un soul: identidad, temperamento, tono y comportamiento social.
* Mal contenido para un soul: recetas largas de comandos, instrucciones de herramientas o pasos puntuales de flujo de trabajo.

<Note>
  Incluso si un soul usa un nombre de personaje distinto, la identidad del proyecto y la herramienta sigue siendo MineClawd.
</Note>

## Souls incluidos

MineClawd viene con:

* `default`
* `yuki`

`yuki` es el soul de estilo mascota y una buena referencia de estructura.

## Ubicación de archivos soul

* Directorio de souls: `mineclawd/souls/`
* Puntero de soul activo por propietario: `mineclawd/souls/.active/<owner>.txt`

Cada operador puede mantener un soul activo diferente en el mismo servidor.

## Mostrar y cambiar souls

```bash theme={null}
/mineclawd persona
/mineclawd persona yuki
/mineclawd persona default
```

<Info>
  No puedes cambiar souls mientras una solicitud está en ejecución.
  Espera a que termine y luego ejecuta `/mineclawd persona <soul>`.
</Info>

## Crear un soul personalizado

1. Crea un archivo markdown en `mineclawd/souls/`, por ejemplo `mineclawd/souls/mentor.md`.
2. Escribe el contenido de la personalidad con la estructura de abajo.
3. Ejecuta `/mineclawd persona mentor`.
4. Envía algunos prompts normales y ajusta la voz.

## Plantilla para escribir souls

```md theme={null}
### Rol e identidad
Eres [nombre], [identidad breve].

### Personalidad
1. [Rasgo central 1]
2. [Rasgo central 2]
3. [Rasgo central 3]

### Estilo de habla
- Tono: [amigable/tranquilo/juguetón/etc.]
- Hábitos verbales: [frases cortas, muletillas ocasionales, etc.]
- Comportamiento de idioma: [cómo te adaptas al idioma del usuario]

### Guías de interacción
- Cuando el usuario se atasca: [consuelo + comportamiento de recuperación]
- Cuando el usuario tiene éxito: [comportamiento de celebración]
- Nunca rompas el personaje.
```

## Consejos prácticos

* Mantén un tono emocional consistente en todas las secciones.
* Prefiere señales de voz concretas en vez de adjetivos vagos.
* Deja el comportamiento operativo en prompts y documentación, no en archivos soul.
* Lee el `yuki.md` incluido antes de diseñar tu propio soul.