Guía Trae IDE: Configuración sencilla de reglas AI personalizadas (Reglas Trae)

Con el creciente uso de la IA en la programación, muchos desarrolladores, tras experimentar la comodidad de la programación asistida por IA, esperan contar con un "ingeniero dedicado a la IA" que comprenda mejor sus necesidades. En el centro de esta demanda está la capacidad de la IA para seguir con precisión las instrucciones personalizadas del desarrollador y las especificaciones concretas del proyecto. Para satisfacer esta necesidad, la Trae IDE Se ha introducido la función de configuración de reglas de IA (Trae Rules), que permite a los usuarios personalizar comportamientos para que la IA automatice la ejecución de tareas personalizadas.

I. ¿Qué son las normas?

Trae Las reglas son una potente función que permite a los equipos de desarrollo o a los desarrolladores individuales personalizar y obligar a la IA a seguir estilos de código específicos y buenas prácticas cuando se genera, interpreta o modifica el código.

Imagínese un escenario común en el que un desarrollador que utiliza una IA para asistencia en programación puede necesitar repetir las mismas instrucciones a la IA, como el estilo de lenguaje del código, las restricciones del marco que debe seguir el proyecto, el nivel de detalle y el formato de los comentarios, o las normas de cumplimiento de seguridad que deben respetarse, etc. La función Trae Rules preestablece estos comportamientos para que la IA los "lea" y siga automáticamente cada vez que responda. Trae Rules preestablece estas normas de comportamiento para que la IA pueda "leer" y seguir automáticamente estas reglas preestablecidas cada vez que responda. De este modo, los desarrolladores no tendrán que recordárselo una y otra vez, y la IA podrá producir de forma constante contenidos que cumplan las expectativas. Y lo que es más importante, al abordar distintas tareas de desarrollo o cambiar de proyecto, las reglas Trae correspondientes pueden ayudar a la IA a adaptarse con precisión a los requisitos técnicos del trabajo en curso, lo que mejora notablemente la eficacia del desarrollo. Estos archivos de reglas suelen presentarse en un formato de texto o Markdown fácil de leer y editar (p. ej. user_rules.md responder cantando project_rules.md) existe para facilitar el control de versiones y el intercambio de equipos entre desarrolladores.

II. Instrucciones de uso

Tras actualizar Trae IDE a la versión 0.5.1 y superiores, los usuarios pueden configurar dos tipos de reglas:

01 Normas personales

Las reglas personales son reglas personalizadas para la IA basadas en los hábitos y preferencias personales del desarrollador, con el objetivo de que el resultado de la IA se ajuste más a las necesidades individuales del usuario. Una vez establecida una regla personal, se aplicará a todos los proyectos del usuario. Por ejemplo:

• idioma: Especifique si la IA responderá de forma concisa, rigurosa o humorística.
• Preferencias del sistema operativoSe pide a la IA que proporcione soluciones o ejemplos de código para un sistema operativo específico, como Windows o macOS.
• Profundidad del contenido: Establece si la IA debe proporcionar explicaciones detalladas, ejemplos de código o sólo las conclusiones principales.
• método de interacciónPor ejemplo, los usuarios pueden preferir respuestas directas a preguntas retóricas capciosas.

02 Normas del proyecto

Una regla de proyecto es un conjunto de reglas que la IA debe seguir para el proyecto en cuestión. Estas reglas sólo tienen efecto en el proyecto en el que están configuradas. Ejemplo:

• estilo de codificaciónEspecificar la sangría del código (por ejemplo, si se deben utilizar espacios o tabuladores y cuántos), convenciones de nomenclatura (por ejemplo, nomenclatura en cruz de camello)... camelCase o la nomenclatura con guión bajo snake_case), etc.
• Limitaciones lingüísticas y de marco: Especifique el lenguaje de programación preferido que se utilizará en el proyecto (por ejemplo, Python o JavaScript) o el marco obligatorio (por ejemplo. Reaccione (o Django).
• Limitaciones de uso de la APISe prohíbe explícitamente a la IA utilizar determinadas API obsoletas o no recomendadas en el código generado.

Normalmente, si hay un conflicto de contenido entre las normas personales y las del proyecto, las normas del proyecto tienen prioridad y anulan las disposiciones correspondientes de las normas personales para garantizar que se cumplen las especificaciones del proyecto.

En las siguientes secciones se muestra cómo configurar cada una de estas dos reglas de IA:

Crear normas personales

1. En la esquina superior derecha de la ventana de diálogo AI en Trae IDE, haga clic en el icono "Configuración" y seleccione la opción "Reglas".
    
   Tras la operación, la interfaz mostrará la ventana de configuración "Reglas".
2. En el área de Reglas personales, haga clic en + 创建 user_rules.md Botón.
   El sistema crea automáticamente user_rules.md y abra el archivo en el editor.
   
3. abra user_rules.md introduzca las reglas que desea que siga la IA en lenguaje natural. Por ejemplo, puedes especificar: "Por favor, utiliza chino para todos los comentarios de código y explica la función principal y los significados de los parámetros de cada función."
4. Guarde el archivo. Estas reglas surtirán efecto en todos los comportamientos de la IA del proyecto.
   

Creación de reglas de proyecto

1. En primer lugar, abra un proyecto en el IDE de Trae.
2. En la esquina superior derecha del cuadro de diálogo AI, haga clic en el icono Configuración y seleccione Reglas.
   Tras la operación, la interfaz mostrará la ventana de configuración "Reglas".
3. En el área Reglas del proyecto, haga clic en el botón + 创建 project_rules.md Botón.
   
   El sistema crea automáticamente el directorio raíz del proyecto actual en el directorio .trae/rules (si no existe ya) y genere la carpeta project_rules.md Documentación.
   
4. abra project_rules.md Introduzca en el archivo las normas que debe seguir la IA para este proyecto.
5. Guarde el archivo. Estas reglas sólo se aplicarán al comportamiento de la IA del proyecto actual.
   

Normas administrativas

En la ventana de configuración "Reglas", los usuarios pueden modificar fácilmente las reglas personales y de proyecto existentes, así como eliminar directamente los archivos de reglas que ya no necesiten.

• Modificar reglas: Tras editar y guardar el contenido del archivo de reglas, la IA seguirá las reglas actualizadas.
• Eliminación de archivos de reglas: Eliminar user_rules.md tal vez project_rules.md todas las reglas previamente definidas en él quedarán invalidadas.

III. Demostración práctica

A continuación, le mostraremos un ejemplo concreto y real de cómo utilizar Trae Rules para mejorar la eficacia de su desarrollo.

Supongamos que un equipo de desarrollo está trabajando en un proyecto web y decide utilizar el framework Chakra UI para optimizar sus estilos CSS. Para asegurarse de que la IA sigue esta decisión en el trabajo posterior, puede añadir las reglas del proyecto (project_rules.md), añada la siguiente directiva:

请使用 Chakra UI 框架对本项目中的所有前端页面进行 CSS 相关的优化和重构。确保生成的组件符合 Chakra UI 的设计规范和最佳实践。

Cuando se configura esta regla de proyecto, la IA (que puede llamarse Builder o un nombre similar en el IDE de Trae) hace referencia a ella automáticamente cuando un desarrollador solicita a la IA que realice tareas de desarrollo relacionadas con CSS.

Por ejemplo, si se configura otra regla personal, como "Las explicaciones del código deben ser minuciosas y explicar los pasos clave", la IA no sólo utilizará el marco al realizar la tarea de modificación de la IU de Chakra descrita anteriormente, sino que también proporcionará información más detallada al explicar su funcionamiento.

IV. Escenarios de aplicación

Trae Rules se puede utilizar en una amplia gama de escenarios para ayudar a los equipos de desarrollo y a los desarrolladores individuales a mantener la coherencia del código, mejorar su mantenimiento y reducir la aparición de errores de bajo nivel en una variedad de situaciones. A continuación se enumeran algunos de los principales escenarios:

Escenario 1: Trabajo en equipo y revisión del código

• efecto: Unifique los estilos de código, reduzca las disputas de revisión y mejore la eficacia de la colaboración.
• instruccionesLos nuevos miembros del equipo a menudo necesitan tiempo para adaptarse al estilo de código establecido por el equipo. Al establecer reglas de proyecto que especifiquen cosas como convenciones de nomenclatura de variables, orden de importación de módulos y patrones de arquitectura de código defendidos por el equipo, la IA seguirá estas reglas cuando ayude con la programación, garantizando que los nuevos miembros del equipo envíen código coherente con el estilo del equipo. Además, Trae Rules puede ayudar a los miembros del equipo a dar formato al código, corregir automáticamente los fragmentos de código no conformes y hacer cumplir las especificaciones de los comentarios (por ejemplo, exigir que todas las funciones públicas tengan comentarios al estilo JSDoc), reduciendo así el coste de comunicar los problemas de estilo durante la fase de revisión del código.

Escenario 2: Mantenimiento del proyecto y calidad del código

• efectoAyudar a detectar posibles errores de código, mejorar progresivamente el código antiguo y mejorar el mantenimiento general del proyecto.
• instruccionesPara algunos proyectos heredados con una larga historia y un estilo de código más caótico, el código antiguo puede corregirse por fases introduciendo y perfeccionando gradualmente las reglas de Trae y combinándolas con comandos de diálogo de la IA, que puede identificar el código que no se ajusta a la nueva especificación basándose en las reglas y ofrecer sugerencias de refactorización. Al mismo tiempo, para evitar la introducción de nuevos errores de bajo nivel durante el desarrollo, pueden establecerse reglas, como la obligación de realizar operaciones asíncronas await debe try-catch Envoltura estructural, detección de import declaraciones o variables, lo que prohíbe el uso de == e imponer el uso de === Hacer comparaciones. Estas reglas ayudan a reducir los posibles problemas en tiempo de ejecución y mejoran la robustez y la mantenibilidad a largo plazo del código.

Escenario 3: Optimización específica de la pila tecnológica

• efectoMejorar la aplicación de las mejores prácticas para pilas tecnológicas específicas (por ejemplo, React, Vue, Node.js).
• instruccionesReglas de Trae: En los proyectos front-end, las incoherencias en la forma de escribir los componentes pueden dificultar su comprensión y mantenimiento. Puedes imponer una forma consistente de escribir componentes estableciendo Reglas Trae, por ejemplo promoviendo el uso de componentes funcionales en proyectos React (prohibiendo el uso de class mal uso de los componentes), exigiendo que todos los componentes del props deben ser de tipo comprobado (ya sea utilizando TypeScript o PropTypes), y el obligatorio useEffect Las dependencias de los ganchos deben declararse en su totalidad. Para los proyectos back-end Node.js con estilos de interfaz de API incoherentes, se pueden pasar reglas para imponer el cumplimiento de la especificación de formato de ruta para API RESTful, exigir que el proceso de gestión de errores debe ser estandarizado y prohibir el uso de la directiva console.logEl cambio al uso obligatorio de un repositorio de registro unificado.

Escenario 4: Seguridad y conformidad

• efectoAyuda a prevenir las infracciones de seguridad más comunes y a cumplir los requisitos de conformidad específicos del sector.
• instruccionesLa seguridad del código es la piedra angular del éxito de un proyecto. Para los riesgos de seguridad habituales, como la inyección SQL, los ataques de secuencias de comandos en sitios cruzados (XSS), etc., Trae Rules puede establecer reglas que ayuden a evitarlos. Por ejemplo, prohibir empalmar cadenas de consulta SQL directamente en el código (forzando el uso de consultas parametrizadas u ORM), detectar la salida directa a HTML sin escapar suficientemente la entrada del usuario (para evitar ataques XSS), y prohibir el uso de eval() tal vez new Function() Trae Rules puede ayudar a detectar la inclusión de información sensible en texto plano (por ejemplo, contraseñas y claves) en el código. Para los sectores con estrictos requisitos de protección de datos y auditoría de cumplimiento, como el financiero y el sanitario, Trae Rules puede ayudar a detectar si la información sensible (por ejemplo, contraseñas, claves) está contenida en texto plano en el código, forzando el almacenamiento cifrado de datos sensibles como contraseñas, y garantizando que el registro no contiene Información de Identificación Personal (PII), ayudando así a los proyectos a satisfacer las necesidades de los controles de cumplimiento.

Escenario 5: Optimizar los hábitos de desarrollo personal

• efectoAyudar a los desarrolladores a mantener la coherencia en su estilo personal de codificación y a aprender y aplicar las características de los nuevos lenguajes de programación de forma más eficaz.
• instruccionesEl estilo de código: Incluso en proyectos personales, mantener un estilo de código coherente puede ayudar a mejorar la eficacia del desarrollo y la legibilidad del código. Los desarrolladores pueden hacerlo estableciendo reglas personales. Además, cuando se aprende un nuevo lenguaje de programación (por ejemplo, Rust, Go, Python), es fácil para los principiantes escribir código que no se ajuste a los paradigmas habituales del lenguaje o a las mejores prácticas. Mediante el establecimiento de Reglas Trae, por ejemplo en el desarrollo de Rust, que imponen el uso de la función Result Los tipos se gestionan correctamente (las llamadas directas están prohibidas) unwrap() (ignorando los errores), forzando la comprobación y el manejo de los retornos de función en el desarrollo de Go, la función err (que prohíbe ignorar los errores), o forzar el uso de anotaciones de tipo en el desarrollo de Python y garantizar que son coherentes con la norma mypy Las herramientas de comprobación tipográfica, como la compatibilidad, pueden ayudar eficazmente a los desarrolladores a desarrollar buenos hábitos de codificación y captar más rápidamente la esencia del nuevo lenguaje.

Al establecer y aplicar cuidadosamente las Reglas de Trae, la IA puede adaptarse con mayor precisión a las necesidades específicas y a los hábitos de trabajo de los desarrolladores, e integrarse con mayor fluidez en los flujos de trabajo de desarrollo diarios, permitiendo una colaboración humano-ordenador realmente eficiente. Los desarrolladores interesados deben descargar la última versión de Trae IDE desde el canal oficial de Trae IDE para experimentar esta función por sí mismos.