Tutoriales

Estandarizar el comportamiento de Bob

Estandarice el comportamiento de Bob en su equipo utilizando archivos de reglas a nivel de proyecto que le indican a Bob que documente su código y recuerde sus acciones anteriores.

Las reglas de Bob son archivos de texto sin formato que definen instrucciones que se aplican a cada conversación de Bob. Bob almacena las reglas como archivos en una carpeta designada dentro del proyecto o a nivel de usuario global, e inyecta automáticamente el contenido de cada archivo de reglas en cada conversación en todos los modos. La inyección de reglas permite a los equipos y desarrolladores individuales aplicar estándares de codificación, preferencias de comunicación y restricciones de flujo de trabajo sin repetir instrucciones en cada solicitud.

Las reglas a nivel de proyecto en galaxium-travels/.bob están controladas por versiones junto con su código, lo que significa:

  • Las reglas se propagan automáticamente a todos los miembros del equipo que clonan el repositorio.
  • Los cambios en las reglas pasan por el proceso normal de revisión de código.
  • El historial de reglas se rastrea en git.

En este tutorial, le indica a Bob que hable de manera concisa, documente su código y recuerde sus acciones anteriores agregando archivos de reglas en el directorio .bob. Debido a que incluirá estos archivos en el control de versiones, Bob los aplicará en todo su equipo.

Requisitos previos

Para completar este tutorial, necesita lo siguiente:

  • Si aún no lo tiene, clone el código de demostración de Galaxium Travels. El comando de clonación también verifica la rama bob-learning-path-branch que contiene el código que utiliza en los tutoriales.
git clone -b bob-learning-path-branch https://github.com/IBM/galaxium-travels
  • Bob IDE con el código de demostración de Galaxium Travels abierto
  • Complete el tutorial Iniciar un proyecto para crear la carpeta .bob.
  • Aunque no es obligatorio, considere hacer el Tutorial de inicio rápido para familiarizarse con la interfaz y las características de Bob.
  • Python o Python 3. Puede descargar Python desde el sitio web oficial.

Crear un archivo de reglas personalizado de Bob

El comando /init de Bob crea una carpeta .bob con archivos AGENTS.md para cada modo de Bob que dirige el comportamiento de Bob en cada modo. Cree sus propias reglas personalizadas agregando un nuevo archivo a la carpeta rules. Bob leerá el contenido del archivo de reglas, lo que significa que las instrucciones que agregue se aplicarán a todas las interacciones con Bob.

Crear la carpeta de reglas

Si aún no existe una carpeta rules en .bob, cree una.

Crear el archivo de reglas

Cree un archivo en galaxium-travels/.bob/rules/ llamado basic_rules.md.

El archivo .bob/rules/basic_rules.md creado en el proyecto

Crear reglas personalizadas de Bob

En el archivo basic_rules.md, cree reglas personalizadas agregando el siguiente texto:

Agregar una regla de estándar de documentación

Always include concise JSDoc strings for every public function.

La regla de estándar de documentación garantiza que Bob genere documentación consistente cada vez que Bob escribe o modifica funciones públicas, independientemente de la tarea.

Agregar una regla de estilo de comunicación

Be very concise in your wording.

La regla de estilo de comunicación controla cómo Bob formula respuestas y comentarios, lo cual es útil para equipos que prefieren resultados concisos y directos sobre explicaciones detalladas.

Agregar una regla de monólogo interno

Write a summary of every interaction into the folder `internal-monologue/`.
Name the file starting with a timestamp, followed by a concise description of the interaction.
Example: 2026-01-15_update-readme.md

El monólogo interno produce un registro persistente de todo lo que Bob ha hecho en todas las conversaciones.

Los beneficios del monólogo interno incluyen lo siguiente:

  • Pista de auditoría: Un registro de qué cambios hizo Bob y cuándo.
  • Continuidad entre sesiones: Bob puede hacer referencia a la carpeta de monólogo interno en conversaciones futuras para comprender el trabajo anterior.
  • Transparencia del equipo: En repositorios compartidos, el monólogo muestra lo que diferentes miembros del equipo han hecho con Bob.

Una vez que agregue todas las reglas, su archivo basic_rules.md se verá así:

El archivo basic_rules.md con las tres reglas personalizadas agregadas

Probar las reglas

Abra la barra lateral de chat agéntico, cambie al modo Código y ejecute la siguiente solicitud para que Bob edite el README.md. Bob puede hacer sugerencias como mejorar con mejor solución de problemas, revisión completa o corregir inexactitudes. Puede elegir la sugerencia que mejor se ajuste a su visión para el README.

Update the readme

Bob actualiza el README.md y crea una carpeta llamada internal-monologue y crea un archivo que le muestra las actualizaciones que realizó en el README.

Bob actualiza el README.md y crea un archivo de monólogo interno

Próximos pasos

En este tutorial, aprendió cómo las reglas de Bob le permiten definir instrucciones persistentes que se aplican en cada conversación y modo. Las reglas a nivel de proyecto están controladas por versiones junto con su código, por lo que su equipo comparte automáticamente los mismos estándares. El patrón de monólogo interno le proporciona una pista de auditoría de las acciones de Bob en todas las sesiones.

Avance a Agregar capacidades de Bob para aprender sobre la creación de modos personalizados que definen personas especializadas con instrucciones personalizadas y acceso específico a herramientas.

¿Cómo es este tema?