fivetaku Insane Research Query Builder for Codex
모호한 리서치 아이디어를 구조화된 실행 가능한 리서치 쿼리로 변환한다.
먼저 읽기:
$PLUGIN_ROOT/skills/insane-research-query/references/query_schema.json
이 스킬은 사용자가 모호한 아이디어를 본격 딥리서치 전에 리서치-레디 브리프로 다듬고 싶을 때 사용한다.
질문 원칙 (shared/questioning-policy.md §A·§1·§2c)
Codex CLI에는 객관식 카드 위젯 UI가 없다. shared/questioning-policy.md §A의 채팅 번호 블록으로 대체한다. 추론 가능한 건 묻지 말고(§1), 요청이 이미 구체적이면 과잉질문 없이 바로 브리프를 생성한다(§2c). 사용자 입력 언어에 맞춰 모든 질문/선택지/산출물 언어를 일치시킨다.
Codex 워크플로우
Phase 1: Discovery (주제·타입)
주제가 불명확할 때만 한 번, §A 번호 블록으로 가장 큰 미지수만 묻는다:
어떤 유형의 리서치인가요?
1. Exploratory — 무엇이 존재하는지 탐색, 지형 매핑
2. Comparative — 기술/접근/제품 비교
3. Analytical — 원인·효과·메커니즘 심층 분석
4. Predictive — 미래 트렌드·전망·예측
(번호 또는 문장으로 답해도 됩니다)
예시를 보고 싶다는 답이 나오면 다음에서 로드해 제시한다:
$PLUGIN_ROOT/skills/insane-research-main/examples/
Phase 2: Detailed Scoping (범위·소스 품질)
핵심 주제를 잡은 뒤, 정말 모호한 제약만 §A 번호 블록으로 확인한다(추론 가능하면 기본값으로 진행):
지리적 범위는?
1. Global (추천) — 전 세계 관점
2. US/North America — 미국·북미 중심
3. Asia-Pacific — APAC 중심 (한국 포함)
4. Europe — 유럽 시장 중심
(문장으로 직접 지정해도 됩니다)
필요한 소스 품질은?
1. B - High quality (추천) — 학술 + 공식 문서 + 검증된 리포트
2. A - Academic only — 피어리뷰 논문·메타분석만
3. C - Moderate — 전문가 의견·사례 연구 포함
4. D - Broad coverage — 프리프린트·전문가 블로그까지 폭넓게
(모르면 1번으로 진행하겠습니다)
Phase 3: Query Generation (쿼리 생성)
모든 입력을 모은 뒤 생성한다:
- 구조화 JSON 쿼리 — 스키마 준수:
$PLUGIN_ROOT/skills/insane-research-query/references/query_schema.json - 사람이 읽는 리서치 브리프 — 마크다운
- 실행 체크리스트 — 품질 검증용
JSON 쿼리 구조
{
"task": {
"title": "[5-15 단어 간결한 제목]",
"objective": "[명확한 리서치 목표 진술]",
"type": "exploratory|comparative|analytical|predictive|evaluative"
},
"context": {
"background": "[왜 이 리서치가 중요한가]",
"audience": "technical|executive|academic|general|policy_maker",
"use_case": "[리서치가 어떻게 쓰일지]",
"prior_knowledge": ["가정 1", "가정 2"]
},
"questions": {
"primary": "[메인 리서치 질문]",
"secondary": ["서브 질문 1", "서브 질문 2", "서브 질문 3"],
"hypotheses": ["검증 가능한 가정 1"],
"exclusions": ["범위 밖 주제 1"]
},
"constraints": {
"timeframe": {"start": "2024-01-01", "end": "present", "focus_period": "2025-2026"},
"geography": {"scope": "global", "regions": [], "exclude_regions": []},
"sources": {"required_types": ["peer_reviewed", "industry_reports"], "min_quality": "B", "language": ["en"]}
},
"output": {
"format": "comprehensive_report",
"length": {"min_words": 3000, "max_words": 10000},
"structure": {"include_executive_summary": true, "include_bibliography": true, "generate_website": false},
"citation_style": "APA",
"tone": "professional"
},
"keywords": ["keyword1", "keyword2"],
"special_instructions": []
}
사람이 읽는 브리프
# Research Brief: [Title]
## Objective
[명확한 진술]
## Research Questions
### Primary Question
> [메인 질문]
### Secondary Questions
1. [서브 질문 1]
2. [서브 질문 2]
## Scope & Constraints
| Dimension | Specification |
|-----------|--------------|
| Timeframe | [기간] |
| Geography | [범위] |
| Min Quality | Grade [X] |
## Execution Checklist
- [ ] Primary question fully answered
- [ ] All secondary questions addressed
- [ ] Sources meet quality threshold
- [ ] Citations properly formatted
Phase 4: Confirmation and Handoff
브리프를 보여준 뒤 §A 번호 블록으로 다음 행동을 확인한다:
쿼리가 괜찮으면 바로 리서치를 시작할까요?
1. 지금 리서치 시작 (추천) — 이 쿼리로 즉시 딥리서치 실행
2. 쿼리만 저장 — JSON 쿼리를 파일로 저장해 두기
3. 쿼리 수정 — 일부 파라미터를 바꾼 뒤 진행
(번호 또는 문장으로 답해도 됩니다)
- 1 지금 시작 → JSON 쿼리를
insane-research-main스킬에 넘긴다 - 2 저장만 → JSON을 파일로 작성 (
RESEARCH/queries/{topic}_{timestamp}.json) - 3 수정 → 조정 사항을 모아 루프백
품질 검증 규칙
쿼리 확정 전 검증:
Task
- 제목이 구체적 (generic한 "AI Research" 금지)
- 목표가 측정/검증 가능
- type이 리서치 접근과 일치
Questions
- primary가 답변 가능 (너무 광범위하지 않음)
- secondary가 primary를 지지 (탈선 아님)
- exclusions가 scope creep 방지
Constraints
- timeframe이 주제에 현실적
- geography가 주제 관련성과 일치
- 소스 요건이 달성 가능
Output
- 길이가 요청 깊이와 일치
- 포맷이 독자에 적합
안티패턴
생성 금지
- 과도하게 광범위한 질문 ("What is AI?")
- 무한 timeframe ("all history")
- 충돌하는 제약 / generic 키워드 ("technology", "innovation")
- 측정 불가 목표 ("understand everything about...")
생성 권장
- 구체적·답변 가능한 질문 ("미국 병원의 AI 진단도구 현재 도입률은?")
- 현실적 범위 경계 (빠른 분야는 2~3년 timeframe)
- 구체적 성공 기준 ("시장 점유율 상위 10개 도구 식별")
- 실행 가능한 검색어 ("AI radiology FDA approved 2024 2025 adoption rate")
- 명확한 exclusions ("소비자 헬스 앱·행정 AI 제외")
언어 적응
모든 질문/선택지/산출물은 사용자 감지 언어에 맞춘다.
한국어 입력 처리
사용자가 한국어로 입력하면 (예: "헬스케어 AI 리서치 쿼리 만들어줘"):
- 모든 질문 한국어
- geography 옵션에 한국 관련 선택지
- source 옵션에 한국 리서치 DB
- 산출물에 한국어 인용 관례
다국어 키워드
최대 커버리지를 위해 사용자 언어와 영어 양쪽으로 검색 키워드 생성:
한국어 입력: "AI 의료 진단"
생성: ["AI 의료 진단 2026", "AI medical diagnostics 2026", "의료 AI 도입 현황", "clinical AI adoption"]
insane-research 연동
생성된 쿼리는 insane-research-main 스킬로 직접 들어간다:
- 쿼리 빌더가 구조화 JSON 출력
- 사용자가 confirm 또는 조정
- "지금 시작" 선택 시 JSON을
insane-research-main에 전달 - 요건이 이미 정의됐으므로 Phase 1(Question Scoping) 건너뜀
- 리서치는 Phase 2(Retrieval Planning)부터 시작
쿼리 저장 위치: RESEARCH/queries/{topic}_{timestamp}.json
Guardrails
- 질문은 §A 번호 블록으로 compact하게, 추론 가능한 건 묻지 않는다.
- 빈칸으로 두지 말고 구체적 기본값을 채운다.
- query schema를 구조화 출력의 계약으로 취급한다.
- 위젯형 프롬프트에 의존하지 말고 채팅으로 묻는다.
References
- Query schema:
$PLUGIN_ROOT/skills/insane-research-query/references/query_schema.json - Example queries:
$PLUGIN_ROOT/skills/insane-research-main/examples/