프롬프트 관리

Table of contents

  1. 1. 프롬프트 유형
  2. 2. 명령어
  3. 3. 프롬프트 목록 조회
  4. 4. 프롬프트 생성
    1. Parameters (매개변수)
    2. Behavior (동작 방식)
  5. 5. 프롬프트 수정
    1. 지원 대상
  6. 6. 프롬프트 상세 정보 확인
  7. 7. 프롬프트 사용
    1. Examples
  8. 8. MCP 프롬프트에 인자 전달
    1. MCP Prompt Argument Syntax
    2. Examples
  9. 9. 저장 위치
    1. Local Prompts (로컬 프롬프트)
    2. Global Prompts (글로벌 프롬프트)
    3. MCP Prompts
  10. 10. 우선순위 체계
  11. 11. 향상된 기능
    1. Content Preview (콘텐츠 미리보기)
    2. Improved Error Handling (개선된 오류 처리)
    3. Visual Formatting (시각적 포맷팅)
    4. MCP Integration (MCP 통합)
  12. 12. 예시
  13. 기본 파일 기반 프롬프트 생성 및 사용
  14. MCP 인자 기반 프롬프트 사용 예시


Kiro CLI는 로컬(Local) 프롬프트, 글로벌(Global) 프롬프트, 그리고 Model Context Protocol(MCP) 기반 프롬프트를 모두 지원합니다. 이를 통해 개발 워크플로우 전반에서 재사용 가능한 프롬프트를 생성·수정·구성·활용할 수 있는 종합적인 프롬프트 관리 기능을 제공합니다.


1. 프롬프트 유형

프롬프트 시스템은 다음 세 가지 유형을 지원합니다:


2. 명령어

프롬프트 관련 모든 기능은 /prompts 명령어의 다양한 서브커맨드를 통해 접근합니다.


3. 프롬프트 목록 조회

/prompts list

모든 사용 가능한 프롬프트를 이름(Name) · 설명(Description) · **출처(Source)**의 3열 형식으로 표시합니다.

또한 프롬프트 개수와 로컬/글로벌/MCP 중 어디에서 제공되는 프롬프트인지 명확히 나타냅니다.


4. 프롬프트 생성

/prompts create –name name [–content content]

현재 워크스페이스에 로컬 프롬프트(Local Prompt)를 생성합니다.

Parameters (매개변수)

Behavior (동작 방식)


5. 프롬프트 수정

/prompts edit name

기존 프롬프트를 기본 에디터에서 열어 수정합니다.

지원 대상


6. 프롬프트 상세 정보 확인

/prompts details name

아래 항목을 포함한 상세 정보를 제공합니다:


7. 프롬프트 사용

생성한 프롬프트는 채팅에서 @ 프리픽스(prefix)를 통해 호출합니다.

@prompt-name

Examples

@code-review
# 로컬 'code-review' 프롬프트 사용

@team-standup
# 글로벌 또는 MCP 'team-standup' 프롬프트 사용

8. MCP 프롬프트에 인자 전달

MCP 서버 기반 프롬프트는 인수(arguments) 를 받아 동작을 커스터마이징할 수 있습니다.

단, 로컬/글로벌 파일 기반 프롬프트는 인자를 지원하지 않습니다.

MCP Prompt Argument Syntax

@server-name/prompt-name <required-arg> [optional-arg]

어떤 인자를 지원하는지 확인하려면:

/prompts details prompt-name

Examples

@dev-tools/analyze "performance issue" "detailed"
@security-tools/scan "web-app" "high-severity"

9. 저장 위치

Local Prompts (로컬 프롬프트)

Global Prompts (글로벌 프롬프트)

MCP Prompts


10. 우선순위 체계

동일한 이름의 프롬프트가 여러 위치에 존재하는 경우 다음 순서로 우선 적용됩니다:

  1. Local Prompts (최고 우선순위)
  2. Global Prompts
  3. MCP Prompts (최저 우선순위)

이를 통해 프로젝트 요구에 맞춰 MCP 또는 글로벌 프롬프트를 손쉽게 오버라이드할 수 있습니다.


11. 향상된 기능

Content Preview (콘텐츠 미리보기)

AI로 전달되기 이전의 완전한 프롬프트 내용을 표시해, 실제 처리되는 정보를 명확히 파악하도록 지원합니다.

Improved Error Handling (개선된 오류 처리)

Visual Formatting (시각적 포맷팅)

MCP Integration (MCP 통합)


12. 예시

기본 파일 기반 프롬프트 생성 및 사용

# 인자를 필요로 하지 않는 단순 프롬프트 생성
/prompts create --name code-review --content “최적의 모범 사례(best practices), 보안 이슈(security issues), 그리고 잠재적 개선 사항(potential improvements)을 위해 이 코드를 검토해 주세요:”

# 프롬프트 사용 (파일 기반 프롬프트는 인수 미지원)
@code-review

MCP 인자 기반 프롬프트 사용 예시

@dev-tools/analyze "performance bottleneck" "cpu usage"
@security-tools/scan "web-app" "high-severity"
@aws-tools/deploy "my-service" "production" "us-west-2"