Ir al contenido
Documentation

Personalice el agente de IA

Todo lo que aparece en esta página es un archivo local. Los archivos en .champrep/ en un repositorio se comparten con su equipo a través de git; los archivos bajo $CONFIG/ai/ se aplican únicamente a usted, en todos los proyectos. Cuando un proyecto y una definición de usuario tienen el mismo nombre, prevalece la del proyecto.

Contenido del proyecto en .champrep/ permanece inactiva hasta que autorice el repositorio. Véase Confianza del repositorio.

CHAMPREP.md contiene instrucciones permanentes para el agente: cómo compilar y probar el proyecto, las convenciones y lo que se debe evitar. El agente lee, al inicio de cada sesión:

  • $CONFIG/ai/CHAMPREP.md, sus instrucciones personales para cada proyecto;
  • CHAMPREP.md en la raíz del proyecto y en cada directorio desde la raíz hasta el lugar donde inició el agente.

Si un directorio no tiene CHAMPREP.md, un AGENTS.md se utiliza en su lugar.

AcciónCómo
Crear uno/init analiza el repositorio y escribe CHAMPREP.md, conservando el contenido útil de una ya existente AGENTS.md.
Añadir una notaInicie un prompt con #, por ejemplo # run make lint before committing.
Ver o editar/memory, o /memory edit [user|project|FILE] para abrirla en su editor.

La memoria de su cuentaCHAMPREP AI, gestionada en su configuraciónCHAMPREP AI en la web, también se aplica en el terminal. /memory lo muestra como de solo lectura.

Un comando personalizado es una plantilla de solicitud en Markdown que se ejecuta como /<name>.

UbicaciónÁmbito de aplicación
.champrep/commands/NAME.mdEste proyecto
$CONFIG/ai/commands/NAME.mdUsted

Un archivo en una subcarpeta, como commands/git/commit.md, se convierte en /git:commit. Cree uno con /commands new NAME y visualícelos con /commands.

---
description: Explain a failing test and propose a fix
argument-hint: <test name>
allowed-tools: [local_read_file, local_grep, local_bash]
---
Find the test named $1, run it, and explain why it fails.
Relevant notes: @docs/testing.md
Recent changes:
!`git log --oneline -5`
  • $ARGUMENTS es todo lo que viene después del nombre del comando; $1, $2, … son argumentos únicos. Si la plantilla no utiliza ninguno de ellos, los argumentos se añaden al final.
  • @path incluye un archivo del espacio de trabajo. Los archivos secretos nunca se incluyen.
  • !`command` ejecuta un comando al invocar la plantilla. Se le pedirá que lo apruebe una vez por cada plantilla y de nuevo cada vez que esta cambie.
  • allowed-tools limita las herramientas para ese turno, y model anula el modelo.

Una «skill» es una carpeta de instrucciones, y archivos de apoyo opcionales, que el agente carga únicamente cuando la necesita. Hasta entonces, el modelo solo ve el nombre y la descripción de la «skill», por lo que muchas «skills» requieren muy poco contexto.

UbicaciónÁmbito de aplicación
.champrep/skills/NAME/SKILL.mdEste proyecto
$CONFIG/ai/skills/NAME/SKILL.mdUsted
---
description: Release checklist for this service
when_to_use: When the user asks to cut, tag, or publish a release
---
1. Confirm the changelog has an entry for the new version.
2. ...

/skills enumera las habilidades, incluidas las de su cuentaCHAMPREP AI. Ejecute una directamente con /<skill-name>.

Un agente personalizado es un subagente con sus propias instrucciones, herramientas y modelo.

UbicaciónÁmbito de aplicación
.champrep/agents/NAME.mdEste proyecto
$CONFIG/ai/agents/NAME.mdUsted
---
name: test-writer
description: Writes and fixes unit tests. Use after a code change.
tools: [local_read_file, local_grep, local_glob, local_edit_file, local_bash]
permission_mode: accept-edits
isolation: worktree
---
You write focused unit tests that follow this project's existing style.
  • description indica al agente principal cuándo debe delegarle una tarea.
  • tools restringe las herramientas; omítalo para heredar las herramientas de la sesión.
  • permission_mode solo puede hacer que el agente sea más estricto que su sesión.
  • isolation: worktree Lo ejecuta en su propio árbol de trabajo de Git.

Gestione los agentes con /agents create|edit|delete NAME. Inicie una sesión como agente con champrep ai --agent NAME, o envíele una solicitud con @NAME prompt. Véase Subagentes.

Los hooks son comandos de shell que el CLIejecuta en determinados momentos de una sesión, por ejemplo, para dar formato a los archivos tras una edición o para bloquear determinados comandos.

EventoSe ejecuta
SessionStartAl iniciarse una sesión.
UserPromptSubmitAntes de que se envíe una solicitud. Puede bloquearla o añadir contexto.
PreToolUseAntes de que se ejecute una herramienta local. Puede bloquearla.
PostToolUseDespués de que se ejecute una herramienta local. Puede añadir comentarios al resultado.
PermissionRequestCuando se muestra una solicitud de permiso.
NotificationCuándo le avisa el agente.
SubagentStopCuando un subagente finaliza.
PreCompactAntes de que se comprima la conversación.
StopCuando finaliza un turno.
SessionEndCuando finaliza la sesión.

Configure los hooks en cualquier archivo de configuración:

{
"hooks": {
"PostToolUse": [
{ "matcher": "local_edit_file|local_write_file", "command": "npm run format --silent", "timeout": 30 }
],
"PreToolUse": [
{ "matcher": "local_bash", "command": "./scripts/check-command.sh" }
]
}
}
  • matcher es una expresión regular sobre el nombre de la herramienta; omítala para que coincida con todas las herramientas.
  • El gancho recibe una descripción JSON del evento en la entrada estándar.
  • Código de salida 2, o salida en JSON con "decision": "block" y un reason, bloquea la acción cuando el evento lo permite. additionalContext en JSON la salida añade texto para el modelo.
  • El tiempo de espera predeterminado es de 60 segundos y el máximo es de 10 minutos.
  • Los hooks se ejecutan con su entorno, sin las credencialesCHAMPREP.

Gestione los hooks con /hooks, /hooks add EVENT [--matcher M] [--timeout S] [--scope user|project] -- COMMAND, /hooks disable ID, y /hooks enable ID.

ComandoOpciones
/colorUn color de resaltado para las sesiones de este proyecto, a fin de distinguir las sesiones paralelas: blue, cyan, green, yellow, orange, red, pink, magenta, purple, gray, o reset.
/themeauto, dark, light, high-contrast, o colorblind. NO_COLOR y --no-color desactivar el color.
/statuslineSeleccione segmentos de profile, model, context, branch, mode, cost, y tasks; utilice /statusline command CMD para mostrar la primera línea de la salida de su propio comando; /statusline reset restablece los valores predeterminados.
/output-styledefault, concise, explanatory, o learning.
/vimEdición al estilo Vim en el indicador de comandos.
/keybindingsVer atajos; /keybindings edit abre $CONFIG/ai/keybindings.json.
/configTodo lo anterior en una sola pantalla.

Las conversaciones del agente se almacenan en su CHAMPREP AIcuenta. Solo el estado específico de la máquina se almacena localmente. Muestre todas las ubicaciones de su máquina con:

Ventana de terminal
champrep ai paths
QuéDónde
CLI perfiles y entornos$CONFIG/config.toml
Su configuración del agente: reglas, modo, tema, línea de estado, ganchos$CONFIG/ai/settings.json
Anulaciones de atajos de teclado$CONFIG/ai/keybindings.json
Sus instrucciones personales$CONFIG/ai/CHAMPREP.md
Sus agentes, comandos y habilidades$CONFIG/ai/agents/, commands/, skills/
Sus servidores MCP locales$CONFIG/ai/mcp.json
Proyectos de confianza$CONFIG/ai/trusted-projects.json
Conversaciones recientes por directorio y listas de tareas$STATE/ai/sessions.json
Historial de comandos (censurado y con longitud limitada)$STATE/ai/history.jsonl
Registros de depuración (censurados, se conservan durante 7 días)$STATE/ai/logs/
Puntos de control de archivos$CACHE/ai/checkpoints/
Configuración del proyecto (sujeta a confirmación).champrep/settings.json, mcp.json, agents/, commands/, skills/
Sus anulaciones de proyecto (ignoradas por Git).champrep/settings.local.json
Instrucciones del proyectoCHAMPREP.md
Árboles de trabajo.champrep/worktrees/

Las credenciales nunca se almacenan en estos archivos. Permanecen en el llavero del sistema operativo.

RootmacOS y LinuxWindows
$CONFIG$XDG_CONFIG_HOME/champrep, en caso contrario ~/.config/champrep%APPDATA%\champrep
$STATE$XDG_STATE_HOME/champrep, en caso contrario ~/.local/state/champrep%LOCALAPPDATA%\champrep\state
$CACHE$XDG_CACHE_HOME/champrep, en caso contrario ~/.cache/champrep%LOCALAPPDATA%\champrep\cache

Establecer CHAMPREP_CONFIG_DIR para mantener los tres en un mismo directorio, en config/, state/, y cache/ subcarpetas. Esto resulta útil para instalaciones portátiles y ejecuciones de CI aisladas.