Your Prompt Engineer

Your Prompt Engineer은(는) 무엇을 하나요?

개요

사용자의 대략적인 요청을 정확한 위임 프롬프트로 변환하고, 적절한 에이전트 모드를 선택한 후, 준비된 프롬프트를 사용자에게 보여주고, 현재 호스트가 위임 메커니즘을 제공하는 경우 확인 후 전송합니다.

Codex와 Claude Code는 일급 대상(first-class targets)입니다. 다른 호환 가능한 에이전트 호스트는 동일한 프롬프트 준비, 대상 확인, 확인 및 안전 게이트 동작을 사용한 후, 기본 호스트 도구를 통해 전송해야 합니다. 전송 도구를 사용할 수 없는 경우, 작업이 전송되었다고 주장하는 대신 준비된 프롬프트와 명확한 핸드오프 지침을 제공합니다.

사용자와의 커뮤니케이션은 중국어, 영어, 일본어를 지원합니다. 실행에 가장 적합한 프롬프트 언어를 선택합니다. 일반적으로 기술/코드 작업은 영어를, 작성, 현지화 또는 도메인별 작업은 프로젝트 또는 대상 언어를 사용합니다. 사용자의 고객을 대상으로 하는 답변은 프로젝트 언어를 따라야 하며, 불명확한 경우 사용자의 현재 언어를 따릅니다.

호출

사용자가 $your-prompt-engineer를 입력하도록 요구하지 마십시오. 명시적인 스킬 호출과 자연어 의도를 동등하게 취급합니다.

호스트 간 안정적인 동작을 위해 명시적 호출을 권장합니다:

Use $your-prompt-engineer <your rough request>

자연어 호출은 호스트가 암시적 개인 스킬 검색을 지원하는 경우 작동할 수 있지만, 예측 가능한 프롬프트 준비, 확인 및 전송 동작을 위해서는 명시적 호출을 권장합니다.

사용자가 프롬프트/요구사항 준비 언어와 에이전트 위임 언어를 결합하는 경우, 위임 도구나 병렬 에이전트 스킬보다 먼저 이 스킬을 사용하십시오. 사용자가 명시적으로 직접 전송을 요청하지 않는 한, 먼저 에이전트를 전송하고 나중에 요약하지 마십시오.

다음과 같은 요청에서 트리거됩니다:

• "帮我写个 prompt"
• "帮我写个 prompt，让 agent 去做"
• "整理成 agent prompt"
• "优化这个 prompt，然后问我要不要发给 agent"
• "帮我整理一下需求，让 subagent 先只读检查这个项目"
• "把这个变成 subagent prompt"
• "send this prompt to an agent"
• "turn this into a Claude Code task prompt"
• "agent に渡すプロンプトを書いて"

사용자가 에이전트/서브에이전트로 실행, 생성, 전송, 위임, 검사, 수정, 구현 또는 확인을 요청하지만 프롬프트 작성이나 프롬프트 준비를 언급하지 않는 경우 암시적으로 트리거하지 마십시오. 이 경우 사용자가 명시적으로 $your-prompt-engineer를 호출하지 않는 한 호스트의 일반적인 위임 동작을 선호합니다.

워크플로

1. 사용자가 프롬프트 준비, 에이전트 위임 또는 둘 다를 원하는지 식별합니다.
2. 요청이 실행하기에 충분히 명확한지 또는 정찰이 필요한지 결정합니다.
3. 작업 의도, 대상 객체, 출력, 제약 조건, 수락 신호, 위험 수준, 언어 및 최적의 호스트 어댑터를 추출합니다.
4. 프롬프트를 작성하기 전에 작업 대상을 확인합니다.
5. 확인 우선, 직접 전송 또는 정찰 우선 모드를 선택합니다.
6. references/prompt-templates.md를 사용하여 준비된 프롬프트를 생성합니다.
7. 직접 전송 모드가 적용되지 않는 한 프롬프트를 사용자에게 보여주고 전송할지 묻습니다. 가능한 경우 호스트의 기본 대화형 선택 UI를 선호합니다.
8. 확인 또는 명시적인 직접 전송 지시 후, 사용 가능한 최상의 호스트 어댑터로 전송합니다.
9. 사용된 에이전트 유형/도구와 가능한 경우 에이전트 ID 또는 작업 핸들을 보고합니다.

사용자가 직접 전송, 자동 전송 또는 확인 불필요를 명시적으로 말하는 경우에만 확인 단계를 건너뜁니다.

전송 모드

• 기본적으로 확인 우선 모드를 사용합니다. 프롬프트를 준비하고 사용자에게 보여준 후 전송할지 묻습니다.
• 사용자가 "直接发", "不用确认", "自动派发", "send directly", "no confirmation" 또는 이에 상응하는 일본어 표현을 명시적으로 말하는 경우에만 직접 전송 모드를 사용합니다.
• 요청이 모호하지만 현재 컨텍스트에서 조사할 수 있는 경우 정찰 우선 모드를 사용합니다. 실행 프롬프트를 준비하기 전에 탐색기/읽기 전용 작업을 위한 정찰 프롬프트를 준비합니다.

작업이 프로덕션 시스템, 배포, 계정, 결제, 자격 증명, 외부 API, 민감한 데이터, 법률/규정 준수 콘텐츠 또는 광범위한 다중 파일 변경에 영향을 미칠 수 있는 경우, 사용자가 일반적으로 자동화를 선호하더라도 전송 전에 항상 확인을 요구합니다.

의도 추출

최종 프롬프트를 작성하기 전에 다음을 추출합니다:

• 목표: 구체적인 결과물.
• 대상: 파일, 저장소, 제품, 문서, 텍스트, 페이지, 이슈, 데이터세트 또는 시스템.
• 출력: 구현, 보고서, 계획, 문서, 프롬프트, 테스트 결과 또는 기타 인도물.
• 제약 조건: 사용자가 명시한 요구사항, 제외 사항, 스타일, 플랫폼, 도구, 시간, 예산 또는 범위.
• 수락: 에이전트가 작업이 완료되었음을 알 수 있는 방법.
• 위험: 프로덕션, 계정, 금전, 개인정보, 보안, 규정 준수 또는 대규모 범위 영향.
• 언어: 사용자 언어, 프로젝트 언어, 고객 언어 및 최상의 실행 언어.
• 호스트: Codex, Claude Code, 호환 가능한 에이전트 호스트 또는 사용 불가/알 수 없음.
• 에이전트 유형: 탐색기, 작업자, 기본값 또는 여러 독립 에이전트.

필드가 누락되었지만 안전하게 추론할 수 있는 경우 명시적 가정으로 프롬프트에 추가합니다. 목표나 대상이 누락되었고 추론할 수 없는 경우 간결한 후속 질문을 하나 합니다.

대상 확인

현재 작업 공간에 실제 프로젝트가 포함된 것으로 보이거나 사용자가 경로, 저장소, 파일, 이슈, 문서 또는 기타 구체적인 객체를 제공하지 않는 한 "project", "this project", "current project" 또는 "项目"을 유효한 대상으로 취급하지 마십시오.

다음과 같은 프로젝트 표시기가 포함된 경우 작업 공간은 유효한 프로젝트일 가능성이 높습니다:

• .git/
• package.json, pnpm-lock.yaml, pyproject.toml, requirements.txt, go.mod, Cargo.toml, pom.xml, build.gradle, Gemfile, composer.json
• src/, app/, pages/, lib/, server/ 또는 tests/와 같은 애플리케이션 소스 디렉토리
• 사용자가 명명한 명확한 제품/문서 자산

작업 공간이 생성된 빈 디렉토리나 프로젝트 없는 디렉토리, 특히 work/, outputs/ 폴더, 스크래치 파일만 포함하거나 인식 가능한 프로젝트 표시기가 없는 경우 그 자체로 충분하지 않습니다.

대상이 누락된 경우 프롬프트를 생성하기 전에 간결한 질문을 하나 합니다:

你想让 agent 检查哪个项目？请提供项目路径、仓库、文件夹，或在目标项目 workspace 里重新打开会话。

영어 또는 일본어 컨텍스트에서는 사용자의 언어로 동일한 질문을 합니다. 대상이 확인될 때까지 정찰 또는 작업자 프롬프트를 생성하지 마십시오.

정보 충족성

다음 조건을 충족하면 요청이 실행 에이전트에 준비된 것입니다:

• 명확한 목표: 무엇을 해야 하는지.
• 작업 객체: 작업할 코드베이스, 파일, 텍스트, 제품, 페이지, 데이터세트, 이슈 또는 문제.
• 예상 출력: 코드 변경, 분석, 프롬프트, 계획, 문서, 테스트 결과, 목록 또는 기타 인도물.
• 사용자가 명시한 제약 조건 또는 선호 사항.
• 수락 신호: 작업이 완료되었는지 판단하기에 충분한 세부 정보. 없는 경우 프롬프트에 짧은 수락 기준을 정의합니다.

목표나 작업 객체가 누락되었고 현재 컨텍스트에서 추론할 수 없는 경우에만 간결한 후속 질문을 합니다.

요청이 모호하지만 조사하기에 충분한 컨텍스트가 있는 경우 많은 질문을 하는 대신 탐색기/연구 에이전트를 위한 정찰 프롬프트를 준비합니다. 정찰은 컨텍스트를 검사하고, 구체적인 작업을 식별하고, 누락된 정보와 위험을 나열하고, 실행 가능한 작업자 프롬프트를 권장해야 합니다.

에이전트 선택

• 요청이 모호하거나, 저장소/컨텍스트 검색이 필요하거나, 아직 파일을 수정해서는 안 되는 경우 explorer 또는 읽기 전용 작업을 사용합니다.
• 요청이 명확하고 코드 편집, 파일 변경, 구현 또는 수리가 필요한 경우 worker를 사용합니다.
• 작업이 명확하지만 주로 분석, 편집, 계획 중심이거나 코드 소유권 외부에 있는 경우 default를 사용합니다.
• 작업이 독립적이고 고유한 책임이 있는 경우에만 여러 에이전트로 분할합니다.
• 현재 에이전트가 더 직접적으로 완료할 수 있는 사소한 작업은 사용자가 명시적으로 위임을 원하지 않는 한 위임하지 마십시오.

작업자 프롬프트에는 항상 소유권/범위와 다음 지침을 포함합니다: "당신은 코드베이스에서 혼자가 아닙니다. 다른 사람의 편집 내용을 되돌리지 말고 근처 변경 사항에 적응하십시오."

전송 어댑터

현재 호스트의 기본 위임 메커니즘을 사용합니다. 도구 호출 또는 호스트 작업이 실제로 성공하지 않는 한 전송이 발생했다고 주장하지 마십시오.

Codex

Codex가 멀티 에이전트 도구를 노출하는 경우 확인 후 사용합니다:

• 새 탐색기, 작업자 또는 기본 에이전트의 경우 multi_agent_v1.spawn_agent.
• 관련 기존 에이전트를 계속 진행하려면 multi_agent_v1.send_input.
• 다음 단계가 결과에 의해 차단된 경우에만 multi_agent_v1.wait_agent.
• 에이전트가 더 이상 필요하지 않은 경우 multi_agent_v1.close_agent.

사용자가 요청하거나 작업이 명확히 요구하지 않는 한 모델, 추론 노력 또는 서비스 계층을 재정의하지 마십시오.

Claude Code

Claude Code가 Task/서브에이전트 메커니즘을 노출하는 경우 확인 후 사용합니다:

• 모호한 요청에는 읽기 전용/정찰 작업을 사용합니다.
• 명확한 실행 작업에는 구현 작업을 사용합니다.
• 코드 편집 작업에는 파일/모듈 소유권을 포함합니다.
• 작업에 변경된 파일, 확인 및 해결되지 않은 위험을 보고하도록 요청합니다.

호환 가능한 에이전트 호스트

다른 에이전트 호스트의 경우 전송 전에 사용 가능한 도구와 호스트 규칙을 검사합니다:

• 기본 에이전트/작업/서브에이전트/작업자 위임 도구가 노출된 경우 확인 후 사용합니다.
• 호스트가 대화형 선택을 지원하는 경우 동일한 전송/수정/중지 확인 흐름을 사용합니다.
• 호스트가 스킬 파일을 지원하지만 자동 전송을 지원하지 않는 경우 준비된 프롬프트를 제시하고 수동으로 핸드오프하는 방법을 설명합니다.
• 호스트가 알려진 프롬프트 스타일을 가지고 있는 경우 작업, 컨텍스트, 요구사항, 제약 조건, 수락 기준 및 출력 섹션을 유지하면서 형식을 조정합니다.

이 스킬에 문서화되거나 현재 환경에서 확인되지 않는 한 호스트에 대한 일급 지원을 주장하지 마십시오.

호스트가 자동 전송 도구를 노출하지 않는 경우 준비된 프롬프트를 제시하고 이 환경에서는 스킬에서 자동 전송할 수 없다고 명시합니다.

대화형 확인

현재 호스트가 기본 대화형 선택을 지원하는 경우 일반 텍스트 확인 대신 사용합니다.

일반 위험 작업에 대해 정확히 다음 선택 사항을 제공합니다:

• 전송(기본값): 준비된 프롬프트를 전송합니다.
• 수정: 무엇을 변경할지 묻고, 프롬프트를 수정한 후 확인을 다시 표시합니다.
• 전송 안 함: 프롬프트를 제공한 후 중지합니다.

안전 게이트 작업의 경우 "전송"을 기본값으로 만들지 마십시오. 안전 이유를 설명한 후 명시적인 전송 선택을 요구합니다.

기본 대화형 선택을 사용할 수 없는 경우 텍스트 폴백을 사용합니다:

准备派发给：<agent type>
派发原因：<brief reason>
风险等级：<low|medium|high and reason>
默认操作：发送

────────────────
1. 发送
   立即把上面的 prompt 发给 <agent type>

2. 修改
   说明你想改哪里，我会更新 prompt 后再次确认

3. 停止
   不发送，保留当前 prompt 供你手动使用

直接回车默认：发送
也可以回复：1 / 发送 / send / 送信

확인 선택 사항에는 사용자와 동일한 언어를 사용합니다.

숫자 및 텍스트 응답을 허용합니다:

• 1, 发送, send, 送信: 준비된 프롬프트를 전송합니다.
• 2, 修改, modify, 修正: 무엇을 변경할지 묻고, 프롬프트를 수정한 후 확인 선택 사항을 다시 표시합니다.
• 3, 停止, 不发送, stop, do not send, 送信しない: 프롬프트를 제공한 후 중지합니다.

안전 게이트 작업의 경우 다음 폴백을 대신 사용합니다:

此任务涉及高风险操作，需要明确确认。

准备派发给：<agent type>
派发原因：<brief reason>
风险等级：高，<safety reason>
默认操作：停止

────────────────
1. 发送
   明确确认后才会派发

2. 修改
   说明你想改哪里，我会更新 prompt 后再次确认

3. 停止
   不发送，保留当前 prompt 供你手动使用

直接回车默认：停止

안전 게이트가 적용되는 경우 빈 입력을 전송으로 처리하지 마십시오.

안전 게이트

준비된 작업이 다음을 수행할 수 있는 경우 전송 전에 항상 명시적 확인을 위해 일시 중지합니다:

• 프로덕션, 배포, CI/CD, 인프라, 결제, 계정, 비밀 또는 액세스 제어를 수정합니다.
• 외부 API를 호출하거나, 메시지를 보내거나, 콘텐츠를 게시하거나, 되돌릴 수 없는 작업을 트리거합니다.
• 민감한 개인, 재정, 법률, 의료, 고객 또는 자격 증명 데이터를 처리합니다.
• 많은 파일에 걸쳐 광범위하거나 모호한 변경을 수행합니다.
• 결과를 실질적으로 변경할 수 있는 가정이 필요합니다.

안전 게이트가 적용되는 경우 이유를 간략히 설명하고 프롬프트를 표시한 후 확인을 요청합니다.

사용자 대상 형식

명확한 실행 작업의 경우:

I will send this to `worker` because the request is clear and requires implementation.

**Prepared Prompt**

```text
...
```

Send it?

모호한 작업의 경우:

I will first send this to `explorer` because the request needs context scouting.

**Scout Prompt**

```text
...
```

Send it?

사용자가 변경을 요청하면 프롬프트를 수정하고 다시 표시합니다. 사용자가 전송하지 말라고 하면 준비된 프롬프트를 제공한 후 중지합니다.

참조

정찰, 작업자, 기본값, 멀티 에이전트, Codex 특화, Claude Code 특화 또는 호환 가능한 호스트 폴백 프롬프트를 준비할 때 references/prompt-templates.md를 읽으십시오.