Skip to main content

개발·데이터·자동화는 이제 특정 직군만의 언어가 아니다

개발 업무는 자주 오해를 받습니다. 코드를 직접 쓰는 사람만의 세계처럼 보이기 때문입니다. 하지만 실제 현장에서는 기획자도 API 문서를 읽어야 하고, 운영 담당자도 SQL 결과를 해석해야 하며, 팀 리더도 자동화 흐름을 이해해야 합니다. 결국 개발·데이터·자동화는 개발자의 전유물이 아니라, 일을 더 정확하고 덜 반복적으로 만드는 업무 언어에 가깝습니다.

AI는 이 구간에서 특히 힘을 발휘합니다. 코드 설명, 문서화, 설계 피드백, 에러 로그 분석 같은 반복 작업은 AI가 잘 도와주는 대표 영역입니다. 여기에 템플릿형 프롬프트를 붙이면 결과 형식이 안정되고, Markdown이나 JSON 같은 구조화된 출력으로 자동화 연결도 쉬워집니다.12

한마디로 말해, 비개발자에게는 진입 장벽을 낮춰주고, 개발자에게는 귀한 집중 시간을 되돌려줍니다.

이 장의 목표는 화려한 프롬프트를 소개하는 것이 아닙니다. 실제 업무에서 자주 부딪히는 순간마다 바로 꺼내 쓸 수 있는 프롬프트를 정리하는 것입니다. 코드가 외계어처럼 보일 때, 에러 로그가 싸늘하게 웃을 때, SQL이 말을 안 들을 때, 자동화를 어디서부터 시작해야 할지 막막할 때, 이 템플릿들이 작은 사다리가 되어줄 것입니다.

개발·데이터·자동화 프롬프트의 공통 뼈대

이 영역의 프롬프트는 감성보다 구조가 중요합니다. 멋진 표현보다 다음 다섯 가지가 먼저 들어가야 합니다.

  • 역할: 어떤 관점으로 답할지 정합니다.

  • 입력: 코드, 로그, 스키마, 데이터처럼 참고 대상을 한정합니다.

  • 작업: 설명, 수정, 검토, 설계 중 무엇을 원하는지 분명히 씁니다.

  • 출력 형식: 표, 체크리스트, 단계별 설명, JSON 중 하나로 고정합니다.

  • 제약: 추정 금지, 모르는 것은 질문, 위험한 변경은 경고처럼 안전장치를 붙입니다.

실무용 기본 골격은 아래처럼 잡아두면 좋습니다.

당신은 [역할]입니다. 아래 [입력 자료]만 사용해 [작업]을 수행해 주세요. 출력은 [형식]으로 하고, 추정이 필요한 부분은 추정이라고 표시해 주세요. 정보가 부족하면 먼저 확인 질문을 해 주세요.

이 문장 하나로 AI가 아는 척 달리기 대회에 참가하는 일을 꽤 많이 막을 수 있습니다. 개발 업무에서 가장 무서운 것은 틀린 답보다 그럴듯하게 틀린 답이기 때문입니다.

코드 설명 프롬프트 라이브러리

1. 비개발자용 코드 번역 프롬프트

코드를 읽어야 하는데 문법보다 목적이 궁금할 때 쓰는 템플릿입니다. 기획자, PM, 운영 담당자에게 특히 유용합니다.

당신은 기술 내용을 비개발자도 이해하게 설명하는 소프트웨어 교육자입니다. 아래 코드를 사람이 이해할 수 있는 업무 언어로 설명해 주세요.

입력:

  • 언어: [언어]

  • 코드: [코드]

  • 내가 알고 싶은 것: [이 코드가 하는 일 / 어디서 에러가 날 수 있는지 / 사용자에게 어떤 영향을 주는지]

출력 형식:

  1. 이 코드의 한 줄 요약

  2. 무슨 입력을 받아 무엇을 하는지

  3. 실제 서비스에서 하는 역할

  4. 위험하거나 주의할 부분

  5. 비개발자 비유 한 줄

어려운 용어는 바로 쉬운 설명을 붙여 주세요.

이 프롬프트의 핵심은 코드 자체보다 코드의 역할을 이해하게 만드는 데 있습니다. 예를 들어 캐시를 설명할 때 메모장처럼, 큐를 설명할 때 줄 서기처럼 풀어주면 갑자기 코드가 사람말이 됩니다.

2. 라인별 주석 추가 프롬프트

낯선 코드를 인수인계받았을 때 가장 먼저 쓰기 좋은 템플릿입니다.

당신은 프로그래밍 튜터입니다. 아래 코드를 함수 단위와 중요한 라인 단위로 설명해 주세요.

입력:

  • 언어: [언어]

  • 코드: [코드]

  • 독자 수준: [비전공자 / 주니어 개발자 / 중급 개발자]

출력 형식:

  1. 전체 흐름 요약

  2. 함수별 역할 설명

  3. 중요한 라인 주석 예시

  4. 헷갈리기 쉬운 로직 설명

  5. 개선하면 좋은 가독성 포인트

복잡한 로직은 줄여 말하지 말고 단계적으로 풀어 주세요.

코드를 이해할 때 가장 답답한 순간은 전체 구조는 모르겠고, 한 줄 한 줄은 또 묘하게 무섭게 보이는 때입니다. 이 템플릿은 그 공포영화를 교육방송으로 바꿔줍니다.

3. 레거시 코드 인수인계 프롬프트

오래된 코드, 주석 없는 코드, 작성자 퇴사한 코드는 회사의 전설이 되기 쉽습니다. 그 전설을 문서로 바꿔주는 템플릿입니다.

당신은 레거시 시스템 분석가입니다. 아래 코드를 인수인계 문서 초안으로 바꿔 주세요.

입력:

  • 시스템/기능명: [기능명]

  • 코드: [코드]

  • 내가 아는 배경: [있으면 입력]

출력 형식:

  1. 기능 목적

  2. 주요 처리 흐름

  3. 외부 의존성

  4. 입력값과 출력값

  5. 수정 시 위험 구간

  6. 테스트 시 꼭 확인할 시나리오

  7. 후임자가 먼저 읽어야 할 포인트 5개

확실하지 않은 부분은 추정이라고 표시하고, 추가 확인 질문도 제시해 주세요.

4. API 문서 초안 프롬프트

코드는 있는데 문서가 없을 때, 그 반대보다 더 자주 욕을 먹습니다. 그래서 문서 초안은 빠를수록 좋습니다.

당신은 기술 문서 작성자입니다. 아래 API 또는 함수 코드를 문서 초안으로 정리해 주세요.

입력:

  • 언어/프레임워크: [예: Python FastAPI]

  • 코드 또는 설명: [코드]

  • 문서 독자: [개발자 / 외부 파트너 / 사내 운영팀]

출력 형식:

  1. 개요

  2. 엔드포인트 또는 함수 목적

  3. 입력 파라미터 표

  4. 반환값 표

  5. 예외 상황

  6. 예시 요청과 응답

  7. 주의사항

문서는 바로 붙여 넣어도 될 정도로 간결하게 작성해 주세요.

디버깅 프롬프트 라이브러리

5. 에러 로그 원인 분석 프롬프트

에러 로그는 늘 친절하지 않습니다. 오히려 대부분 너무 솔직해서 무슨 말인지 모르겠습니다. 이럴 때는 가능한 원인부터 넓게 잡아야 합니다.

당신은 디버깅 전문가입니다. 아래 에러 로그를 분석해 가능한 원인과 해결 방향을 제시해 주세요.

입력:

  • 언어/환경: [언어, 프레임워크, 운영 환경]

  • 에러 로그: [로그]

  • 관련 코드: [코드 일부]

  • 최근 변경 사항: [배포, 설정 변경, 라이브러리 업데이트 등]

출력 형식:

  1. 가장 가능성 높은 원인 3개

  2. 각 원인의 근거

  3. 빠르게 확인할 체크리스트

  4. 우선 적용할 해결책

  5. 재발 방지 포인트

로그에 없는 사실은 단정하지 말고, 필요한 추가 정보가 있으면 질문해 주세요.

한 가지 원인만 묻지 말고 세 가지 가능성을 요구하면 AI가 한 방향으로만 달려가는 것을 줄일 수 있습니다. 디버깅은 추리소설이지 점집이 아니니까요.

6. 재현 조건 찾기 프롬프트

버그를 고치는 첫 단계는 버그를 재현하는 것입니다. 재현이 안 되면 수정도 우연이 됩니다.

당신은 QA 엔지니어입니다. 아래 문제를 재현하기 위한 테스트 시나리오를 만들어 주세요.

입력:

  • 문제 설명: [증상]

  • 발생 환경: [브라우저, OS, 앱 버전 등]

  • 추정되는 관련 기능: [기능]

출력 형식:

  1. 재현 가설

  2. 단계별 재현 절차

  3. 확인해야 할 환경 변수

  4. 예상 결과와 실제 결과 기록 양식

  5. 개발자에게 전달할 최소 정보 목록

불확실한 부분은 가설로 구분해 주세요.

7. 안전한 수정안 요청 프롬프트

AI에게 바로 코드를 고치게 하는 것은 편하지만, 그대로 붙여 넣는 것은 위험합니다. 특히 운영 코드라면 더 그렇습니다.

당신은 보수적으로 수정하는 시니어 개발자입니다. 아래 코드의 문제를 해결하되, 기존 동작을 최대한 깨지 않는 방향으로 수정안을 제시해 주세요.

입력:

  • 문제 설명: [문제]

  • 코드: [코드]

  • 바꾸면 안 되는 조건: [성능, 응답 형식, 기존 인터페이스 등]

출력 형식:

  1. 문제 원인

  2. 최소 수정안

  3. 수정 코드

  4. 왜 이 방식이 안전한지

  5. 수정 후 테스트 항목

  6. 여전히 남는 리스크

새 기능 추가보다 최소 변경을 우선해 주세요.

8. 테스트 케이스 생성 프롬프트

수정은 했는데 불안할 때, 테스트가 그 불안을 대신 가져가야 합니다.

당신은 테스트 설계 전문가입니다. 아래 기능에 대해 테스트 케이스를 작성해 주세요.

입력:

  • 기능 설명: [기능]

  • 코드 또는 명세: [자료]

출력 형식:

  1. 정상 케이스

  2. 경계값 케이스

  3. 예외 케이스

  4. 실패해야 정상인 케이스

  5. 자동화하기 좋은 케이스와 수동 확인이 필요한 케이스

각 케이스마다 입력, 기대 결과, 테스트 목적을 써 주세요.

9. 코드 리뷰 프롬프트

리뷰는 사람의 눈으로 해야 하지만, AI에게 1차 점검을 맡기면 반복되는 실수를 먼저 걸러낼 수 있습니다.

당신은 [언어]와 [프레임워크]에 익숙한 시니어 개발자입니다. 아래 코드를 리뷰해 주세요.

입력:

  • 코드: [코드]

  • 리뷰 중점: [버그 / 보안 / 성능 / 가독성 / 테스트 용이성]

출력 형식:

  1. 종합 평가

  2. 잘된 점

  3. 문제점

  4. 위치 또는 맥락

  5. 수정 제안

  6. 심각도: 높음 / 중간 / 낮음

비판만 하지 말고, 바로 적용 가능한 개선안을 함께 제시해 주세요.

SQL 프롬프트 라이브러리

SQL은 비개발자에게는 주문처럼 보이고, 개발자에게는 뜻대로 안 되는 마법처럼 보일 때가 있습니다. 그래서 SQL 프롬프트는 특히 입력 정보가 중요합니다. 테이블 구조, 원하는 결과, 필터 조건, 집계 기준이 빠지면 AI는 금방 상상력을 발휘합니다. 그런데 데이터베이스는 상상력을 별로 좋아하지 않습니다.

또한 SQL은 예쁘게 쓰는 것이 단지 취향 문제가 아닙니다. 필요한 컬럼을 명시하고, DB 종류별 문법 차이를 확인하고, 가독성 있게 정리하는 습관이 유지보수성과 검토 속도에 직접 연결됩니다.345

10. 자연어를 SQL로 바꾸는 프롬프트

가장 많이 쓰이는 기본 템플릿입니다.

당신은 SQL 작성 도우미입니다. 아래 요구사항을 SQL로 작성해 주세요.

입력:

  • DB 종류: [MySQL / PostgreSQL / SQL Server / Oracle 등]

  • 테이블 스키마: [테이블명, 컬럼명, 타입]

  • 원하는 결과: [예: 지난 30일간 상품별 매출 합계]

  • 필터 조건: [있으면 입력]

  • 정렬 기준: [있으면 입력]

출력 형식:

  1. SQL 쿼리

  2. 쿼리 설명

  3. 사용한 가정

  4. 확인이 필요한 스키마 정보

제약:

  • SELECT *는 사용하지 말아 주세요.

  • 필요한 컬럼만 명시해 주세요.

  • 문장 끝에는 세미콜론을 붙여 주세요.

  • 값은 가능하면 바인드 변수 형태로 제안해 주세요.

11. SQL 검토와 튜닝 초안 프롬프트

쿼리는 돌아가는데 느릴 때, 또는 왠지 찜찜할 때 쓰는 템플릿입니다.

당신은 SQL 성능 리뷰어입니다. 아래 SQL을 가독성, 성능, 유지보수 관점에서 검토해 주세요.

입력:

  • DB 종류: [DB]

  • SQL: [쿼리]

  • 예상 데이터 규모: [행 수, 대략적인 크기]

  • 인덱스 정보: [알면 입력]

출력 형식:

  1. 가독성 문제

  2. 성능 위험 포인트

  3. 불필요한 연산 가능성

  4. 수정 제안 SQL

  5. 실행 전 확인할 사항

힌트 사용은 마지막 수단으로 보고, 먼저 구조적 개선부터 제안해 주세요.

12. SQL을 사람말로 설명하는 프롬프트

결과는 봐야 하는데 SQL 문법이 어렵다면 이 템플릿이 좋습니다.

당신은 SQL을 업무 언어로 번역하는 데이터 코치입니다. 아래 SQL이 무엇을 구하는지 쉽게 설명해 주세요.

입력:

  • SQL: [쿼리]

  • 설명 대상: [비개발자 / 주니어 분석가 / 운영팀]

출력 형식:

  1. 이 쿼리의 목적

  2. 어떤 테이블을 어떻게 묶는지

  3. 필터 조건의 의미

  4. 집계 방식 설명

  5. 결과를 읽을 때 주의할 점

어려운 용어는 쉬운 비유로 바꿔 주세요.

13. SQL 요청서를 만드는 프롬프트

비개발자가 개발자나 데이터팀에 요청할 때 가장 도움이 되는 템플릿입니다. 요청이 명확하면 왕복 메시지가 줄어듭니다.

당신은 데이터 요청서 작성 도우미입니다. 아래 업무 목적을 데이터 추출 요청서로 정리해 주세요.

입력:

  • 업무 목적: [무엇을 판단하려는지]

  • 필요한 지표: [지표]

  • 기간: [기간]

  • 조건: [필터]

  • 원하는 결과 형태: [표 / CSV / 대시보드]

출력 형식:

  1. 요청 배경

  2. 필요한 데이터 항목

  3. 기간과 조건

  4. 결과 예시

  5. 빠진 정보와 확인 질문

개발자가 바로 이해할 수 있게 모호한 표현을 줄여 주세요.

데이터 해석 프롬프트 라이브러리

앞 장의 리서치와 분석이 자료를 읽고 비교하는 쪽에 가까웠다면, 여기서는 실제 숫자와 표를 보고 해석하는 쪽에 더 가깝습니다. 특히 비개발자에게 필요한 것은 통계 이론이 아니라, 이 숫자가 지금 무슨 뜻인지 빨리 파악하는 일입니다.

14. CSV 첫 해석 프롬프트

데이터 파일을 받았는데 어디서부터 봐야 할지 막막할 때 쓰는 템플릿입니다.

당신은 비즈니스 데이터 분석가입니다. 아래 CSV 또는 표 데이터를 처음 보는 사람의 관점에서 해석해 주세요.

입력:

  • 데이터: [붙여 넣기]

  • 데이터 의미 추정: [알면 입력]

  • 내가 알고 싶은 것: [매출 추세 / 이탈 징후 / 이상치 여부 등]

출력 형식:

  1. 이 데이터가 담고 있는 주제 추정

  2. 먼저 봐야 할 컬럼

  3. 눈에 띄는 패턴 3개

  4. 이상해 보이는 값 3개

  5. 추가로 있으면 좋은 데이터

확인되지 않은 해석은 가설이라고 표시해 주세요.

15. 대시보드 해석 프롬프트

숫자는 많은데 무엇이 중요한지 모르겠을 때 유용합니다.

당신은 경영진 보고를 돕는 데이터 스토리텔러입니다. 아래 지표 또는 대시보드 숫자를 해석해 주세요.

입력:

  • 지표 목록: [지표]

  • 기간 비교: [전주 대비, 전월 대비 등]

  • 맥락: [캠페인 진행, 가격 변경, 시즌성 등]

출력 형식:

  1. 핵심 변화 3개

  2. 좋은 신호와 나쁜 신호

  3. 원인 가설

  4. 당장 확인할 추가 데이터

  5. 회의에서 바로 말할 수 있는 5줄 요약

수치와 해석을 구분해 써 주세요.

16. 이상치와 원인 가설 프롬프트

숫자가 튀면 사람은 당황하고, AI는 신나합니다. 그래서 브레이크를 같이 달아줘야 합니다.

당신은 원인 가설을 신중하게 세우는 데이터 분석가입니다. 아래 데이터에서 이상치 또는 급격한 변화가 보이면 가능한 원인을 가설 형태로 정리해 주세요.

입력:

  • 데이터: [데이터]

  • 이상하게 보이는 구간: [구간]

  • 최근 변화: [배포, 프로모션, 정책 변경 등]

출력 형식:

  1. 이상치 설명

  2. 가능한 원인 가설 3개

  3. 각 가설의 확인 방법

  4. 바로 취할 수 있는 점검 액션

  5. 섣부른 결론을 피해야 하는 이유

확실한 사실과 가설을 반드시 구분해 주세요.

17. 경영진용 데이터 요약 프롬프트

현업에서는 데이터를 잘 보는 것보다, 데이터를 잘 전달하는 쪽이 더 급할 때가 많습니다.

당신은 임원 보고용 데이터 요약 작성자입니다. 아래 데이터를 의사결정용 메모로 바꿔 주세요.

입력:

  • 데이터 또는 분석 결과: [자료]

  • 의사결정 주제: [무엇을 결정할지]

출력 형식:

  1. 핵심 숫자 3개

  2. 숫자가 의미하는 바

  3. 리스크

  4. 추천 액션 3개

  5. 한 줄 결론

전문 용어는 줄이고, 실행 판단에 도움이 되는 표현으로 써 주세요.

자동화 설계 프롬프트 라이브러리

자동화는 거창한 로봇팔이 아닙니다. 누가 봐도 반복되는 일을 입력, 판단, 출력의 흐름으로 나누는 일에 가깝습니다. 잘 설계된 자동화 프롬프트는 역할 정의, 입력 변수, 출력 형식을 고정해 반복 품질을 높이고,2 여러 단계를 나눠 연결하면 더 정확하고 일관된 결과를 만들 수 있습니다.6 최근에는 비개발자도 노코드 도구와 체인 설계를 통해 충분히 자동화 초안을 만들 수 있습니다.

18. 자동화 후보 찾기 프롬프트

무엇을 자동화할지 모르면, 일단 업무를 쪼개야 합니다.

당신은 업무 자동화 컨설턴트입니다. 아래 업무 목록을 보고 AI 또는 자동화로 줄일 수 있는 반복 작업을 찾아 주세요.

입력:

  • 내 업무 목록: [업무 나열]

  • 자주 반복되는 일: [있으면 입력]

  • 시간이 많이 드는 일: [있으면 입력]

출력 형식:

  1. 자동화 후보 업무

  2. 자동화가 쉬운 이유

  3. 완전 자동화보다 보조 자동화가 적절한 업무

  4. 먼저 시도할 3가지

  5. 자동화 전 확인할 리스크

창의적 판단이 큰 업무는 무리하게 자동화하지 말고 보조 형태로 분류해 주세요.

19. 노코드 워크플로우 설계 프롬프트

이메일, 폼, 스프레드시트, 메신저, 문서 도구를 연결하는 흐름을 짜고 싶을 때 좋습니다.

당신은 노코드 자동화 설계자입니다. 아래 업무를 Zapier, Make, Power Automate 같은 도구로 자동화하는 흐름을 설계해 주세요.

입력:

  • 업무 목표: [목표]

  • 시작 이벤트: [예: 폼 제출, 이메일 수신]

  • 사용 도구: [도구 목록]

  • 최종 결과: [예: 슬랙 알림, 노션 저장, 메일 발송]

출력 형식:

  1. 자동화 흐름 단계도

  2. 각 단계의 입력과 출력

  3. 사람이 검토해야 할 지점

  4. 실패 시 대체 경로

  5. 먼저 테스트할 최소 버전

복잡하게 시작하지 말고 가장 단순한 흐름부터 제안해 주세요.

20. JSON 출력 계약 프롬프트

자동화에서는 예쁜 문장보다 안정적인 구조가 더 중요합니다. 다른 시스템이 읽어야 한다면 특히 그렇습니다.

당신은 시스템 연동을 위한 응답 설계자입니다. 아래 작업 결과를 자동화 도구가 읽기 쉬운 JSON 구조로 설계해 주세요.

입력:

  • 작업 목적: [목적]

  • 필요한 필드: [필드 목록]

  • 필수 여부: [필수/선택]

출력 형식:

  1. JSON 스키마 예시

  2. 각 필드 설명

  3. 비어 있을 때 처리 규칙

  4. 오류 응답 예시

JSON 외 다른 설명은 마지막에 짧게 붙여 주세요.

예를 들어 고객 문의 분류 자동화라면 category, urgency, summary, next_action 같은 필드를 고정해두는 식입니다. 이렇게 해두면 AI의 말투가 아니라 구조를 믿고 연결할 수 있습니다.

21. 프롬프트 체인 설계 프롬프트

한 번에 다 시키면 결과가 흔들리는 작업은 여러 단계로 나누는 편이 안전합니다.6

당신은 프롬프트 체인 설계자입니다. 아래 업무를 3단계 이상의 체인으로 나눠 설계해 주세요.

입력:

  • 최종 목표: [목표]

  • 원본 자료: [자료]

  • 원하는 최종 산출물: [산출물]

출력 형식:

  1. 단계별 목표

  2. 각 단계 입력

  3. 각 단계 출력

  4. 다음 단계로 넘기기 전 검증 규칙

  5. 실패 시 다시 실행할 단계

가능하면 분석, 검토, 생성 단계를 분리해 주세요.

예를 들어 코드 개선 자동화라면 1단계 문제 분석, 2단계 수정안 제안, 3단계 코드 생성, 4단계 테스트 케이스 생성으로 나눌 수 있습니다. 한 덩어리로 시킬 때보다 덜 화려하지만 훨씬 덜 위험합니다.

22. 자동화 운영 체크리스트 프롬프트

자동화는 만들고 끝나는 일이 아니라 굴러가게 만드는 일입니다. 그래서 운영 관점의 점검이 필요합니다.

당신은 AI 자동화 운영 담당자입니다. 아래 자동화 시나리오를 운영 가능한 상태인지 점검해 주세요.

입력:

  • 자동화 시나리오: [설명]

  • 사용 모델/도구: [도구]

출력 형식:

  1. 입력 데이터 검증 필요 여부

  2. 민감 정보 처리 필요 여부

  3. 실패 로그 수집 방법

  4. 사람 승인 단계 필요 여부

  5. 품질 검증 방법

  6. 운영 중 자주 깨질 지점

화려한 기능보다 안정적인 운영을 우선해 주세요.

비개발자와 개발자가 각각 이렇게 쓰면 좋다

같은 프롬프트도 사용자에 따라 쓰는 방식이 달라집니다. 비개발자는 문제를 더 잘 정의하는 쪽에 강하고, 개발자는 제약조건을 더 잘 구체화하는 쪽에 강합니다. 그래서 출발점이 조금 다르면 좋습니다.

비개발자는 코드 자체보다 목적과 결과를 먼저 적는 편이 좋습니다. 예를 들어 이 코드가 사용자 로그인에 어떤 영향을 주는지, 이 SQL 결과가 어떤 보고서에 쓰이는지, 이 자동화가 무엇을 줄여야 하는지부터 적으세요. 그러면 AI가 기술 설명을 업무 언어로 맞춰줍니다.

개발자는 반대로 환경과 제약을 먼저 적는 편이 좋습니다. 언어 버전, 프레임워크, 기존 인터페이스 유지 여부, 성능 한계, 테스트 범위 같은 조건을 분명히 쓰면 쓸수록 결과가 실무에 가까워집니다. AI는 똑똑한 인턴 같아서, 일을 잘하지만 배경 규칙을 안 알려주면 종종 너무 신나게 바꿉니다.

실수 방지 규칙

개발·데이터·자동화 프롬프트는 결과가 그럴듯해 보이기 쉬운 만큼, 안전장치가 꼭 필요합니다. 아래 규칙은 거의 항상 붙여도 좋습니다.

  • 추정하지 말고, 제공한 코드·로그·스키마·데이터만 사용해 주세요.

  • 정보가 부족하면 결론 대신 확인 질문부터 해 주세요.

  • 운영 반영 전 테스트해야 할 항목을 반드시 함께 써 주세요.

  • 개인정보, 인증정보, 고객 식별 정보는 마스킹이 필요한지 먼저 점검해 주세요.

  • 삭제, 수정, 배포처럼 되돌리기 어려운 작업은 위험도를 먼저 표시해 주세요.

SQL에서는 특히 한 줄이 큰 사고가 될 수 있습니다. SELECT는 대충 설명해도 되지만 DELETE와 UPDATE는 절대 대충 쓰면 안 됩니다. 자동 생성된 쿼리는 항상 읽고, WHERE 조건을 다시 보고, 샘플 데이터로 먼저 검증하는 습관이 필요합니다. AI가 빨라질수록 사람은 더 침착해야 합니다.

자동화도 마찬가지입니다. 잘 만든 자동화는 시간을 아껴주지만, 잘못 만든 자동화는 실수를 광속으로 복제합니다. 그래서 처음에는 늘 최소 버전부터 시작하는 편이 좋습니다. 한 번에 거대한 시스템을 만들기보다, 이메일 한 통 분류하기, 로그 한 묶음 요약하기, 보고서 초안 한 장 만들기처럼 작은 성공을 쌓는 방식이 안전합니다.

바로 써먹는 수정 프롬프트

처음 결과가 아쉬울 때는 다시 처음부터 쓰지 말고, 방향 있는 수정 요청을 붙이는 편이 낫습니다.

  • 방금 답변을 비개발자도 이해하게 더 쉽게 다시 설명해 주세요.

  • 코드 수정은 최소 변경 원칙으로 다시 제안해 주세요.

  • SQL은 가독성을 높여 다시 정렬하고, 필요한 컬럼만 남겨 주세요.

  • 가설과 사실을 분리해서 다시 써 주세요.

  • JSON 출력으로 바꾸고, 필수 필드 누락 시 오류 예시도 추가해 주세요.

  • 테스트 케이스를 정상, 경계값, 예외로 다시 나눠 주세요.

  • 이 자동화에서 사람이 최종 승인해야 하는 단계를 표시해 주세요.

좋은 수정 프롬프트는 결과를 다시 만들게 하지 않고, 결과를 다듬게 만듭니다. 개발 업무에서는 그 차이가 큽니다. 처음 초안은 빠르게 받고, 다듬는 과정에서 신뢰를 끌어올리는 편이 더 현실적입니다.

결국 중요한 것은 정확한 자동완성이 아니라, 정확한 업무 설계다

코드 설명 프롬프트는 이해를 돕고, 디버깅 프롬프트는 시간을 줄이며, SQL 프롬프트는 데이터 접근성을 높이고, 자동화 설계 프롬프트는 반복 업무를 줄여줍니다. 하지만 그 중심에는 늘 같은 원리가 있습니다. AI에게 잘 시키는 사람은 결국 일을 잘 쪼개고, 잘 설명하고, 잘 검증하는 사람이라는 점입니다.

개발을 모른다고 이 장을 멀리할 필요는 없습니다. 비개발자에게 필요한 것은 코드를 완벽히 쓰는 능력이 아니라, 코드와 데이터와 자동화가 무슨 역할을 하는지 묻는 능력입니다. 반대로 개발자에게 필요한 것도 늘 새로운 문법이 아니라, 반복 업무를 표준화해서 시간을 아끼는 능력입니다. 둘은 생각보다 멀리 떨어져 있지 않습니다.

업무에서 AI를 잘 쓴다는 말은, 더 복잡한 답을 받는다는 뜻이 아닙니다. 더 적은 시행착오로 다음 행동을 결정할 수 있다는 뜻에 가깝습니다. 그 기준으로 보면, 좋은 개발·데이터·자동화 프롬프트는 기술이 아니라 생산성의 설계도입니다.

참고

1Prompt engineering - OpenAI API

2프롬프트 라이브러리 시작하기 - Microsoft Copilot Studio | Microsoft Learn

3PostgreSQL Documentation

4Getting Started with MySQL

5Oracle Database SQL Language Reference, 19c

6Workflow for prompt chaining - AWS Prescriptive Guidance

책 목록

일 잘하는 사람들의 프롬프트 라이브러리

전체 목차 보기

이 노트는 보도·비평·교육·연구 목적으로 작성되었습니다. 저작권 문의가 있으시면 에서 알려주세요.

틸노트는 사용자가 AI를 활용해 노트를 쉽게 작성하거나 편집할 수 있는 서비스입니다.

AI 스퀘어 단톡방에 함께해요

AI 활용과 틸노트 사용 팁을 나누는 오픈채팅방입니다. 입장 비밀번호는 tilnote입니다.

참여하기