AI 에이전트 프롬프트

에이전트에게 맡기는 버그 수정 지시서

재현 방법, 기대와 실제, 고친 뒤 확인할 테스트를 담아 에이전트가 원인부터 찾게 해요.

이 프롬프트로 얻는 결과, 예시

실제 결과는 넣는 자료와 쓰는 AI에 따라 달라져요.

복사될 내용

<role>
당신은 버그 보고를 정확하게 쓰는 QA 리드예요.
</role>

<task>
아래 버그를 에이전트에게 고치게 할 지시서로 써 주세요.
</task>

<material>
[증상]
증상

[재현 방법]
재현 방법

[기대한 동작]
기대한 동작

[오류 메시지나 로그]
로그
</material>

<instructions>
1. 고치기 전에 원인을 먼저 찾고 보고하게 한다.
2. 버그를 재현하는 테스트를 먼저 쓰고, 그 테스트가 실패하는 것을 확인한 뒤 고치게 한다.
3. 관련 없는 코드 정리나 이름 바꾸기를 하지 말라고 적는다.
4. 고친 뒤 비슷한 곳에 같은 버그가 있는지 찾아보게 한다.
</instructions>

<output_format>
[버그 요약] [재현] [기대와 실제] [작업 순서: 원인 찾기, 실패 테스트, 고치기, 확인] [하지 말 것] [보고할 것] 순서로 써 주세요.
</output_format>

먼저 <material>을 끝까지 읽고, <instructions>를 지키며 <task>를 수행해 주세요. 정보가 모자라면 추측하지 말고 무엇이 더 필요한지 물어봐 주세요.

빈칸 4개 중 0개 채움. 비워 둔 칸은 {{ }} 모양 그대로 복사돼요.

  • 작업 지시서

    코딩 에이전트에게 넘길 작업 지시서

    하고 싶은 일을 목표, 범위, 하지 말 것, 완료 기준으로 나눠, 에이전트가 헤매지 않게 넘겨요.

  • 규칙 파일

    길어진 규칙 파일 줄이기

    시간이 지나며 불어난 규칙 파일에서 낡은 규칙, 겹치는 규칙, 서로 부딪히는 규칙을 찾아 줄여요.

  • 규칙 파일

    CLAUDE.md와 AGENTS.md 규칙 파일 초안

    프로젝트 정보를 주면 에이전트가 매번 읽을 규칙 파일을 짧고 쓸모 있게 써 줘요.

  • 계획 세우기

    만들기 전에 한 번에 하나씩 질문하게 하기

    에이전트가 짐작으로 만들기 시작하지 않고, 꼭 필요한 것을 한 번에 하나씩 물어보게 해요.

찾는 프롬프트가 없나요? 요청하거나 직접 올려 주세요

기술 라이브러리

혼자 공부한 것을 정리해 두는 개발자의 서재예요. 예제는 직접 돌려 보고 씁니다.

© 2026 기술 라이브러리