심층 연구 조정하기

당신의 역할

당신은 조정자 역할을 합니다. 당신의 임무는 사용자의 질문을 분석하고, 서브에이전트를 생성하며, 출력 파일을 관리하는 것입니다. 컨텍스트를 깨끗하게 유지하기 위해 직접 연구를 수행하거나 파일을 작성해서는 안 됩니다. 같은 이유로 researcher.md 또는 report-writer.md 파일을 읽지 않아야 합니다.

작업 중 할 일 목록 도구(예: TodoWrite, TaskCreate 및 TaskUpdate)가 있다면 이를 사용하여 계획과 진행 상황을 사용자에게 알리세요. 명확성을 위해 해당 항목에서 서브에이전트를 언급하지 마세요. 예를 들어 "연구 서브에이전트 생성" 대신 "연구 수행"이라고 말할 수 있습니다.

프로세스

[필요한 경우] 사용자에게 후속 질문하기
이 연구의 제목을 선택하고 디렉토리 생성하기
사용자 질문을 분해하여 서브에이전트 수 결정하기
연구 서브에이전트 생성하기(병렬로)
[정말 필요한 경우] 추가 연구 라운드 한 번 수행하기
보고서 작성 서브에이전트 생성하기
사용자에게 보고서 전달하기

1. [필요한 경우] 사용자에게 후속 질문하기

사용자의 질문을 읽고 명확히 해야 할 누락되거나 모호한 세부 사항이 있는지 고려하세요. 몇 가지 예시는 다음과 같습니다.

모호한 용어 — 약어, 전문 용어 또는 분야에 따라 여러 의미를 가진 용어
암시적인 지리적 또는 관할권 맥락 — 지역에 따라 답변이 크게 달라지지만 지역이 지정되지 않은 질문
모호한 개체 — 여러 개별 개체를 가리키는 회사명, 제품명 또는 고유 명사

사용자와 불필요한 마찰을 만들지 않기 위해, 후속 질문은 연구 수행 방식에 의미 있는 영향을 미칠 때만 해야 합니다.

후속 질문이 필요하다고 판단되면 AskUserQuestion 도구를 사용하여 질문하세요.

2. 이 연구의 제목을 선택하고 디렉토리 생성하기

먼저 이 연구의 제목을 선택하세요. 이 제목은 이 요청의 연구 노트를 보관할 폴더 이름이자 사용자가 받는 보고서의 파일 이름(보고서 제목으로 표시됨)이므로, 사용자 언어로 된 짧고 구체적인 제목을 문장 형식(첫 단어만 대문자)으로 만드세요. 3~6단어, 50자 미만(직접 세어보고 제한을 초과하면 단어를 줄이세요)으로, 문자, 숫자 및 공백만 사용하세요. 악센트 및 비라틴 문자(예: é, ñ, ü, 日本語)는 일반 ASCII로 변환하지 않고 사용자 언어가 쓰는 대로 유지하고, 하이픈, 밑줄, 아포스트로피 또는 기타 구두점을 사용하지 마세요. 예를 들어, EU AI Act가 스타트업에 미치는 영향에 대한 질문은 "EU AI Act startup obligations"를 사용할 수 있습니다.

이 연구의 폴더는 이 대화에서 이전에 연구를 수행한 디렉토리와 동일한 디렉토리에 있거나, 이 대화에서 첫 번째 연구 요청인 경우 현재 작업 디렉토리(/tmp 또는 업로드 폴더가 아님)에 있어야 합니다. 제목을 확정하기 전에 이 대화에서 이미 전달한 연구 보고서의 제목을 기억하고, 해당 디렉토리에 이미 research_notes/ 폴더가 있다면 그 내용을 나열하세요. 각 내부 폴더는 reports/에 있는 동일한 이름의 보고서 뒤에 있는 노트를 보관하며, 이전 대화의 것일 수도 있습니다. 그런 다음 적절한 경우를 선택하세요.

새 주제: 새로운 제목을 선택하세요.
이전 주제로 돌아가거나, 확장하거나 업데이트하는 경우: 주제를 여전히 명명하면서 이 요청이 추가하거나 변경하는 내용을 말하는 제목(예: "Penalties"가 아닌 "EU AI Act startup penalties")을 선택하거나, 이전 요청과 구별되는 점이 없으면 이전 제목에 다음 번호를 추가하고(먼저 단어를 하나 제거하여 위 제한을 초과하지 않도록), 예: "EU AI Act startup obligations 2". 해당 주제에 대한 가장 최근 이전 보고서의 경로와 해당 노트 폴더의 경로를 기록하세요. 이 정보를 6단계에서 보고서 작성기에 배경 자료로 전달할 것입니다. 해당 보고서나 노트 폴더가 더 이상 디스크에 없으면 남아 있는 것만 전달하고 누락된 것은 조사하세요.
사용자가 이전 연구를 독립적으로 다시 수행하도록 요청하는 경우: 이전 경우와 같이 제목을 선택하되 이전 자료는 전달하지 마세요.

모든 경우에 제목은 이 대화에서 이전에 전달된 모든 보고서와 보이는 모든 폴더와 달라야 하므로, 이 요청의 노트와 보고서가 이전 것과 혼합되거나 대체되지 않습니다. 이전 요청의 폴더를 절대 이름을 바꾸거나 이동하거나 그 안에 쓰지 마세요.

그런 다음 해당 디렉토리에 research_notes/{연구 제목}/ 및 reports/ 폴더를 만드세요. 셸 명령에서 이러한 경로를 따옴표로 묶으세요. 제목에 공백이 포함되어 있기 때문입니다. 디렉토리의 절대 경로를 기록하세요. 서브에이전트에 이 폴더의 절대 경로를 제공하고, 서브에이전트가 파일을 저장할 것입니다.

3. 사용자 질문을 분해하여 서브에이전트 수 결정하기

서브에이전트를 효과적으로 생성하고 작업을 할당하려면 사용자의 질문을 상호 배타적이면서도 완전한 하위 주제로 분해할 수 있는지 확인하세요. 그런 다음 각 하위 주제에 대해 연구에 여러 독립적인 관점이 필요한지(또는 도움이 되는지) 고려하세요.

연구자 수	분해 전략	예시
1	의미 있는 분해 불가능 — 단일 사실 질문	"2024년 슈퍼볼에서 누가 이겼나요?"
3	집중 주제에 대한 몇 가지 자연스러운 각도 또는 관점	"온도가 연어 이동에 미치는 영향" → (1) 생물학적 메커니즘, (2) 관찰된 개체군 데이터, (3) 기후 예측
4	뚜렷한 측면 또는 평가 기준	"중소기업용 CRM 플랫폼 비교" → (1) 가격 모델, (2) 기능 비교, (3) 통합 생태계, (4) 사용자 리뷰/평판
5	여러 독립적인 개체, 지역 또는 도메인	"AI 규제 환경" → (1) 미국 연방, (2) EU/GDPR-AI 법, (3) 중국, (4) 영국, (5) 산업 자율 규제
6+	체계적인 적용 범위가 필요한 대규모 열거 가능 집합	"미국 주별 전기차 보급률" → 연구자가 지역 클러스터에 할당됨

다음 단계에서는 식별된 각 하위 주제와 독립적인 관점에 대해 하나의 서브에이전트를 생성해야 합니다. 확신이 없으면 연구자 3명이 합리적인 기본값입니다. 2단계에서 구축할 이전 연구를 기록했다면 이 요청이 추가하거나 재확인이 필요한 부분만 분해하세요. 보고서 작성기는 이전 자료를 갖게 됩니다.

4. 포그라운드 연구 서브에이전트 생성하기(병렬로)

위에서 결정된 각 하위 주제 및 독립적인 관점에 대해 포그라운드 연구 서브에이전트를 생성하세요.

연구 서브에이전트를 생성하려면 subagent_type="general-purpose" 및 run_in_background=false로 Agent 도구(일부 버전에서는 Task라고 함)를 사용하세요. 각 연구 서브에이전트에 매우 명확하고 구체적인 지침을 제공해야 합니다. 원래 질문의 제약 조건(예: 시간적, 지리적)을 연구 서브에이전트에 전파해야 합니다. 아래 프롬프트에서 {path_to_skill}를 이 스킬의 기본 디렉토리(이 SKILL.md가 로드된 디렉토리), {absolute path of your working directory}를 2단계에서 기록한 경로, {research title}를 2단계에서 선택한 제목으로 바꾸세요. 아래에 제공된 정확한 형식을 따르세요.

Agent(
  run_in_background=false
  subagent_type="general-purpose",
  description="{3-5단어}",
  prompt="{구체적인 좁은 주제} 조사.

목표: {원하는 출력에서 다루는 내용에 대한 명확한 설명}

핵심 질문:
- {구체적인 질문 1}
- {구체적인 질문 2}

권장 출처:
- {우선시할 출처 유형}

제약 조건:
- {초기 사용자 질문의 모든 범위(시간적 또는 지리적 포함)}

출력 노트를 {absolute path of your working directory}/research_notes/{research title}/{topic}.md에 저장하세요.

**첫 번째 단계로, 연구 수행 방법에 대한 지침을 위해 {path_to_skill}/references/researcher.md를 읽어야 합니다.**"
)

연구 서브에이전트에 대한 명확하고 상세한 프롬프트의 좋은 예:

반도체 공급망 위기와 2026년 현재 상태를 조사합니다.

목표: 현재 상황, 진행 중인 솔루션 및 미래 전망을 다루고, 가능한 경우 특정 일정과 정량적 데이터를 포함한 밀도 있는 사실 보고서를 작성합니다.

핵심 질문:

현재 병목 현상은 무엇입니까?

새로운 팹 건설로 인한 예상 용량 증가는 무엇입니까?

공급망에 영향을 미치는 지정학적 요인은 무엇입니까?

전문가들은 공급이 수요를 충족할 시기를 언제로 예측합니까?

권장 출처:

투자자 관계 페이지 또는 SEC EDGAR 데이터베이스에서 찾을 수 있는 TSMC, Samsung, Intel과 같은 주요 칩 제조업체의 최근 분기별 보고서

시장 분석 및 예측을 제공하는 SEMI, Gartner 및 IDC의 산업 보고서

상무부의 US CHIPS Act 이행 진행 상황, ec.europa.eu의 EU Chips Act, 일본, 한국, 대만의 유사한 이니셔티브를 포함한 정부 대응(각 정부 포털을 통해)

제약 조건:

2026년 현재 상태를 반영해야 하며, 이전 문제는 그렇다고 명확히 표시해야 합니다.

출력 노트를 {absolute path of your working directory}/research_notes/Semiconductor supply chain outlook 2026/semiconductor_supply_chain.md에 저장하세요.

첫 번째 단계로, 연구 수행 방법에 대한 지침을 위해 {path_to_skill}/references/researcher.md를 읽어야 합니다."

연구가 가능한 한 빨리 수행되도록 하려면 모든 서브에이전트가 병렬로 생성되어야 합니다. 즉, 단일 턴에서 Agent 도구에 대한 모든 호출을 수행해야 합니다.

5. [정말 필요한 경우] 추가 연구 라운드 한 번 수행하기

연구 서브에이전트가 반환한 작업 요약을 기반으로 보고서를 불완전하게 만드는 중요한 격차가 있는지 판단하세요. 정말 필요하다고 판단되면 해당 격차를 메우기 위해 병렬로 연구자를 생성하세요. 이 단계에서 추가 연구자를 생성하면 사용자에게 보고서 전달이 지연되어 훨씬 더 나쁜 경험을 초래하므로 극도로 주의해서 사용해야 합니다.

이 단계는 한 번만 수행할 수 있습니다. 연구자가 완료된 후, 어떤 결과를 받든 관계없이 즉시 6단계로 이동하세요. 추가 연구를 시작하면 시간 초과 또는 속도 제한에 도달하여 사용자가 질문에 대한 답변을 받지 못할 수 있습니다. 이를 기억하기 위해 추가 연구를 시작하기로 선택할 때 항상 "이 연구자들이 완료되면 보고서 작성기 조정으로 직접 이동하겠습니다"라고 출력해야 합니다.

6. 포그라운드 보고서 작성 서브에이전트 생성하기

연구가 완료된 후 단일 보고서 작성 서브에이전트를 생성하세요. subagent_type="general-purpose" 및 run_in_background=false로 Agent 도구(일부 버전에서는 Task라고 함)를 사용하고 4단계와 같이 자리 표시자를 채우세요. {the user's original question}의 경우 이 보고서가 완전히 답변해야 하는 질문을 명시하세요. 이 요청이 이전 연구로 돌아가거나 확장하는 경우, 이전 질문을 이 요청으로 수정한 것입니다(예: "EU AI Act가 스타트업에 미치는 영향(처벌 포함)"). 이전 연구 줄에는 2단계에서 기록한 이전 보고서 및 노트 폴더의 절대 경로를 제공하거나, 구축할 내용이 없거나 사용자가 독립적인 재작성을 요청한 경우 "none"을 작성하세요. 아래에 제공된 정확한 형식을 따르세요.

Agent(
  run_in_background=false
  subagent_type="general-purpose",
  description="최종 보고서 작성",
  prompt="{absolute path of your working directory}/research_notes/{research title}/의 노트를 읽고 다음 질문에 답하는 연구 보고서로 종합하세요: {the user's original question}.

이 대화에서 구축할 이전 연구: {2단계의 이전 보고서 및 노트 폴더의 절대 경로 또는 "none"}

최종 보고서를 다음 정확한 경로에 저장하세요: {absolute path of your working directory}/reports/{research title}.md

**첫 번째 단계로, 연구 보고서 작성 방법에 대한 지침을 위해 {path_to_skill}/references/report-writer.md를 읽어야 합니다.**"
)

7. 사용자에게 보고서 전달하기

보고서 작성기가 완료된 후 보고서를 사용자가 사용할 수 있도록 만드세요. 사용자에게 파일을 보내는 도구(예: SendUserFile)가 있으면 reports/{research title}.md를 보내고, 그렇지 않고 환경에 사용자에게 보이는 outputs 폴더가 있으면 보고서를 동일한 파일 이름으로 해당 폴더에 복사하고, 그렇지 않으면 reports/{research title}.md에 남겨두세요. 그런 다음 최종 보고서를 읽고 사용자에게 전체 보고서의 위치(사용자에게 전송됨, outputs 폴더에 있음 또는 절대 경로)를 알리는 간단한 요약(3~5문장 목표)을 보내세요.

ashley-seymour/claude-skills

claude-skills란 무엇인가요?

즐겨 사용하는 AI에게 물어보기

문서