rupy1014
f66fe445bf
- Add 3 AI agents (writing, revision, story-continuity specialists) - Add 4 slash commands (rovel.create, write, complete, seed) - Add novel creation/writing rules - Add Novelpia reference data (115 works, 3328 chapters) - Add CLAUDE.md and README.md 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
179 lines
5.5 KiB
Markdown
179 lines
5.5 KiB
Markdown
# Novel Agent
|
|
|
|
AI 웹소설 창작 에이전트 - Claude Code 기반 자동 집필 시스템
|
|
|
|
## 개요
|
|
|
|
레퍼런스 웹소설을 분석하여 AI가 자동으로 새로운 작품을 기획하고 집필하는 에이전트입니다.
|
|
|
|
### 주요 기능
|
|
|
|
| 기능 | 설명 |
|
|
|------|------|
|
|
| **레퍼런스 분석** | Novelpia 크롤 데이터에서 문체/구조 분석 |
|
|
| **작품 기획** | 기획안, 아웃라인, 인물목록 자동 생성 |
|
|
| **자동 집필** | 문체.md 기반 일관된 문체로 원고 작성 |
|
|
| **자동 퇴고** | 설정/캐릭터/문체 일관성 검토 및 수정 |
|
|
| **연재 관리** | 호감도, 복선, 타임라인 자동 추적 |
|
|
|
|
## 프로젝트 구조
|
|
|
|
```
|
|
Ex2-novel-agent/
|
|
├── .claude/
|
|
│ ├── agents/ # AI 에이전트 정의
|
|
│ │ ├── writing-specialist.md # 집필 전문가
|
|
│ │ ├── revision-specialist.md # 퇴고 전문가
|
|
│ │ └── story-continuity-specialist.md # 연재 일관성 전문가
|
|
│ └── commands/ # 슬래시 명령어
|
|
│ ├── rovel.create.md # 신규 작품 생성
|
|
│ ├── rovel.write.md # 다음화 집필
|
|
│ ├── rovel.complete.md # 완결까지 연재
|
|
│ └── rovel.seed.md # 시드 데이터 생성
|
|
├── rules/ # 개발 지침
|
|
│ ├── novel-creation.md # 웹소설 창작 가이드
|
|
│ ├── novel-writer.md # 집필/퇴고 가이드
|
|
│ └── novel-character.md # 캐릭터 설정 가이드
|
|
├── content/
|
|
│ ├── references/novelpia/ # 레퍼런스 작품 (크롤 데이터)
|
|
│ └── rovel/ # 생성된 작품들
|
|
├── CLAUDE.md # Claude Code 프로젝트 설명
|
|
└── README.md
|
|
```
|
|
|
|
## 사용법
|
|
|
|
### 1. 신규 작품 생성
|
|
|
|
```
|
|
/rovel.create {레퍼런스ID} {작품명}
|
|
```
|
|
|
|
**예시:**
|
|
```
|
|
/rovel.create 383609 나만의소설
|
|
```
|
|
|
|
8단계 인터랙티브 워크플로우:
|
|
1. 레퍼런스 분석 (문체 DNA 추출)
|
|
2. 아이디어 대화 → 컨셉 도출
|
|
3. 기획안 작성 (핵심 설정)
|
|
4. 아웃라인 작성 (전체 줄거리)
|
|
5. 인물목록 작성 (캐릭터 설정)
|
|
6. 문체 설계 (문장 DNA)
|
|
7. 스토리구성 설계 (화 구성 규칙)
|
|
8. 파일 생성 및 완료
|
|
|
|
### 2. 다음화 집필
|
|
|
|
```
|
|
/rovel.write {작품명} {화수}
|
|
```
|
|
|
|
**예시:**
|
|
```
|
|
/rovel.write 나만의소설 1화
|
|
```
|
|
|
|
### 3. 완결까지 연재
|
|
|
|
```
|
|
/rovel.complete {작품명}
|
|
```
|
|
|
|
**예시:**
|
|
```
|
|
/rovel.complete 나만의소설
|
|
```
|
|
|
|
## 에이전트 설명
|
|
|
|
### writing-specialist (집필 전문가)
|
|
|
|
웹소설 원고를 작성하는 전문가입니다.
|
|
|
|
- 연재상태.md 기반 호감도/복선/타임라인 관리
|
|
- 문체.md 기반 일관된 문장 스타일
|
|
- 스토리구성.md 기반 화 구조 설계
|
|
- 호감도 단계별 말투/호칭 자동 적용
|
|
|
|
### revision-specialist (퇴고 전문가)
|
|
|
|
원고의 일관성과 품질을 검토합니다.
|
|
|
|
- 호감도/호칭 일관성 검증 (최우선)
|
|
- 캐릭터 외형/말투 일관성
|
|
- 설정/타임라인 일관성
|
|
- 문체 일관성 (금지 패턴 탐지)
|
|
|
|
### story-continuity-specialist (연재 일관성 전문가)
|
|
|
|
장기 연재 시 스토리 일관성을 검토합니다.
|
|
|
|
- 5화마다 자동 일관성 점검
|
|
- 복선 회수 상태 추적
|
|
- 캐릭터 아크 관리
|
|
- 다음 화 설계 제안
|
|
|
|
## 작품별 파일 구조
|
|
|
|
```
|
|
content/rovel/{작품명}/
|
|
├── 기획안.md # 핵심 규칙, 설정
|
|
├── 아웃라인.md # 전체 줄거리, TODO
|
|
├── 인물목록.md # 캐릭터 설정, 호감도 테이블
|
|
├── 문체.md # 문장 DNA, 금지 패턴
|
|
├── 스토리구성.md # 화 타입, 장면 구성 규칙
|
|
├── 연재상태.md # 진행 상황 (자동 갱신)
|
|
├── chapters/ # 완성 원고
|
|
│ ├── 001.md
|
|
│ ├── 002.md
|
|
│ └── ...
|
|
└── drafts/ # 초안 (퇴고 전)
|
|
```
|
|
|
|
## 화 타입 정의
|
|
|
|
| 타입 | 용도 | 구조 |
|
|
|------|------|------|
|
|
| **A** | 신규 캐릭터 첫 등장 | 도입→등장→갈등→치료→마무리 |
|
|
| **B** | 단골 캐릭터 심화 | 일상→정기치료→발견→감정진전→마무리 |
|
|
| **C** | 복수 캐릭터 등장 | A장면→전환→B장면→연결 |
|
|
| **D** | 이벤트/클라이맥스 | 긴장→사건→능력발휘→여파→새국면 |
|
|
| **E** | 상처 서사 | 도입→진맥→플래시백→현재복귀→여운 |
|
|
| **I** | 도입부 (1~2화) | 주인공/세계관 소개 |
|
|
| **P** | 프롤로그 | 티저 |
|
|
|
|
## 3화 훅 법칙
|
|
|
|
웹소설의 핵심 전략:
|
|
|
|
```
|
|
0화 (프롤로그): 티저 - 가장 임팩트 있는 장면
|
|
1화: 주인공 일상 + 세계관 자연 노출
|
|
2화: 능력 암시 + 3화 준비
|
|
3화: S급 첫 등장! (메인 히로인) ← 결제 유도 훅
|
|
```
|
|
|
|
> 독자는 보통 3화까지 무료로 읽습니다.
|
|
> 3화 끝에서 "다음이 궁금하다"를 느껴야 결제합니다.
|
|
|
|
## 레퍼런스 데이터
|
|
|
|
`content/references/novelpia/` 폴더에 Novelpia에서 크롤링한 웹소설 데이터가 포함되어 있습니다.
|
|
|
|
- **115개 작품**
|
|
- **3,328개 챕터** (마크다운 파일)
|
|
|
|
레퍼런스 ID로 문체 분석 및 새 작품 생성에 활용할 수 있습니다.
|
|
|
|
## 요구사항
|
|
|
|
- [Claude Code](https://claude.com/claude-code) CLI 설치 필요
|
|
- Claude Pro/Team 구독 권장 (긴 컨텍스트 활용)
|
|
|
|
## 라이선스
|
|
|
|
이 프로젝트의 코드는 자유롭게 사용할 수 있습니다.
|
|
레퍼런스 데이터(novelpia 크롤 데이터)는 학습/연구 목적으로만 사용하세요.
|