번역 자료 / / 2025. 5. 20. 07:29

[cursor docs] @ Docs

개요

Cursor의 @ Docs 기능은 코드베이스 내의 문서 파일을 빠르게 탐색하고, AI가 해당 문서의 맥락을 정확히 이해할 수 있도록 도와줍니다. 이 글에서는 @ Docs의 개념, 주요 기능, 실제 사용 방법, 그리고 실무에서의 활용 팁을 단계별로 설명합니다.

@ Docs란?

@ Docs는 코드 내에서 문서 파일(README, 가이드, 설계 문서 등)로 빠르게 이동하거나, AI가 특정 문서의 내용을 우선적으로 참고하도록 지정할 수 있는 기능입니다. 대규모 프로젝트에서도 원하는 문서를 신속하게 찾고, 관련 정보를 효율적으로 확인할 수 있습니다.

주요 기능

  • 빠른 문서 탐색: @ 뒤에 문서명을 입력하면 프로젝트 내 모든 문서 파일을 검색할 수 있습니다.
  • 문서 기반 컨텍스트 제공: AI가 특정 문서의 전체 내용이나 구조를 우선적으로 참조합니다.
  • 자동 완성 및 추천: 문서명 일부만 입력해도 자동 완성 기능이 동작합니다.
  • 대규모 프로젝트 지원: 수많은 문서가 있는 환경에서도 빠른 탐색이 가능합니다.

실제 사용 방법

  1. 문서 검색: 에디터에서 @를 입력한 뒤, 찾고자 하는 문서명을 입력하면 해당 문서로 바로 이동할 수 있습니다.
  2. AI 컨텍스트 강화: 프롬프트나 명령어에서 @문서명을 사용하면, AI가 해당 문서의 내용을 우선적으로 참고합니다.
  3. 자동 완성 활용: 문서명을 전부 입력하지 않아도, 일부만 입력하면 자동 완성 리스트가 나타나 빠르게 선택할 수 있습니다.

실무 활용 팁

  • 대규모 프로젝트에서는 문서 검색 기능을 적극 활용해, 원하는 문서로 빠르게 이동하세요.
  • AI에게 특정 문서의 맥락을 명확히 전달하고 싶을 때 @문서명을 프롬프트에 포함시키면 더욱 정확한 답변을 받을 수 있습니다.
  • 비슷한 이름의 문서가 많을 때는 자동 완성 리스트에서 원하는 항목을 쉽게 선택할 수 있습니다.

참고 자료

반응형
  • 네이버 블로그 공유
  • 네이버 밴드 공유
  • 페이스북 공유
  • 카카오스토리 공유