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.
Instrucciones del proyecto: CHAMPREP.md
Sección titulada «Instrucciones del proyecto: CHAMPREP.md»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.mden 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ón | Cómo |
|---|---|
| Crear uno | /init analiza el repositorio y escribe CHAMPREP.md, conservando el contenido útil de una ya existente AGENTS.md. |
| Añadir una nota | Inicie 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.
Comandos personalizados
Sección titulada «Comandos personalizados»Un comando personalizado es una plantilla de solicitud en Markdown que se ejecuta como /<name>.
| Ubicación | Ámbito de aplicación |
|---|---|
.champrep/commands/NAME.md | Este proyecto |
$CONFIG/ai/commands/NAME.md | Usted |
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 fixargument-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.mdRecent changes:!`git log --oneline -5`$ARGUMENTSes 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.@pathincluye 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-toolslimita las herramientas para ese turno, ymodelanula el modelo.
Habilidades
Sección titulada «Habilidades»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.md | Este proyecto |
$CONFIG/ai/skills/NAME/SKILL.md | Usted |
---description: Release checklist for this servicewhen_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>.
Agentes personalizados
Sección titulada «Agentes personalizados»Un agente personalizado es un subagente con sus propias instrucciones, herramientas y modelo.
| Ubicación | Ámbito de aplicación |
|---|---|
.champrep/agents/NAME.md | Este proyecto |
$CONFIG/ai/agents/NAME.md | Usted |
---name: test-writerdescription: 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-editsisolation: worktree---You write focused unit tests that follow this project's existing style.descriptionindica al agente principal cuándo debe delegarle una tarea.toolsrestringe las herramientas; omítalo para heredar las herramientas de la sesión.permission_modesolo puede hacer que el agente sea más estricto que su sesión.isolation: worktreeLo 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.
| Evento | Se ejecuta |
|---|---|
SessionStart | Al iniciarse una sesión. |
UserPromptSubmit | Antes de que se envíe una solicitud. Puede bloquearla o añadir contexto. |
PreToolUse | Antes de que se ejecute una herramienta local. Puede bloquearla. |
PostToolUse | Después de que se ejecute una herramienta local. Puede añadir comentarios al resultado. |
PermissionRequest | Cuando se muestra una solicitud de permiso. |
Notification | Cuándo le avisa el agente. |
SubagentStop | Cuando un subagente finaliza. |
PreCompact | Antes de que se comprima la conversación. |
Stop | Cuando finaliza un turno. |
SessionEnd | Cuando 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" } ] }}matcheres 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 unreason, bloquea la acción cuando el evento lo permite.additionalContexten 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.
Aspecto y funcionamiento
Sección titulada «Aspecto y funcionamiento»| Comando | Opciones |
|---|---|
/color | Un 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. |
/theme | auto, dark, light, high-contrast, o colorblind. NO_COLOR y --no-color desactivar el color. |
/statusline | Seleccione 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-style | default, concise, explanatory, o learning. |
/vim | Edición al estilo Vim en el indicador de comandos. |
/keybindings | Ver atajos; /keybindings edit abre $CONFIG/ai/keybindings.json. |
/config | Todo lo anterior en una sola pantalla. |
Archivos locales
Sección titulada «Archivos locales»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:
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 proyecto | CHAMPREP.md |
| Árboles de trabajo | .champrep/worktrees/ |
Las credenciales nunca se almacenan en estos archivos. Permanecen en el llavero del sistema operativo.
| Root | macOS y Linux | Windows |
|---|---|---|
$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.