tizzy916/humanities-writing-companion

End-to-end humanities writing assistant — an Agent Skill (open SKILL.md format). 11 modes from Socratic research-question sharpening through AI-use disclosure. Bilingual (EN/中文), discipline-aware (literature/history/philosophy/art/religion/linguistics + cross-disciplinary). Four-layer critique, calibratable devils advocate, voice preservation.

개요

Humanities Writing Companion은 오픈 SKILL.md 형식으로 작성된 Agent Skill(플러그인)입니다. Claude Code, Claude Agent SDK 또는 이 형식을 지원하는 모든 AI 에이전트 플랫폼에서 실행할 수 있습니다. 인문학 연구자를 위한 가상 '사고 파트너'로서, 연구 질문 구체화부터 저널 제출용 AI 사용 공개문 생성까지 장문 논증 논문의 모든 단계를 안내합니다.

대상 사용자

이 기술은 산문 중심의 논증을 주된 결과물로 하는 연구자(역사학자, 철학자, 문학 비평가, 미술사학자, 종교학자, 고전학자, 문화 연구자 및 관련 학제간 분야 연구자)를 대상으로 합니다. 이는 단순한 문법 검사기나 인용 관리 도구가 아닙니다. 개인의 문체 유지, 산문을 통한 논증, 그리고 대항적 동료 심사라는 학문적 가치를 중심으로 구축되었습니다.

핵심 기능(12가지 모드)

단계	모드	기능
집필 전	H – 연구 질문 구체화	모호한 관심을 날카롭고 집필 가능한 질문으로 바꾸는 소크라테스식 대화.
	I – 문헌 매핑	기존 읽기 자료를 진영과 논쟁별로 정리(자동 문헌 검색 없음).
	J – 계획 전용 개요	산문을 작성하지 않고 학문 분야를 인식한 논문 구조 생성.
초안 작성	C – 구상 → 새 콘텐츠	저자의 문체 프로필을 따라 새로운 섹션을 공동 집필.
	A – 문단 수준 대화	문체적 특징을 유지하면서 단일 문단을 대화식으로 편집.
검토	B – 챕터 수준 검토	4단계 비평(기초, 구조, 문단, 문장) 및 우선순위 기반 피드백.
	D – 악마의 대변인	3가지 심사위원 유형(이론, 역사, 방법론)과 친절한 독자를 시뮬레이션(강도 조절 가능).
수정	E – 집필 병목 지원	저자가 막혔을 때 돌파 전략 제안.
	F – 초안 수정	병렬 차이 비교, AI 특유의 상투적 표현 체크, '수정 코치' 서브 모드.
제출 전	G – 블라인드 리딩	익명 독자를 위한 숨겨진 가정 및 가독성 체크.
	K – AI 사용 공개	AI 기여도를 감사하고 저널 제출용 공개문 생성.
검토 후	L – 수정 워크플로우	심사위원 의견을 구조화된 문서로 정리하고 통합 상태 추적.

지원 도구

저장소에는 scripts/ 폴더(zsh + Python 3, 외부 패키지 없음)가 포함되어 있으며 다음을 제공합니다:

ai‑trace‑scan.sh – AI 생성 상투적 표현 및 반복적인 전환어 플래그 지정.
pending‑checks.sh – 모든 [VERIFY] / [待核对] 마커를 집계하여 최종 정리 지원.
citation‑consistency.py – 인용 스타일 일관성 검증(Chicago, MLA, APA, GB/T 7714).
citation‑format‑convert.py – 지원되는 스타일 간 BibTeX 파일 변환.
citation‑verify.py – 서지 정보의 Crossref/OpenAlex 메타데이터 조회(주장 검증 없음).

설치 방법

# Claude Code 스킬로 설치
git clone https://github.com/tizzy916/humanities-writing-companion.git \
  ~/.claude/skills/humanities-writing-companion
chmod +x ~/.claude/skills/humanities-writing-companion/scripts/*.sh

또는 프로젝트 로컬의 .claude/skills/ 폴더에 복제하여 단일 저장소용으로 사용할 수 있습니다.

중요성

대부분의 AI 글쓰기 도구는 인문학 논문을 일반 텍스트처럼 취급하여 문법을 수정하거나 인용을 제안하고 '표준 학술 영어'로 다시 씁니다. 이 기술은 일반 도구가 간과하는 인문학 특유의 세 가지 우선순위를 인식합니다:

문체 유지 – 저자의 수사적 입장은 논증의 일부입니다.
논증과 산문의 불가분성 – 약한 문장은 무효한 논증입니다.
대항적 동료 심사 – 제출 전 학자들이 직면하는 엄격하고 방법론적인 비판을 시뮬레이션합니다. 학문 분야를 인식한 비평 전략, 버전 관리 스타일의 수정 로그, 명시적인 AI 흔적 체크리스트를 통합함으로써, 이 Companion은 연구자가 방어 가능하고 투명하며 개인적으로 진정성 있는 원고를 작성하도록 돕습니다.

인용 출판물에서 이 기술을 사용하는 경우 Zenodo DOI: 10.5281/zenodo.20280772를 인용하십시오.