본문으로 바로가기
리옵트 핸드북
리옵트 핸드북
Kiro 고급 활용Ch1. 플랜 & 환경 설정Ch2. Steering 마스터하기Ch3. 멀티세션 워크플로우Ch4. 서브에이전트 활용Ch5. Hooks 시스템Ch6. MCP 서버 연동Ch7. Powers & 커스텀 도구Ch8. Autopilot 모드 활용Ch9. 컨텍스트 관리Ch10. IDE 기능 활용Ch11. Spec 기반 개발Ch12. 바이브코딩 실전 패턴Ch13. 커뮤니티 & 리소스Ch14. 트러블슈팅 & FAQ엔터프라이즈 패턴빠른 참조 가이드

업데이트 히스토리
핸드북›Kiro 고급 활용›빠른 참조 가이드

빠른 참조 가이드

#File·#Folder·#Problems 등 컨텍스트 참조, Steering·Hook·MCP 설정 스니펫, Kiro CLI v1.28 명령어와 단축키·트러블슈팅을 한눈에 모은 치트시트

핵심 요약

  • 컨텍스트 참조 토큰은 #File·#Folder·#Problems·#Terminal·#Git Diff·#Codebase로 채팅에 자료를 끌어옵니다.
  • Steering(inclusion: always/fileMatch), Hook(fileEdited·fileCreated·userTriggered), MCP 서버 설정의 복붙용 스니펫을 제공합니다.
  • Kiro CLI v1.28 주요 플래그: -p(print), --tui, /chat new, --model sonnet|opus, --list-models, --output-format json.
  • 문제가 생기면 Restart → 캐시 클리어(~/.kiro/cache) → MCP 재연결 → 로그 확인(~/.kiro/logs/mcp-*.log) 순으로 짚어 나갑니다.

실무에서 자주 쓰는 Kiro 명령어와 패턴을 모았습니다.

컨텍스트 참조

# 파일 참조
#File path/to/file.js

# 폴더 참조  
#Folder src/components

# 문제 확인
#Problems

# 터미널 출력
#Terminal

# Git 변경사항
#Git Diff

# 전체 코드베이스
#Codebase

Steering 파일 패턴

프로젝트 표준 (.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.backup

MCP 서버 문제

# 서버 상태 확인
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                   # 기본 모델 변경

유용한 단축키

기능macOSWindows/Linux
Kiro 채팅 열기Cmd + KCtrl + K
파일 참조 추가Cmd + Shift + FCtrl + Shift + F
컨텍스트 메뉴Cmd + Shift + CCtrl + Shift + C
Hook 실행Cmd + Shift + HCtrl + Shift + H
MCP 도구 실행Cmd + Shift + MCtrl + 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/*

이 가이드는 북마크해두고 필요할 때 꺼내 보시면 됩니다.

관련 문서

Ch13. 커뮤니티 & 리소스

공식 문서·changelog·Discord·GitHub 토픽, Awesome MCP Servers와 cc-sdd 등 오픈소스, 학습 채널과 단계별 Kiro 마스터 로드맵 정리

Ch9. 컨텍스트 관리

#File·#Folder·#[[file:]] 참조와 inclusion 모드, 계층적 메모리 설계, 점진적 확장·요약·캐싱으로 1M 토큰 컨텍스트를 효율적으로 운용하는 방법

Ch11. MCP 연동

Codex 고급 활용 · STDIO·Streamable HTTP MCP 서버 등록(codex mcp add), allowlist·enabled_tools·timeout 정책, resource/action 서버 분리와 plugin 마켓플레이스 라이프사이클로 외부 도구 연동을 통제하는 운영 가이드

Cmd. /mcp

Claude Code 명령어 마스터 · MCP 서버 연결과 OAuth 인증을 관리하고, 노출된 도구 상태를 점검하는 명령

Ch6. MCP 서버 연동

Claude Code 고급 활용 · Claude Code에서 Model Context Protocol 서버와 도구·리소스를 운영하는 방법

엔터프라이즈 패턴

GovCloud·Okta/Entra·MCP/Model Governance, Git Submodule 기반 중앙 Steering, CI/CD·감사 로그·ROI 측정까지 대규모 팀의 Kiro 운영 패턴

업데이트 히스토리

Kiro 고급 활용 핸드북의 버전별 업데이트 내역

On this page

컨텍스트 참조Steering 파일 패턴프로젝트 표준 (.kiro/steering/standards.md)조건부 포함 (.kiro/steering/react-patterns.md)Hook 레시피저장 시 린트 실행테스트 파일 자동 생성커밋 전 검증MCP 서버 설정기본 서버들커스텀 서버자주 사용하는 프롬프트 패턴코드 리뷰 요청버그 분석리팩토링 계획성능 최적화 체크리스트컨텍스트 관리멀티세션 효율화자동화 최적화트러블슈팅 빠른 해결일반적 문제MCP 서버 문제성능 문제Kiro CLI 주요 명령어 (v1.28+)유용한 단축키응급 복구 명령어완전 초기화선택적 복구