agentleFS
parkjui92parkjui92/socsci-paper-kit/skills/paper-research/SKILL.md

paper-research

Skill5 starsChanged 48 days agoMITView on GitHub

사회과학 논문의 근거를 마련하는 리서치 스킬. RQ·이론틀에 따라 선행연구(체계적 문헌고찰), 이론·개념의 학술적 출처, 정부·공식 통계, 국내외 사례를 외부 웹과 사용자 자료에서 조사하고 모든 사실에 출처를 병기한다. 논문의 이론적 배경·선행연구 근거를 수집하거나 학술 통계·선행연구·이론출처·사례를 조사할 때 사용. 일반 웹검색이 아닌 학술 근거 수집 목적에 적용.

  • Reads credentials

5 other projects use a version of this.

Adopted by

Most recently taken up by

The file

Files
SKILL.md

사회과학 논문 근거조사

집필자가 쓸 모든 주장에 출처를 붙일 수 있도록 학술 근거를 조사한다. 산출물은 _workspace/03_literature.md. 핵심 원칙은 출처 없는 사실은 쓰지 않는다.

체계적 문헌 검색 (SLR)

  1. 검색원 선정 — Google Scholar, KCI, RISS, DBpia, Semantic Scholar, JSTOR, Web of Science 등. 한국 주제는 KCI·RISS·DBpia, 국제 비교는 영문 DB를 함께.
  2. 검색어 설계 — RQ의 핵심 개념을 키워드로 분해하고, 동의어·영문 대응어를 조합한다(AND/OR).
  3. 포함·배제 기준 — 연도·언어·동료심사 여부·관련성으로 거른다.
  4. 검색 기록(재현성) — "어떤 DB에서 어떤 검색어로 몇 건 중 몇 건 선정"을 기록한다.

해외 문헌·사례는 지역·언어 현지화

영문·해외 문헌과 국제 비교 사례는 대상국 언어로 검색한다. 학술 DB(Scholar·JSTOR·Web of Science 등)는 그대로 쓰되, 일반 웹에서 현지 로케일 검색이 필요하면 geo-search 래퍼: 이 스킬에 내장된 래퍼 python3 <이 스킬 디렉토리>/scripts/geo_search.py -c us "English query" (프리셋: us jp kr gb de fr cn tw sg). 기본 WebSearch는 US 고정임에 유의. 키(SERPER_API_KEY/SERPAPI_KEY) 미설정 시 WebSearch 영문 쿼리로 폴백. 상세: 이 스킬의 scripts/geo-search-README.md.

출처 등급 (Tier)

Tier유형신뢰도
1동료심사 학술지 논문, 1차 데이터·정부 공식 통계최상
2학술 단행본, 학위논문, 국제기구 보고서상
3정부·공공기관 보고서, 워킹페이퍼중상
4전문 언론·기관 발표중
5블로그·위키·생성형 AI 요약낮음(인용 회피, 1차 출처로 추적)

약탈적(predatory) 저널·미검증 출처를 경계하고, 의심 출처는 등급과 함께 플래그한다.

분석카드 스키마

핵심 선행연구마다 카드를 만든다:

- 저자(연도): 제목 / 출처
- 이론틀: ...
- 방법: (양적/질적/혼합, 표본·자료)
- 핵심 발견: ...
- 한계: ...
- 본 연구와의 관련: (지지/반박/공백)
- 인용 가능 구절·수치: (페이지 포함)

근거 위치는 빠뜨리지 않는다. 집필자가 인용마다 <!--loc:…-->로 출처 속 위치를 달고, 검토관이 그 위치를 열어 주장과 맞춰 본다. 그래서 "인용 가능 구절·수치"에는 쪽(p.45)·절·표 번호나 25단어 이하의 원문 인용구를 함께 적는다. 원문을 직접 열지 못하고 초록·2차 자료로만 확인했다면 위치 미확인(초록 기준)으로 적는다. 위치를 지어내지 않는다.

주제 × 방법 매트릭스

선행연구를 주제(행)와 방법/이론(열)으로 배열해, 연구 흐름과 빈칸(공백)을 한눈에 보이게 한다.

이론·개념 출처

설계자가 택한 이론틀의 원전·핵심 학자·후속 논의를 찾는다. 재인용이 아닌 1차 출처를 우선하고, 개념의 조작적 정의에 쓸 인용 구절을 확보한다.

통계·2차 자료

정부 통계·공식 지표·기존 데이터셋을 **출처 정보(기관·조사명·연도·표본·접근 URL)**와 함께 확보한다. 수치는 반드시 원 출처를 확인하고, 인용 시 연도·단위·정의를 함께 적는다.

갭분석

선행연구가 답하지 못한 지점을 짚고, **본 연구의 기여(contribution)**가 놓일 자리를 한 문단으로 진술한다(이론적 공백 / 방법적 공백 / 맥락적 공백).

참고문헌 (APA7)

확보한 출처를 APA7 형식으로 정리한다. 본문 인용과 1:1 대응이 가능하도록 저자·연도·제목·출처·DOI/URL을 빠짐없이 적는다.

출력 구조 (03_literature.md)

  1. 검색 기록 (DB·검색어·선정 건수)
  2. 선행연구 종합 (분석카드 + 주제×방법 매트릭스)
  3. 이론·개념 출처
  4. 통계·2차 자료 (출처 정보 포함)
  5. 국내외 사례 (필요시)
  6. 갭분석·기여
  7. 참고문헌 후보 (APA7)

미확보 항목은 "[미확보]"로 명시한다.

주의

  • 출처 없는 사실, 확인 안 된 수치를 쓰지 않는다. 의심되면 1차 출처로 추적하거나 플래그한다.
  • 상충하는 선행연구 결과는 삭제하지 말고 양쪽을 출처와 함께 병기한다.
  • 조사·정리만 한다(READ-ONLY). 본문 집필·데이터 분석은 다른 에이전트의 몫이다.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.