Claude Code 기반 AI 웹소설 집필 스킬팩: oh-story-claudecode 분석 및 가이드
Claude Code 기반 AI 웹소설 집필 스킬팩: oh-story-claudecode 분석 및 가이드
💡 핵심 요약 (Executive Summary)
본 분석 보고서는 오픈소스 AI 웹소설 스킬팩 프로젝트인 zenstory-ai/oh-story-claudecode의 핵심 구조와 작동 메커니즘을 다룹니다. Claude Code, Google Antigravity, Codex CLI 등 최신 코딩 어시스턴트 환경에서 구동되며, 장편 및 단편 웹소설의 '시장 분석(Scan) ➔ 구조 분해(Deconstruct) ➔ AI 어조 제거(Deslop) ➔ 상업적 집필(Write)' 전 과정을 자동화·체계화하는 전문 워크플로우 솔루션입니다.
1. oh-story-claudecode란 무엇인가?
최근 generative AI 기술이 급격히 발전함에 따라, 창작 영역에서도 단순히 프롬프트 한 줄로 글을 생성하는 단계를 넘어 '시스템화된 상업용 집필 파이프라인'을 구축하는 시도가 늘어나고 있습니다. ZenStory AI 팀이 공개한 oh-story-claudecode 프로젝트는 Claude Code 및 코딩 에이전트(Coding Agent) 환경을 활용하여 웹소설의 구상부터 분해, 집필, 검수, 보정까지의 전체 파이프라인을 지원하는 오픈소스 웹소설 스킬팩(Skill Pack)입니다.
단순 텍스트 생성이 가지는 기계적인 어조와 모호한 전개 한계를 극복하기 위해 전문 작가들의 3단계 방법론(扫榜 Scan, 拆文 Deconstruct, 商业化 Commercialize)을 프롬프트 엔진 및 에이전트 룰로 이식한 점이 가장 큰 특징입니다.
2. 핵심 워크플로우 및 파이프라인 아키텍처
oh-story-claudecode는 장편 및 단편 웹소설에 최적화된 모듈식 아키텍처를 가집니다. 작가가 아이디어를 입력하거나, 기존 흥행 작품을 입력하면(Import/Deconstruct) 이를 분석해 세계관 설정집, 인물 상태 추적 표, 챕터별 세부 플롯(Outline)을 자동 생성합니다.
프로젝트 내부에는 단순 작성이 아닌, 회차별 ‘클리프행어(Hook)’, ‘보상 밀도(Payoff Density)’, ‘기대감 관리’ 등의 상업 기법이 하드코딩된 에이전트 룰로 포함되어 있습니다.
3. 핵심 기능 13가지 스킬과 대시보드
이 스킬팩은 총 13개의 프로젝트 로컬 스킬 및 하위 에이전트를 제공합니다. 사용자는 CLI 및 인터랙티브 모드에서 자연어로 간편하게 명령을 내릴 수 있습니다.
| 주요 자연어 명령어 | 매핑 스킬 (Skill Name) | 주요 역할 및 실행 내용 |
|---|---|---|
| "글쓰기 시작 / 책 열어줘" | story-long-write |
장편 웹소설 기획 및 연재 세션 시작 |
| "AI 어조(문체) 지워줘" | story-deslop |
기계적인 중복/상투적 문체를 작가풍 자연스러운 문체로 보정 |
| "내 기존 소설 가져와줘" | story-import |
기존 출판 텍스트를 역분석하여 프로젝트 구조로 리버스 엔지니어링 |
| "작업대 열어줘" | story-dashboard |
분석 데이터, 인물 수첩, 복선 트래커를 한눈에 모니터링하는 웹 대시보드 실행 |
| "내 집필 습관 기억해줘" | story-memory |
세션 간 작가의 선호 문체, 서사 금기 사항, 특정 패턴을 영구 저장 |
4. AI 어조(Deslop) 및 퀄리티 관리 시스템
AI로 소설을 작성할 때 발생하는 대표적인 문제는 "AI 특유의 상투적 문체(Slop)"와 "감각적 주체 오용(주객 전도)" 현상입니다. 최신 v0.7.9 업데이트에서는 이러한 오류를 잡아내기 위한 강력한 검수 시스템이 도입되었습니다.
🔍 Deslop(去AI味) 검수 파이프라인
5. 멀티 클라이언트 설치 및 실행 가이드
oh-story-claudecode는 Claude Code 외에도 Google Antigravity, Codex CLI, ZCode 등 다양한 개발 환경을 지원합니다. 아래 명령어를 통해 프로젝트에 손쉽게 설치 및 배치할 수 있습니다.
1) 글로벌 패키지 설치 (npx 사용)
# 전역 환경에 스킬팩 추가 (글로벌 설치)
npx skills add zenstory-ai/oh-story-claudecode -y -g
특정 프로젝트 폴더에만 설치 시 (-g 제외)
npx skills add zenstory-ai/oh-story-claudecode -y
2) Google Antigravity 타겟 설정
# Antigravity CLI 환경에서 스티어링 셋업 실행
/story-setup target_cli=antigravity
상호작용 세션 시작 후 스킬 로딩 확인
agy -i
⚠️ 주의 사항: Windows 환경에서 Codex CLI를 사용할 때 Symlink 오류가 발생하면 git config --global core.symlinks true 설정을 켠 후 재배치해야 합니다. 또한 후크(Hooks) 정상 작동을 위해 Node.js가 PATH에 등록되어 있어야 합니다.
6. 결론 및 종합 평가
zenstory-ai/oh-story-claudecode는 단순한 프롬프트 모음집을 넘어, LLM 기반 집필 프로세스를 프로덕션 레벨로 고도화한 훌륭한 오픈소스 프레임워크입니다.
특히 E-E-A-T 관점에서 작가의 실제 모듈 라이브러리 개념을 시스템으로 구현하고, AI 특유의 헐거운 서사를 엄격히 교정하는 파이프라인을 구축했다는 점에서 웹소설 작가, 프롬프트 엔지니어, AI 웹 애플리케이션 개발자 모두에게 높은 가치를 제공합니다. AI 소설 창작의 새로운 표준을 경험해보고 싶다면 해당 스킬팩 배치를 적극 추천합니다.
댓글
댓글 쓰기