빠른 참조 가이드
자주 사용하는 명령어와 패턴 모음
빠른 참조 가이드
실무에서 자주 사용하는 Kiro 명령어와 패턴을 정리했습니다.
컨텍스트 참조
# 파일 참조
#File path/to/file.js
# 폴더 참조
#Folder src/components
# 문제 확인
#Problems
# 터미널 출력
#Terminal
# Git 변경사항
#Git Diff
# 전체 코드베이스
#CodebaseSteering 파일 패턴
프로젝트 표준 (.kiro/steering/standards.md)
---
inclusion: always
---
# 프로젝트 표준
## 코딩 스타일
- TypeScript 엄격 모드 사용
- ESLint + Prettier 설정 준수
- 함수형 컴포넌트 우선
## 네이밍 규칙
- 컴포넌트: PascalCase
- 함수/변수: camelCase
- 상수: UPPER_SNAKE_CASE조건부 포함 (.kiro/steering/react-patterns.md)
---
inclusion: fileMatch
fileMatchPattern: "*.tsx"
---
# React 패턴
## 컴포넌트 구조
1. Props 타입 정의
2. 기본값 설정
3. 로직 분리
4. JSX 반환Hook 레시피
저장 시 린트 실행
{
"name": "Auto Lint on Save",
"version": "1.0.0",
"when": {
"type": "fileEdited",
"patterns": ["*.ts", "*.tsx", "*.js", "*.jsx"]
},
"then": {
"type": "askAgent",
"prompt": "파일 저장 시 ESLint 실행하고 오류 수정해줘"
}
}테스트 파일 자동 생성
{
"name": "Create Test File",
"version": "1.0.0",
"when": {
"type": "fileCreated",
"patterns": ["src/**/*.ts", "src/**/*.tsx"]
},
"then": {
"type": "askAgent",
"prompt": "새로 생성된 파일에 대한 테스트 파일을 __tests__ 폴더에 생성해줘"
}
}커밋 전 검증
{
"name": "Pre-commit Check",
"version": "1.0.0",
"when": {
"type": "userTriggered"
},
"then": {
"type": "askAgent",
"prompt": "커밋 전 체크리스트: 1) 린트 통과 2) 테스트 통과 3) 타입 체크 4) 빌드 성공"
}
}MCP 서버 설정
기본 서버들
{
"mcpServers": {
"filesystem": {
"command": "uvx",
"args": ["mcp-server-filesystem", "/path/to/allowed/dir"]
},
"git": {
"command": "uvx",
"args": ["mcp-server-git", "--repository", "."]
},
"postgres": {
"command": "uvx",
"args": ["mcp-server-postgres"],
"env": {
"POSTGRES_CONNECTION_STRING": "postgresql://user:pass@localhost/db"
}
}
}
}커스텀 서버
{
"mcpServers": {
"my-api": {
"command": "node",
"args": ["./scripts/mcp-server.js"],
"env": {
"API_KEY": "your-api-key"
}
}
}
}자주 사용하는 프롬프트 패턴
코드 리뷰 요청
이 PR의 변경사항을 리뷰해줘:
#Git Diff
다음 관점에서 확인:
1. 코드 품질
2. 성능 영향
3. 보안 이슈
4. 테스트 커버리지버그 분석
다음 오류를 분석하고 해결책 제시해줘:
#Problems
#Terminal
관련 파일들:
#File src/components/ErrorComponent.tsx
#File src/utils/errorHandler.ts리팩토링 계획
다음 코드를 리팩토링하고 싶어:
#File src/legacy/oldCode.js
목표:
- TypeScript 변환
- 함수형 패러다임 적용
- 테스트 추가
- 성능 최적화
단계별 계획 세워줘.성능 최적화 체크리스트
컨텍스트 관리
- 불필요한 파일 참조 제거
- 큰 파일은 부분 읽기 활용
- 세션별 컨텍스트 분리
- 정기적 컨텍스트 정리
멀티세션 효율화
- 독립적 작업은 별도 세션
- 공통 컨텍스트는 Steering으로
- 세션간 중복 작업 방지
- 결과 공유 체계 구축
자동화 최적화
- Hook 이벤트 최소화
- MCP 서버 응답 시간 모니터링
- Power 도구 캐싱 활용
- 배치 작업 스케줄링
트러블슈팅 빠른 해결
일반적 문제
# Kiro 재시작
Cmd/Ctrl + Shift + P → "Kiro: Restart"
# 캐시 클리어
rm -rf ~/.kiro/cache/*
# 설정 초기화
mv ~/.kiro/settings ~/.kiro/settings.backupMCP 서버 문제
# 서버 상태 확인
Cmd/Ctrl + Shift + P → "MCP: Show Server Status"
# 서버 재연결
Cmd/Ctrl + Shift + P → "MCP: Reconnect All Servers"
# 로그 확인
tail -f ~/.kiro/logs/mcp-*.log성능 문제
# 메모리 사용량 확인
Cmd/Ctrl + Shift + P → "Kiro: Show Performance Stats"
# 컨텍스트 크기 확인
Cmd/Ctrl + Shift + P → "Kiro: Show Context Size"
# 세션 정리
Cmd/Ctrl + Shift + P → "Kiro: Clear Session History"Kiro CLI 주요 명령어 (v1.28+)
# 기본 명령어
kiro # 대화형 모드 시작
kiro "프롬프트" # 단일 프롬프트 실행
kiro -p "프롬프트" # --print: 결과만 출력 (비대화형)
cat file | kiro -p "분석" # 파이프 입력
# TUI 모드 (v1.28 실험적)
kiro --tui # TUI 모드: 라이브 상태 바, 마크다운 강조, 인터랙티브 패널
# 세션 중 새 대화 시작 (v1.28)
/chat new # 새 대화 시작
/chat new "초기 프롬프트" # 초기 프롬프트와 함께 새 대화 시작
# 모델 관리
kiro --model sonnet # Claude Sonnet 4.6 사용
kiro --model opus # Claude Opus 4.6 사용
kiro --list-models # 사용 가능한 모델 목록 조회 (v1.28)
kiro --list-models --format json # JSON 형식으로 모델 목록 조회
# 시스템 프롬프트
kiro -s "당신은 보안 전문가" "코드 리뷰해줘" # --system-prompt
# 출력 형식
kiro -p --output-format json "분석해줘" # JSON 출력
kiro -p --output-format stream-json "..." # 스트리밍 JSON
# MCP 서버
kiro --mcp-config mcp.json "도구 사용" # 커스텀 MCP 설정
kiro mcp serve # MCP 서버로 실행
# 설정 관리
kiro config list # 전체 설정 조회
kiro config set model opus # 기본 모델 변경유용한 단축키
| 기능 | macOS | Windows/Linux |
|---|---|---|
| Kiro 채팅 열기 | Cmd + K | Ctrl + K |
| 파일 참조 추가 | Cmd + Shift + F | Ctrl + Shift + F |
| 컨텍스트 메뉴 | Cmd + Shift + C | Ctrl + Shift + C |
| Hook 실행 | Cmd + Shift + H | Ctrl + Shift + H |
| MCP 도구 실행 | Cmd + Shift + M | Ctrl + Shift + M |
응급 복구 명령어
완전 초기화
# 모든 설정 백업 후 초기화
cp -r ~/.kiro ~/.kiro.backup.$(date +%Y%m%d)
rm -rf ~/.kiro
# Kiro 재시작 후 설정 복원선택적 복구
# 설정만 초기화
rm ~/.kiro/settings.json
# 캐시만 클리어
rm -rf ~/.kiro/cache/*
# 세션 히스토리만 클리어
rm -rf ~/.kiro/sessions/*이 빠른 참조 가이드를 북마크해두고 필요할 때마다 활용하세요!