Saltar al contenido principal

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.

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.