커스텀 명령어를 사용하면 채팅 입력창에서 간단한 / 접두사로 실행할 수 있는 재사용 가능한 워크플로우를 만들 수 있어. 이런 명령어들은 팀 전체의 프로세스를 표준화하고 자주 하는 작업들을 더 효율적으로 처리할 수 있게 해줘.
Commands input example
Commands는 현재 베타 버전이야. 지속적인 개선 과정에서 기능과 문법이 변경될 수 있어.

명령어 작동 원리

명령어는 프로젝트의 .cursor/commands 디렉터리에 저장된 일반 Markdown 파일로 정의돼. 채팅 입력창에 /를 입력하면 Cursor가 자동으로 이 디렉터리에서 사용 가능한 명령어를 감지해서 보여줘.

명령어 만들기

  1. 프로젝트 루트에 .cursor/commands 디렉토리를 만들어
  2. 설명적인 이름으로 .md 파일을 추가해 (예: review-code.md, write-tests.md)
  3. 명령어가 수행해야 할 작업을 설명하는 일반 마크다운 콘텐츠를 작성해
  4. /를 입력하면 명령어가 자동으로 채팅에 나타나
명령어 디렉토리 구조 예시는 다음과 같아:
.cursor/
└── commands/
    ├── address-github-pr-comments.md
    ├── code-review-checklist.md
    ├── create-pr.md
    ├── light-review-existing-diffs.md
    ├── onboard-new-developer.md
    ├── run-all-tests-and-fix.md
    ├── security-audit.md
    └── setup-new-feature.md

예제

프로젝트에서 이 명령어들을 직접 써보면서 어떻게 동작하는지 감을 잡아보자.