Comandos help y apropos en Linux: encuentra el comando correcto antes de crear un alias
03
Buscar y luego crear alias
Encuentra el comando correcto y luego créale un alias
Antes de asignarle un nombre corto a un comando, necesitas saber qué hace realmente. SeedSpindle ejecuta la búsqueda en tu shell de Linux a través de WSL o SSH, muestra el texto del manual en una tarjeta de chat y luego propone el alias como un diff. Tú revisas ambos. La búsqueda viene primero, así que el alias se basa en lo que dice el manual y no en la memoria. Cada paso de abajo es una tarjeta en el chat, y la carpeta de trabajo contiene el archivo de alias, su copia de seguridad y cualquier nota que le pidas al agente que escriba. Nada se ejecuta fuera del entorno que elegiste. Cuando terminas, el archivo de alias, la copia de seguridad y las tarjetas de la sesión te dan un registro completo de lo que cambió, que puedes consultar de nuevo cuando el shell se comporte de forma extraña. Los principiantes suelen omitir la búsqueda y pegar una línea de un foro, así que este flujo de trabajo convierte la búsqueda en la primera tarjeta de cada tarea.
01
Abre la carpeta
Elige la carpeta de trabajo y el entorno de WSL o SSH para tu shell, para que las herramientas de archivos y Shell apunten a la misma máquina. Elige la carpeta que contiene tus dotfiles o una copia de ellos. Las herramientas de archivos solo funcionan en esa carpeta, mientras que Shell se ejecuta en el entorno que elegiste. Ábrela una vez y la elección se mantiene para la siguiente tarea.
02
Pide la búsqueda
Indica el comando que quieres entender antes de asignarle un nombre corto y pide al agente que ejecute el comando de ayuda o manual correspondiente. Cita el nombre exacto. Para un comando incorporado, pide el texto de ayuda y para un programa ordinario, pide su página de manual. Indica a qué shell pertenece el comando si usas más de uno.
03
Revisa el diff
Lee la línea de alias propuesta y acéptala solo si se ajusta a tus hábitos y no oculta lo que realmente hace el comando. Rechaza cualquier cosa que parezca un atajo para algo destructivo. El diff marca las líneas agregadas en verde y las líneas eliminadas en rojo, así que una sola mirada muestra la magnitud del cambio.
04
Verifica el resultado
Shell carga el archivo y muestra el código de salida real en una tarjeta, y el siguiente comando alias muestra si el nuevo nombre es reconocido. Si el nombre es desconocido, la tarjeta muestra el error y pides una corrección. Ejecuta cada nombre nuevo una vez en una terminal nueva.
Archivo de alias de ejemplo con atajos de solo lectura
SeedSpindle · Buscar y crear alias● Ask first
Explica el comando df, luego añade un alias corto para él.
Shellman dfexit 0
read_file~/.bash_aliasesloaded
edit_file~/.bash_aliases+1 line
Shellsource ~/.bash_aliasesexit 0
Shellalias dfhexit 0
esperando tu aprobación antes del siguiente pasoRechazarAceptar
.bash_aliases
# Read-only shortcuts for looking around
alias ll='ls -la'
alias la='ls -A'
alias l='ls -CF'
# Disk usage in readable units
alias dfh='df -h'
alias duh='du -sh'
# Show the last commands you typed
alias hist='history 20'
Cada alias aquí solo lee: ls lista archivos, df y du informan del espacio en disco, e history imprime comandos recientes. Las líneas de comentario comienzan con # y explican cada grupo, así que recordarás más tarde por qué existen las líneas. Deja una línea en blanco entre grupos y mantén cada línea lo suficientemente corta para leerla en un diff sin desplazarte horizontalmente. Añade tu propio grupo debajo del último y deja que el agente muestre el diff antes de guardarlo. Los nombres cortos son más fáciles de escribir, pero manténlos diferentes de los comandos reales para que nada se oculte por accidente. Revisa cada línea nueva antes de guardarla.
Cuatro búsquedas antes de escribir un alias
Lee la ayuda de un comando incorporado
Tarea: aprende qué hace un comando incorporado de bash antes de crearle un alias. Un comando de Linux como help cd imprime la documentación de un comando incorporado, y el agente lo ejecuta a través de Shell para que el texto aparezca en una tarjeta de chat que puedes expandir. Lees las opciones, decides cuáles pertenecen al alias y luego pides la línea. Sé preciso. edit_file propone el alias como un diff, y el alias nunca debe ocultar lo que realmente hace el comando. Una suposición incorrecta cuesta poco, porque la copia de seguridad está a una llamada de copy_file. Ask first pausa antes de la escritura, así que aceptas el diff, ejecutas source en el archivo y confirmas el código de salida en la siguiente tarjeta.
Busca páginas de manual por palabra
Tarea: encuentra un comando cuando solo recuerdas lo que hace. Ejecutar apropos con una palabra clave busca las descripciones cortas de las páginas de manual, y el agente muestra la lista en una tarjeta. Escribir apropos linux devolvería una lista muy larga, mientras que una palabra más específica como disk encuentra menos coincidencias, pero mejores. Un historial de shell que conoce el proyecto de cada comando necesita una configuración adicional más allá de los alias, y el agente puede redactar esas líneas de bashrc como un diff si lo pides. Elige uno. Lee la página de manual con man, luego pide el alias y revisa el diff antes de aceptarlo.
Edita dotfiles con un diff
Tarea: cambia un dotfile sin romper tu próximo inicio de sesión. Depurar un problema de ruta con dotfiles comienza leyendo el archivo que establece PATH, y el agente lo hace con read_file y grep, que muestra cada línea coincidente. Luego usa copy_file para guardar el original y edit_file para proponer la corrección como un diff. Guarda la copia. Muchos problemas de ruta provienen de un error tipográfico, así que el diff a menudo solo necesita una línea cambiada, y una restauración es una sola llamada a copy_file si la nueva configuración falla. Plan only te permite leer todo el plan antes de que cambie un archivo, y la verificación final es un shell nuevo donde confirmas que el comando se encuentra.
Verifica el cambio con Shell
Tarea: confirma que el alias se carga. Después de aceptar el diff, el agente ejecuta source en el archivo a través de Shell e informa el código de salida real en la tarjeta, donde un código cero significa que el archivo se cargó sin errores. Las actualizaciones en vivo en un indicador de shell también dependen de este paso, porque el shell actual solo ve un archivo cambiado después de que se carga de nuevo. Ejecuta el alias. El agente escribe el nuevo nombre, muestra la salida y tú la comparas con el comando que esperabas. Si el código de salida no es cero, lees el error en la tarjeta expandida y pides una corrección, luego abres una segunda terminal y pruebas el alias allí también.