Skip to main content

폴더 멘션

폴더 멘션을 사용하면 전체 디렉토리를 Cline과의 대화에 가져올 수 있습니다. @/ 뒤에 슬래시로 끝나는 폴더 경로를 입력하기만 하면 Cline이 폴더 구조와 내용을 액세스할 수 있습니다.

채팅에 @/를 입력하면 Cline이 작업 공간 파일 및 폴더를 표시합니다. 원하는 폴더로 이동하고 후행 슬래시를 포함하면 Cline이 폴더의 구조와 내용을 볼 수 있습니다.

저는 코드베이스의 전체 섹션을 이해하거나 리팩토링하는 데 도움이 필요할 때 폴더 멘션을 사용합니다. 개별 파일을 하나씩 참조하는 대신 전체 디렉토리를 가리킬 수 있습니다.

앱의 인증 흐름이 어떻게 작동하는지 이해하려고 합니다.
@/src/auth/에 있는 파일 간의 구조와 관계를 설명해 줄 수 있나요?

그러면 Cline은 auth 디렉토리의 모든 파일, 해당 내용 및 서로 어떻게 관련되어 있는지 볼 수 있습니다. 이는 여러 파일 간의 복잡한 상호 작용을 설명하는 데 필요한 전체 컨텍스트를 제공합니다.

폴더 멘션은 프로젝트 구성에 대한 도움을 받는 데도 완벽합니다. 프로젝트 구조가 합리적인지 확실하지 않을 때 Cline에게 검토를 요청합니다.

새 React 프로젝트를 설정하고 있습니다. 이 폴더 구조가 합리적인가요? @/src/
프로젝트가 성장함에 따라 유지 관리하기 더 좋게 만들려면 무엇을 변경해야 할까요?

다음에 여러 관련 파일로 작업할 때 각 파일을 개별적으로 참조하는 대신 폴더 멘션을 사용해 보십시오. Cline이 모든 것이 어떻게 조화를 이루는지에 대한 더 큰 그림을 볼 수 있으므로 더 포괄적인 도움을 받을 수 있습니다.

내부 작동 방식

메시지에서 폴더 멘션을 사용하면 내부적으로 다음과 같은 일이 발생합니다.

  1. 메시지를 보내면 Cline은 텍스트에서 @/path/to/folder/ 패턴(후행 슬래시 포함)을 감지합니다.

  2. 확장은 작업 공간 루트를 기준으로 폴더 경로를 확인합니다.

  3. fs.readdir()을 호출하여 해당 폴더의 모든 파일 및 하위 디렉토리 목록을 가져옵니다.

  4. 디렉토리의 각 파일에 대해 이진 파일인지 텍스트 기반 파일인지 확인합니다.

  5. 텍스트 파일의 경우 전체 내용을 추출합니다.

  6. 폴더 구조 및 파일 내용은 구조화된 형식으로 메시지에 추가됩니다.

    <folder_content path="path/to/folder">
    ├── file1.txt
    ├── file2.js
    └── subfolder/

    <file_content path="path/to/folder/file1.txt">
    [파일 내용]
    </file_content>

    <file_content path="path/to/folder/file2.js">
    [파일 내용]
    </file_content>
    </folder_content>
  7. 포함된 폴더 구조 및 파일 내용이 있는 이 향상된 메시지가 AI로 전송됩니다.

  8. 이제 AI는 디렉토리 구조와 해당 디렉토리 내의 파일 내용을 모두 "볼" 수 있습니다.

이 프로세스는 폴더 멘션을 사용할 때마다 자동으로 발생하여 AI에 프로젝트 구조 및 파일 내용에 대한 포괄적인 보기를 제공합니다.