TL;DR

이 레포는 장편과 단편 웹소설 제작을 위해 13개의 스킬과 7개의 전문 에이전트로 구성된 통합 파이프라인을 제공하며 설치 명령과 /story-setup으로 플랫폼별 후크 및 에이전트를 배치해 프로젝트 루트에 대纲·설정·본문·추적 파일 구조를 자동으로 생성한다. 에이전트는 분해된 문체·감정 모듈과 대조용 자료를 생성하고 narrative-writer가 초안 생성과 탈AI화 절차를 수행하며 consistency-checker가 사실 충돌과伏笔 상태를 점검해 연재 장기 관리에 필요한 연속성을 유지한다. ZCode·Reasonix 등 다수 플랫폼 네이티브 호환을 제공해 기존 플랫폼에 통합하기 쉬우며 데모와 샘플 출력물을 통해 분해·생성·표지 산출 흐름을 검증할 수 있다. 다만 플랫폼별 권한·심볼릭 링크·후크 동작 차이로 인해 설치 후 /story-setup 재실행과 새 세션 열기가 필요하며 최종 편집과 품질 판단은 인간 검토가 전제되어야 한다.

주요 기능

• 수집한다. 인기 플랫폼의 랭킹과 작품 메타를 자동으로 수집해 플랫폼별 트렌드와 제목·장르 특성을 구조화된 참고 데이터로 유지한다. 수집 결과는 skills의 scan 계열에서 대조 기준으로 사용되어 대본·대상 작품을 자동으로 불러온다.
• 분해한다. 입력된 원문이나 대상 작품을 챕터 단위로 분해해 요약·정리·정형 메타를 생성하고 문체·리듬·감정 모듈을 추출한다. 분해 산출물은 프로젝트 내 대조용 디렉터리(拆文库/대조/{책명})로 저장되어 이후 작성이 대조 문체를 따르도록 참조된다.
• 생성한다. 대본·대상 문체·주제 카드를 바탕으로 일별 집필, 장별 작성, 단편 작성 템플릿을 호출해 초안과 챕터를 자동으로 생성하며 story-cover 스킬로 표지 생성도 지원한다. 생성 과정에서 주제 카드와 대纲 경계가 본문에 직접 삽입되지 않도록 분리해 출력 본문과 보조 자산을 구별한다.
• 검출하고 제거한다. 특유의 ‘去AI味’ 규칙에 따라 확정적 독립 문장 패턴을 검사해 블로킹 규칙 적용과 선택적 건너뛰기 주석(<!-- 去味:跳过 -->)을 통해 자동 정제를 수행한다. 로컬 검사 외에 외부 도구를 참조해 보조 검증을 수행하지만 최종 판단은 인간 편집자가 하도록 설계되었다.
• 정리한다. /story-setup 실행 시 프로젝트 루트에 대纲·设定·正文·追踪 등 파일 구조를 생성하고 후크를 설치해 세션 로그, 압축 전후 스냅샷 및 대纲 검증을 자동으로 기록한다. 이 구조는 장기 연재에서의 연속성 관리와伏笔 추적을 파일시스템 기반으로 분리해 유지하도록 만든다.

어떻게 동작하는가

레포는 13개 스킬과 7개 전문 에이전트를 조합해 단계별 파이프라인을 구현하며 /story-setup 명령으로 플랫폼별 경로에 스킬과 후크를 배치해 자동 등록한다. 에이전트들은 references 디렉터리의 방법론 자료를 on-demand로 로드하고 프로젝트 파일을 읽어 분해 보고서, 문체 카드, 대纲 파일을 생성하거나 본문을 작성·정제하는 작업을 병렬로 수행한다.

해결 문제

장편·단편 웹소설 제작에서 발생하는 랭킹 조사·대상 작품 분해·대纲·연속성 관리·AI 특유 문장 제거·표지 생성 같은 반복적이고 프로젝트 단위의 작업을 통합해 자동화한다. 파일시스템 기반의 프로젝트 템플릿과 후크를 통해 장기 연재에서 흔한 설정보다 기억 의존으로 발생하는 충돌과伏笔 단절 문제를 예방하고 복구 가능한 상태를 유지한다.

지금 주목받는 이유

레포는 웹소설·연재 중심의 상용 플랫폼 트렌드와 창작 자동화 수요를 겨냥해 스킬 단위로 통합된 툴체인을 제공하며 다중 플랫폼 적응을 통해 사용자가 기존 에코시스템에 쉽게 연결할 수 있도록 설계되었다. 최근 버전에서 ZCode와 Reasonix에 대한 네이티브 호환이 추가되어 호환성 범위를 넓혔고 여러 플랫폼에서의 설치 방식과 후크 관리 개선이 릴리스 노트에 반복적으로 명시되어 있다. 이러한 확장성은 기존 단일 플랫폼 스킬보다 채택 장벽을 낮추는 요인으로 작용한다.

차별점

• 플랫폼 통합과 배포 호환성을 제공한다. Claude Code, OpenCode, ZCode, OpenClaw, Codex, Reasonix 등 다수 플랫폼의 스킬·플러그인 경로에 맞춘 배포 로직을 포함해 별도 포팅 없이 각 플랫폼의 discovery 메커니즘으로 자동 등록되도록 설계되었다. 플랫폼별 제한 기능은 fallback 모드로 안전하게 처리한다.
• 프로젝트 파일 중심 워크플로를 채택했다. 각 책은 설정·대纲·正文·追踪 등 파일 단위로 분리되어 에이전트와 스킬이 생성한 구조화 자산을 직접 소비하고 갱신하며, 이 방식은 대화 기반 세션 메모리보다 장기 연재 연속성 관리에 유리하다. 결과물은 저장 가능한 에셋으로 남아 수동 편집과 버전 관리가 가능하다.
• 전문화된 에이전트 분업을 적용했다. story-architect, narrative-writer, consistency-checker 등 역할별 에이전트를 두어 기획·문체·사실검증·요약 등 각 단계에서 전담 처리하고 references를 통해 방법론을 불러와 일관된 규칙으로 출력물이 생성되도록 했다. 이 구조는 복잡한 장편 연재에서 모듈화된 책임 분산을 가능하게 만든다.

사용 사례

• 신규 장편 연재 프로젝트의 초기 설정과 구조화를 자동화한다. /story-setup으로 프로젝트 폴더와 후크를 배치하고 대纲/设定 템플릿을 생성해 초반 작업 시간을 단축하며 에이전트가 생성한 분해 자료를 대조 참조 자료로 활용해 첫 권·첫 장 구성의 일관성을 확보한다.
• 기존 출간 작품을 역으로 불러와 연속성 있는 연재용 작업 공간으로 전환한다. /story-import는 이미 공개된 앞장들을 추출해 대纲·장별 요약·角色卡 등을 생성해 다음 장을 이어 쓰기 위한 구조화된 프로젝트로 전환하므로 연재중인 작품의 무결성 유지와 빠른 재개가 가능하다.
• 단편 제작과 제출 수준의 교정·포맷 작업을 수행한다. short-write·short-craft 계열 스킬은 플랫폼별 제출 포맷과 유료 포인트 설계에 맞춘 단편 편집 템플릿과 커버 생성 기능을 제공해 단편 공모·플랫폼 제출용 산출물을 준비한다.

시작하기

레포는 플랫폼 통합을 전제로 하므로 먼저 대상 플랫폼에서 스킬을 수용하는지 확인하고 글로벌 설치가 필요하면 npx skills add worldwonderer/oh-story-claudecode -y -g 명령을 실행해 설치한다. 설치 후에는 프로젝트 루트에서 /story-setup을 실행해 후크와 에이전트 매니페스트를 배치하고 새 회차 세션을 열어 에이전트 등록 상태를 확인한다. 플랫폼별로 설치·권한·symlink 정책이 다르므로 README의 플랫폼별 안내를 따라 추가 설정을 적용해야 한다.

요구사항

• Node.js 런타임과 쉘 환경이 필요하다. README에 플랫폼 hook과 일부 스크립트가 PATH의 node를 요구한다고 명시되어 있으므로 node가 설치된 환경에서 정상 동작한다.
• 플랫폼별 스킬/플러그인 설치 경로 접근 권한과 심볼릭 링크 설정이 필요할 수 있다. Codex의 경우 .agents/skills 스캔을, ZCode는 marketplace 등록을 사용하며 Windows에서는 core.symlinks=true 설정 또는 대체 설치 방식을 따라야 한다.
• 외부 검증 도구는 선택적 의존성으로 취급된다. 예를 들어 去AI味 검증 과정에서 추천된 외부 도구를 참조할 수 있으나 최종 판정은 수동 편집을 권장하므로 필수 런타임으로 강제되지 않는다.