Saltar al contenido principal

​
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.
Incluso si un soul usa un nombre de personaje distinto, la identidad del proyecto y la herramienta sigue siendo MineClawd.

​
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

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

​
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

### 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.