74 lines
No EOL
1.9 KiB
Markdown
74 lines
No EOL
1.9 KiB
Markdown
# pkg/persona
|
|
|
|
> 🌐 **Idioma:** [English](README.md) | [Español](README.es.md)
|
|
|
|
|
|
> Sistema de personalidades configurables para agentes LLM.
|
|
|
|
## Responsabilidad
|
|
|
|
Ensamblar el system prompt final del agente combinando:
|
|
|
|
1. **Base prompt** (hardcoded en la librería)
|
|
2. **Persona YAML** (configurable por proyecto)
|
|
3. **AGENTS.md** (instrucciones del proyecto, descubierto por búsqueda en árbol de directorios)
|
|
4. **Working memory context** (resúmenes si hay compaction)
|
|
|
|
## API pública
|
|
|
|
```go
|
|
type Persona struct {
|
|
ID string
|
|
Name string
|
|
Tone string
|
|
Style string
|
|
Language string
|
|
Constraints []string
|
|
FewShot []llm.Message
|
|
}
|
|
|
|
type Loader interface {
|
|
Load(ctx context.Context, configPath string) (Persona, error)
|
|
Discover(ctx context.Context, workdir string) (Persona, error) // incluye AGENTS.md
|
|
}
|
|
```
|
|
|
|
## Formato YAML
|
|
|
|
```yaml
|
|
id: pragmatista
|
|
name: Pragmatista
|
|
tone: "Directo y profesional"
|
|
style: "Enfoque Go idiomatic"
|
|
language: "Español, con términos técnicos en inglés"
|
|
constraints:
|
|
- "No usar interface{} en código nuevo"
|
|
- "Siempre wrapped errors con %w"
|
|
few_shot:
|
|
- role: user
|
|
content: "Refactoriza este código"
|
|
- role: assistant
|
|
content: "Listo. Optimizado. ¿Aplico?"
|
|
```
|
|
|
|
## AGENTS.md discovery
|
|
|
|
El loader busca `./AGENTS.md`, sube al directorio padre, etc., concatenando todos los encontrados hasta llegar a `~` o `/`. También incluye `~/.config/rony/AGENTS.md` como default global.
|
|
|
|
```
|
|
/home/user/proyecto/AGENTS.md ← incluye
|
|
/home/user/AGENTS.md ← incluye
|
|
/home/AGENTS.md ← incluye
|
|
~/.config/rony/AGENTS.md ← incluye
|
|
```
|
|
|
|
## Uso
|
|
|
|
```go
|
|
p, err := persona.Discover(ctx, "/home/user/mi-proyecto")
|
|
// p.Content incluye todo lo anterior concatenado
|
|
```
|
|
|
|
## Ver también
|
|
|
|
- [pkg/agent](../agent/README.md) — Usa la persona en el system prompt |