Trae IDE 가이드: 사용자 지정 AI 규칙의 간편한 구성(Trae 규칙)

프로그래밍에서 AI의 적용이 점점 더 심도 있게 이루어지면서 많은 개발자가 AI 지원 프로그래밍의 편리함을 경험한 후 자신의 요구를 더 잘 이해하는 '전담 AI 엔지니어'를 기대하게 되었습니다. 이러한 요구의 핵심은 AI가 개발자의 개인화된 지침과 특정 프로젝트 사양을 정확하게 따라갈 수 있는 능력입니다. 이러한 요구를 충족하기 위해 Trae IDE 사용자가 AI의 행동을 사용자 지정하여 개인화된 작업을 자동으로 실행할 수 있도록 지원하는 AI 규칙(트래 규칙) 구성 기능을 도입했습니다.

I. 규칙이란?

Trae 규칙은 개발팀 또는 개별 개발자가 코드를 생성, 해석 또는 수정할 때 특정 코드 스타일과 모범 사례를 따르도록 AI를 사용자 지정하고 강제할 수 있는 강력한 기능입니다.

프로그래밍 지원을 위해 AI를 사용하는 개발자가 코드의 언어 스타일, 프로젝트가 따라야 하는 프레임워크 제약 조건, 주석의 세부 수준 및 형식, 준수해야 하는 보안 규정 등 동일한 지침을 AI에게 반복해야 하는 일반적인 시나리오를 상상해 보세요. Trae 규칙 기능은 AI가 응답할 때마다 자동으로 "읽고" 따를 수 있도록 이러한 동작을 미리 설정해 놓습니다. Trae 규칙은 AI에 이러한 행동 규범을 미리 설정하여 AI가 응답할 때마다 미리 설정된 규칙을 자동으로 "읽고" 따를 수 있도록 합니다. 이렇게 하면 개발자는 반복적으로 상기시킬 필요가 없으며, AI는 기대에 부합하는 콘텐츠를 안정적으로 출력할 수 있습니다. 더 중요한 것은 다른 개발 작업을 처리하거나 프로젝트를 전환할 때 해당 Trae 규칙을 사용하면 AI가 현재 작업의 기술적 요구 사항에 정확하게 적응하여 개발 효율성을 크게 향상시킬 수 있다는 점입니다. 이러한 규칙 파일은 일반적으로 읽기 쉽고 편집하기 쉬운 텍스트 또는 마크다운 형식으로 제공됩니다(예 user_rules.md 노래로 응답 project_rules.md)는 개발자의 버전 관리 및 팀 공유를 용이하게 하기 위해 존재합니다.

II. 사용 지침

Trae IDE를 버전 0.5.1 이상으로 업데이트한 후 사용자는 두 가지 유형의 규칙을 구성할 수 있습니다:

01 개인 규칙

개인 규칙은 개발자의 개인적인 습관과 선호도에 따라 AI에 맞춤 설정된 규칙으로, AI의 결과물을 사용자의 개별 요구 사항에 더 잘 맞출 수 있도록 하는 것을 목표로 합니다. 개인 규칙을 설정하면 사용자의 모든 프로젝트에 적용됩니다. 예를 들어

• 언어AI가 간결하게, 엄격하게 또는 유머러스하게 답변할지 여부를 지정합니다.
• 운영 체제 기본 설정AI는 Windows 또는 macOS와 같은 특정 운영 체제에 대한 솔루션 또는 코드 샘플을 제공하도록 요청받습니다.
• 콘텐츠의 깊이AI가 자세한 설명, 코드 예제 또는 핵심 결론만 제공해야 하는지 여부를 설정합니다.
• 상호 작용 방법예를 들어, 사용자는 주요 수사학적 질문에 대한 직접적인 답변을 선호할 수 있습니다.

02 프로젝트 규칙

프로젝트 규칙은 현재 진행 중인 특정 프로젝트에 대해 AI가 따라야 하는 규칙의 모음입니다. 이러한 규칙은 해당 규칙이 구성된 프로젝트에서만 적용됩니다. 예시:

• 코딩 스타일코드 들여쓰기(예: 공백 또는 탭 사용 여부 및 개수), 명명 규칙(예: 낙타 교차 명명법)을 지정합니다. camelCase 또는 밑줄 명명법 snake_case) 등
• 언어 및 프레임워크 제약 조건프로젝트에서 사용할 기본 프로그래밍 언어(예: Python 또는 JavaScript) 또는 필수 프레임워크(예: React (또는 장고).
• API 사용 제한AI는 생성된 코드에서 오래되었거나 권장되지 않는 특정 API를 사용하는 것을 명시적으로 금지합니다.

일반적으로 개인 운영원칙과 프로젝트 운영원칙 사이에 내용이 충돌하는 경우 프로젝트 운영원칙이 우선하며 프로젝트 사양을 준수하기 위해 개인 운영원칙의 해당 조항을 재정의합니다.

다음 섹션에서는 이 두 가지 AI 규칙을 각각 설정하는 방법을 설명합니다:

개인 규칙 만들기

1. Trae IDE의 AI 대화창 오른쪽 상단에서 '설정' 아이콘을 클릭하고 '규칙' 옵션을 선택합니다.
    
   작업이 끝나면 인터페이스에 '규칙' 구성 창이 표시됩니다.
2. 개인 규칙 영역에서 + 创建 user_rules.md 버튼.
   시스템이 자동으로 user_rules.md 파일을 클릭하고 편집기에서 파일을 엽니다.
   
3. 열기 user_rules.md 파일에서 AI가 따라야 할 규칙을 자연어로 입력합니다. 예를 들어 "모든 코드 주석에 중국어를 사용하고 각 함수의 핵심 함수와 매개변수 의미를 설명해 주세요."라고 지정할 수 있습니다.
4. 파일을 저장합니다. 그러면 이 규칙이 모든 프로젝트 AI 동작에 적용됩니다.
   

프로젝트 규칙 만들기

1. 먼저 Trae IDE에서 프로젝트를 엽니다.
2. AI 대화창의 오른쪽 상단에서 설정 아이콘을 클릭하고 규칙을 선택합니다.
   작업이 끝나면 인터페이스에 '규칙' 구성 창이 표시됩니다.
3. 프로젝트 규칙 영역에서 + 创建 project_rules.md 버튼.
   
   시스템은 자동으로 현재 프로젝트 루트 디렉터리를 .trae/rules 폴더(아직 존재하지 않는 경우)를 생성하고 project_rules.md 문서화.
   
4. 열기 project_rules.md 이 프로젝트에 대해 AI가 따라야 하는 규칙을 파일에 입력합니다.
5. 파일을 저장합니다. 이 규칙은 현재 프로젝트의 AI 동작에만 적용됩니다.
   

관리 규칙

'규칙' 구성 창에서 사용자는 기존의 개인 규칙과 프로젝트 규칙을 쉽게 수정할 수 있으며, 더 이상 필요하지 않은 규칙 파일을 직접 삭제할 수도 있습니다.

• 규칙 수정: 규칙 파일의 내용을 편집하고 저장하면 AI가 업데이트된 규칙을 따릅니다.
• 규칙 파일 삭제: 삭제 user_rules.md 어쩌면 project_rules.md 파일에 이전에 정의된 모든 규칙이 무효화됩니다.

III. 실제 데모

다음으로 Trae 규칙을 사용하여 개발 효율성을 개선하는 구체적인 실제 사례를 살펴보겠습니다.

한 개발팀이 웹 프로젝트를 진행하면서 Chakra UI 프레임워크를 사용하여 CSS 스타일을 최적화하기로 결정했다고 가정해 보겠습니다. 이후 작업에서 AI가 이 결정을 따르도록 하려면 프로젝트 규칙(project_rules.md) 파일에 다음 지시문을 추가합니다:

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

이 프로젝트 규칙이 구성되면 개발자가 CSS 관련 개발 작업을 위해 이 규칙을 요청하면 AI(Trae IDE에서 빌더 또는 유사한 명칭으로 불릴 수 있음)가 자동으로 이 규칙을 참조합니다.

예를 들어 '코드 설명은 철저해야 하며 주요 단계를 설명해야 한다'와 같은 다른 개인 규칙을 설정하면, AI는 위에서 설명한 차크라 UI 수정 작업을 수행할 때 프레임워크를 사용할 뿐만 아니라 작동을 설명할 때도 더 자세한 정보를 제공합니다.

IV. 적용 시나리오

트래 규칙은 다양한 시나리오에서 개발팀과 개별 개발자가 코드 일관성을 유지하고, 코드 유지 관리성을 개선하며, 다양한 상황에서 낮은 수준의 오류 발생을 줄이는 데 도움이 될 수 있습니다. 다음은 몇 가지 주요 시나리오의 목록입니다:

시나리오 1: 팀워크 및 코드 검토

• 효과코드 스타일을 통합하고, 검토 분쟁을 줄이고, 협업 효율성을 개선하세요.
• 지침새로운 팀원은 팀의 기존 코드 스타일에 적응하는 데 시간이 필요한 경우가 많습니다. 변수 명명 규칙, 모듈 가져오기 순서, 팀이 지지하는 코드 아키텍처 패턴 등을 지정하는 프로젝트 규칙을 설정하면 AI가 프로그래밍을 지원할 때 이러한 규칙을 따라 새로운 팀원이 팀 스타일에 맞는 코드를 제출할 수 있도록 합니다. 또한 Trae 규칙은 팀원들이 코드 형식을 지정하고, 규정을 준수하지 않는 코드 스니펫을 자동으로 수정하며, 주석 사양(예: 모든 공개 함수에는 JSDoc 스타일의 주석이 필요)을 적용하도록 지원하여 코드 검토 단계에서 스타일 문제를 전달하는 데 드는 비용을 절감할 수 있습니다.

시나리오 2: 프로젝트 유지 관리 및 코드 품질

• 효과잠재적인 코드 오류를 감지하고, 오래된 코드를 점진적으로 개선하며, 전반적인 프로젝트 유지 관리성을 개선하는 데 도움을 줍니다.
• 지침역사가 오래되고 코드 스타일이 혼란스러운 일부 레거시 프로젝트의 경우, Trae 규칙을 점진적으로 도입 및 개선하고 이를 AI의 대화 명령과 결합하여 오래된 코드를 단계적으로 수정할 수 있으며, 규칙에 따라 새 사양에 맞지 않는 코드를 식별하고 리팩터링 제안을 제공할 수 있습니다. 동시에 개발 중 새로운 저수준 오류의 유입을 방지하기 위해 비동기 작업 의무화와 같은 규칙을 설정할 수 있습니다. await 필수 try-catch 구조적 래핑, 미사용 감지 import 문이나 변수의 사용을 금지하여 오류가 발생하기 쉬운 == 의 사용을 강제하고 === 비교하세요. 이러한 규칙은 잠재적인 런타임 문제를 줄이고 코드의 견고성과 장기적인 유지 관리 가능성을 개선하는 데 도움이 됩니다.

시나리오 3: 특정 기술 스택 최적화

• 효과특정 기술 스택(예: React, Vue, Node.js)에 대한 모범 사례 적용을 강화합니다.
• 지침프론트엔드 프로젝트에서 컴포넌트를 작성하는 방식이 일관되지 않으면 컴포넌트를 이해하고 유지 관리하기가 더 어려워질 수 있습니다. 예를 들어, React 프로젝트에서 함수형 컴포넌트 사용을 장려하는 등 Trae 규칙을 설정하여 컴포넌트를 작성하는 일관된 방식을 강제할 수 있습니다( class 컴포넌트 오용)의 모든 컴포넌트는 props 는 타입 검사(타입스크립트 사용 여부에 관계없이)를 거쳐야 하며, 필수 항목인 useEffect Hook 종속성은 전체가 선언되어야 합니다. 일관되지 않은 API 인터페이스 스타일을 가진 백엔드 Node.js 프로젝트의 경우 RESTful API의 경로 형식 사양을 준수하고 오류 처리 프로세스를 표준화하도록 요구하고 console.log를 사용하여 통합 로깅 리포지토리를 의무적으로 사용하도록 전환합니다.

시나리오 4: 보안 및 규정 준수

• 효과일반적인 보안 위반을 방지하고 업계별 규정 준수 요건을 충족하는 데 도움이 됩니다.
• 지침코드 보안은 프로젝트 성공의 초석입니다. SQL 인젝션, 크로스 사이트 스크립팅 공격(XSS) 등과 같은 일반적인 보안 위험에 대해 Trae Rules는 이를 방지하는 데 도움이 되는 규칙을 설정할 수 있습니다. 예를 들어, SQL 쿼리 문자열을 코드에 직접 연결하는 것을 금지하고(매개변수화된 쿼리 또는 ORM 사용 강제), 사용자 입력을 충분히 이스케이프하지 않고 HTML로 직접 출력하는 것을 감지하고(XSS 공격 방지), 다음과 같은 사용을 금지할 수 있습니다. eval() 어쩌면 new Function() Trae 규칙은 코드의 일반 텍스트(예: 비밀번호 및 키)에 민감한 정보가 포함되어 있는지를 탐지하는 데 도움을 줄 수 있습니다. 금융 및 헬스케어와 같이 데이터 보호 및 규정 준수 감사 요건이 엄격한 산업의 경우, Trae 규칙은 코드에 민감한 정보(예: 비밀번호, 키)가 일반 텍스트에 포함되어 있는지 감지하여 비밀번호와 같은 민감한 데이터를 암호화하여 저장하고 로깅에 개인 식별 정보(PII)가 포함되지 않도록 하여 프로젝트가 규정 준수 점검의 요구를 충족하도록 지원할 수 있습니다.

시나리오 5: 개인 개발 습관 최적화하기

• 효과개발자가 개인 코딩 스타일에 일관성을 유지하고 새로운 프로그래밍 언어의 기능을 더 효율적으로 배우고 적용할 수 있도록 지원합니다.
• 지침개인 프로젝트의 경우에도 일관된 코드 스타일을 유지하면 개발 효율성과 코드 가독성을 향상하는 데 도움이 됩니다. 개발자는 개인 규칙을 설정하여 이를 수행할 수 있습니다. 또한 새로운 프로그래밍 언어(예: Rust, Go, Python)를 배울 때 초보자는 해당 언어의 일반적인 패러다임이나 모범 사례에 부합하지 않는 코드를 작성하기 쉽습니다. 예를 들어 Rust 개발에서 Trae 규칙을 설정하여 Result 유형이 올바르게 처리됩니다(직접 통화는 금지됨). unwrap() (오류 무시), Go 개발에서 함수 리턴의 확인 및 처리를 강제합니다. err 변수(오류 무시 금지)를 사용하거나 파이썬 개발에서 유형 어노테이션을 강제로 사용하고 그것이 mypy 및 기타 유형 검사 도구와 호환되므로 개발자가 좋은 코딩 습관을 기르고 새로운 언어의 본질을 더 빨리 파악하는 데 효과적으로 도움을 줄 수 있습니다.

Trae 규칙을 신중하게 설정하고 적용하면 AI를 개발자의 특정 요구 사항과 작업 습관에 보다 정확하게 적용하고 일상적인 개발 워크플로에 보다 원활하게 통합하여 진정으로 효율적인 인간과 컴퓨터의 협업을 실현할 수 있습니다. 관심 있는 개발자는 공식 Trae IDE 채널에서 최신 버전의 Trae IDE를 다운로드하여 이 기능을 직접 체험해 보세요.