Slash Commands
채팅 입력창에서 / 만 눌러도 자주 쓰는 hook을 실행하거나 필요한 steering 파일을 즉시 컨텍스트로 끌어올 수 있습니다.
Slash Commands란?
Slash Commands는 Kiro 채팅에서 두 가지 자원을 빠르게 호출하기 위한 단축 진입점입니다. 하나는 수동 실행으로 설정된 hook, 다른 하나는 수동 포함으로 설정된 steering file입니다. 채팅창에 /를 입력하면 사용 가능한 명령 목록이 떠오르고, 항목을 선택하면 그 자리에서 바로 실행되거나 대화 컨텍스트에 주입됩니다.
두 가지 명령 유형
1. Hook 기반 명령
트리거 방식이 Manual로 지정된 hook은 자동으로 slash 메뉴에 노출됩니다. 명령을 선택하면 Kiro가 현재 세션에서 해당 hook을 즉시 실행하므로, 자주 반복하는 작업을 클릭 한 번으로 끝낼 수 있습니다.
대표적인 hook 명령 예시:
| 명령 | 설명 |
|---|---|
/sync-source-to-docs | 소스 코드 변경 사항을 문서에 동기화 |
/run-tests | 구성된 테스트 스위트 실행 |
/generate-changelog | 최근 커밋을 모아 changelog 작성 |
2. Steering File 기반 명령
모든 대화에 자동으로 합쳐지는 always-on steering과 달리, inclusion: manual로 설정된 steering 파일은 평소에는 비활성 상태로 대기합니다. slash 메뉴에서 선택한 순간에만 해당 파일의 내용이 현재 대화 컨텍스트에 추가되므로, 필요한 가이드만 골라서 끌어쓸 수 있습니다.
실무에서 자주 만들어 두는 steering 명령 예시:
| 명령 | 설명 |
|---|---|
/accessibility | UI 컴포넌트를 위한 접근성 가이드라인 |
/code-review | 코드 리뷰 체크리스트와 피드백 원칙 |
/performance | React/Next.js 성능 최적화 팁 |
/refactor | 리팩터링 규칙과 자주 쓰는 패턴 |
/testing | Jest/RTL 컨벤션과 테스트 표준 |
등록 및 사용 방법
- Hook 등록: hook의 trigger type을
Manual로 지정하면 자동으로 slash 명령으로 노출됩니다. - Steering 파일 등록: steering 파일 frontmatter에
inclusion: manual을 추가합니다. - 실행: 채팅 입력창에서
/를 입력해 목록을 띄우고, 검색하거나 골라서 Enter를 누르면 됩니다.
Tip. 명령 이름은
/run-e2e-tests, /accessibility처럼 동작이 한눈에 들어오는 형태로 짓는 것이 좋습니다. 메뉴에서 빠르게 찾을 수 있고, 팀원들과 공유할 때도 의미가 분명해집니다.
활용 팁
- 워크플로별 분리: frontend, backend, testing처럼 작업 영역에 맞춰 steering 파일을 따로 만들어 두면, 상황에 맞게 컨텍스트를 갈아끼울 수 있습니다.
#컨텍스트 제공자와 조합: slash 명령으로 가이드를 불러오고,#로 파일·심볼·폴더 같은 구체적인 컨텍스트를 더하면 훨씬 정밀한 작업 지시가 가능합니다.- 가벼운 단일 책임: 하나의 steering 파일에 너무 많은 주제를 담기보다는, 명확한 단일 목적을 가진 파일을 여러 개 두고 필요할 때만 호출하는 편이 컨텍스트를 깔끔하게 유지하는 데 도움이 됩니다.
주의. Manual로 설정된 hook과 steering 파일만 slash 메뉴에 나타납니다. 항상 적용되어야 하는 규칙이라면 always-on 설정이 적합하고, 가끔만 필요한 가이드라면 manual로 두는 편이 컨텍스트 낭비를 줄여 줍니다.