zenstory-ai/oh-story-claudecode

Claude Code / Codex / OpenCode agent skills for writing Chinese web novels (网文): 扫榜、拆文、写作、去AI味、封面全流程，长篇短篇都支持 | 13 skills for novel writing and long-form fiction with file-based continuity tracking. MIT.

Oh Story – AI 지원 웹소설 작성 스킬 팩

이것이 무엇인가 – 프로그래밍 에이전트(Claude Code, Codex CLI, Google Antigravity, OpenCode, ZCode, OpenClaw, Reasonix 등)를 풀스택 소설 작성 어시스턴트로 바꿔주는 13개의 "스킬" 모음입니다. 이 패키지는 중국어 웹소설의 전체 파이프라인을 처리합니다:

스캔榜 – 시장 순위를 스크래핑하여 수익성 있는 주제를 선택합니다.
분해문 – 베스트셀러 작품을 재사용 가능한 플롯 모듈로 분해합니다.
작성 – 개요, 상세 챕터 계획 및 산문 자체를 생성합니다.
AI 냄새 제거 – 출력을 검사하여 전형적인 AI 표현을 제거합니다.
표지 – 내장 이미지 모델을 사용하여 표지 이미지를 생성합니다.

이 모든 것은 에이전트가 이미 사용 중인 모델에서 실행됩니다. GPU나 추가 모델 배포가 필요 없습니다. 유일한 추가 계산은 결정적 검사를 실행하고 프로젝트 파일을 관리하는 로컬 Node/Python 스크립트 세트입니다.

빠른 시작 / 설치

# 전역 설치 (어느 폴더에서나 사용 가능)
npx skills add zenstory-ai/oh-story-claudecode -y -g
# 또는 현재 프로젝트에 로컬 설치
npx skills add zenstory-ai/oh-story-claudecode -y

스킬이 추가된 후, 작성 프로젝트의 루트에서 부트스트랩 명령을 실행합니다:

/story-setup   # 또는 Codex에서는 $story-setup

이렇게 하면 필요한 디렉토리 구조(설정/, 대강/, 본문/, 추적/ …)가 생성되고 7개의 전문 에이전트와 8개의 자동화 훅이 등록됩니다.

핵심 워크플로우 (간소화된 mermaid 다이어그램)

flowchart LR
  A[Setup] --> B[스캔榜]
  B --> C[분해문]
  C --> D[작성]
  D --> E[AI 냄새 제거]
  E --> F[표지]

장편 소설은 스캔榜 → 분해문 → 장편 작성 경로를 따릅니다. 단편 작품은 유사한 단편 단계를 사용합니다.

주요 명령 (스킬)

스킬	트리거	기능
`story-setup`	`/story-setup` 또는 `$story-setup`	현재 프로젝트에 에이전트, 훅 및 파일 구조를 배포합니다
`story-long-write`	`/story-long-write`	장편 소설의 개요, 캐릭터 시트 및 챕터 산문을 생성합니다
`story-short-write`	`/story-short-write`	단편 프로젝트용으로 위와 동일
`story-deslop`	`/story-deslop`	알려진 AI 스타일 문장 패턴, 구두점 문제 및 진부한 표현을 제거하는 린트 패스
`story-cover`	`/story-cover`	GPT-Image-2 모델(또는 폴백 API)을 호출하여 제목/장르에 기반한 표지 이미지를 생성합니다
`story-long-analyze` / `story-short-analyze`	`/story-long-analyze` / `/story-short-analyze`	참조 작품을 플롯 모듈로 분해하고, 페이스, 훅 등을 점수화합니다
`story-import`	`/story-import`	기존 원고를 표준 프로젝트 구조로 변환하여 계속 작업합니다
`story-dashboard`	`/story dashboard`	로컬 웹 UI(127.0.0.1)를 시작하여 파일 트리 탐색, 데모 보기, Markdown 편집 및 명령 실행

장편 일관성을 유지하는 방법

파일 시스템 메모리 – 모든 설정, 개요, 챕터 초안 및 JSON "추적 상태"가 디스크에 저장됩니다. 에이전트는 현재 챕터에 필요한 작은 조각만 읽어 컨텍스트 오버플로를 방지합니다.
가드 훅 – guard-outline-before-prose.sh는 해당 챕터의 상세 개요가 존재할 때까지 산문 생성을 차단합니다.
일관성 검사기 – 산문이 작성된 후 consistency-checker 에이전트가 복선 플롯 포인트, 캐릭터 상태 및 "작가의 진실 vs. 독자가 아는 것" 타임라인이 일치하는지 검증합니다.
결정적 훅 – 7개의 에이전트(아키텍트, 작가, 일관성, 캐릭터 디자이너, 리서처, 탐험가, 추출기)와 8개의 훅이 확률적 놀라움 없이 품질을 보장합니다.

출력 예시 (발췌)

## 현재 챕터
- 제21장 – 장면: 로켓군 문공단 사무실

## 활성 복선
- F054｜탄수의가 이웃 도시 주소를 주었고, 강신은 다음 날 이야기를 들으러 가기로 함｜제20장에서 매설｜제22장에서 회수｜높음
- F057｜탄수의에게는 50년 동안 아무도 끝까지 듣지 못한 이야기가 있으며, 내용은 밝혀지지 않음｜제21장에서 매설｜제22장에서 회수｜높음

데모 폴더에는 전체 길이 소설 파일, 고전 《반룡》의 분해 보고서 및 생성된 표지 이미지가 포함되어 있습니다.

사용 시기

이미 Claude Code 또는 유사한 코딩 에이전트를 사용 중이며, 별도의 LLM 서버를 시작하지 않고 소설 작성 기능을 추가하려는 경우.
컨텍스트 크기가 병목인 장편 연재 웹소설(수만 단어)에 대해 결정적이고 반복 가능한 출력이 필요한 경우.
게시 전에 산문을 더 인간적으로 느끼게 하기 위해 자동화된 "AI 냄새 제거" 단계를 원하는 경우.

제한 사항 / 주의 사항

표지 생성기는 GPT-Image-2 모델에 의존합니다. 에이전트가 액세스할 수 없으면 외부 API 키가 필요합니다.
모든 검사는 로컬 스크립트입니다. 외부 AI 탐지기(예: 주작)가 텍스트를 인간이 작성한 것으로 표시할 것이라고 보장하지는 않지만, 전형적인 AI 표현을 크게 줄입니다.
이 스킬 세트는 ClawHub 배포 메커니즘에 연결되어 있습니다. npx skills … 또는 자연어 설치 명령을 통해 설치해야 합니다.

커뮤니티 및 지원

Telegram 그룹: https://t.me/ohstoryclaudecode
GitHub Discussions 및 Issues는 문제 해결, 기능 요청 및 출력 예제 공유에 사용합니다.
일반적인 pull request 워크플로를 통해 새로운 스킬, 시장 데이터 업데이트 또는 추가 지식 베이스 항목을 기여할 수 있습니다.

TL;DR

Oh Story는 코딩 에이전트를 턴키 방식의 중국어 웹소설 작가로 바꿉니다: 시장 트렌드 스크래핑, 베스트셀러 분해, 개요 구축, 챕터 작성, AI 스타일 산문 제거, 표지 생성까지 추가 GPU 없이 수행합니다. npx skills add …로 설치하고, /story-setup을 실행하고, /story-long-write 또는 /story-short-write 명령을 시작하세요.