Clauders/Ex2-novel-agent
13
0
Fork 1
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Initial commit: Novel Agent setup

Browse Source 
- 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>
This commit is contained in:
rupy1014
2025-12-14 21:31:57 +09:00
commit f66fe445bf
3341 changed files with 1271187 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

434
.claude/commands/rovel.complete.md Normal file
View File

@@ -0,0 +1,434 @@
---
description: 웹소설 완결까지 연재 - 현재 화수부터 마감 회차까지 자동 연재 (집필+퇴고 반복)
---
## User Input
```text
$ARGUMENTS
```
User input **must** be considered (if not empty).
## Overview
`/rovel.complete`는 작품을 마감 회차까지 자동으로 연재합니다.
**Examples:**
- `/rovel.complete 협회 소속 양호선생님` - 150화까지 연재
- `/rovel.complete 협회 소속 양호선생님 10` - 현재부터 10화만 연재
- `/rovel.complete 협회 소속 양호선생님 30화까지` - 30화까지 연재
**This is a Multi-Agent Loop Workflow**:
```
┌───────────────────────────────────────────────────────────────┐
│ 초기화 Phase │
│ - 아웃라인.md에서 마감 회차 확인 │
│ - 연재상태.md에서 현재 진행 상황 확인 │
│ - 연재 범위 결정 (현재 화수 → 마감 회차) │
└───────────────────────────────────────────────────────────────┘
↓
┌───────────────────────────────────────────────────────────────┐
│ 반복 Loop (각 화마다) │
│ │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ Step 1: 일관성 검토 (5화마다) │ │
│ │ - story-continuity-specialist 에이전트 │ │
│ │ - 설정/복선/호감도 일관성 점검 │ │
│ │ - 문제 발견 시 사용자에게 보고 후 계속 │ │
│ └─────────────────────────────────────────────────────────┘ │
│ ↓ │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ Step 2: 화 설계 │ │
│ │ - 연재상태.md의 다음 화 예정 설계 참조 │ │
│ │ - 스토리구성.md 기반 화 타입 결정 │ │
│ │ - 아웃라인.md TODO 확인 │ │
│ └─────────────────────────────────────────────────────────┘ │
│ ↓ │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ Step 3: 집필 (writing-specialist) │ │
│ │ - 문체.md + 스토리구성.md 기반 집필 │ │
│ │ - drafts/{N}_draft.md 저장 │ │
│ └─────────────────────────────────────────────────────────┘ │
│ ↓ │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ Step 4: 퇴고 (revision-specialist) │ │
│ │ - 설정/캐릭터/문체 일관성 검토 │ │
│ │ - CRITICAL 자동 수정 │ │
│ │ - chapters/{N}.md 최종본 저장 │ │
│ └─────────────────────────────────────────────────────────┘ │
│ ↓ │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ Step 5: 상태 갱신 │ │
│ │ - 연재상태.md 업데이트 (호감도/복선/타임라인) │ │
│ │ - 아웃라인.md TODO 갱신 │ │
│ │ - 다음 화 설계 준비 │ │
│ └─────────────────────────────────────────────────────────┘ │
│ ↓ │
│ [다음 화로 반복] 또는 [마감 회차 도달 시 종료] │
└───────────────────────────────────────────────────────────────┘
↓
┌───────────────────────────────────────────────────────────────┐
│ 완료 Phase │
│ - 연재 완료 보고서 출력 │
│ - 전체 복선 회수 상태 확인 │
│ - 캐릭터 아크 완성 확인 │
└───────────────────────────────────────────────────────────────┘
```
---
## Execution Flow
### Phase 1: 초기화
1. **입력 파싱**:
```yaml
입력 유형:
- 작품명만: 아웃라인.md의 목표 화수까지
- 작품명 + 숫자: 현재부터 N화만 추가 연재
- 작품명 + "N화까지": N화까지 연재
```
2. **마감 회차 확인**:
```yaml
경로: content/rovel/{작품명}/아웃라인.md
찾을 정보:
- "목표 분량" 또는 "시즌 1 완결" 섹션
- 예: "시즌 1 완결: 150화"
- 부별 구성 테이블
기본값: 150화 (아웃라인에 명시 없을 경우)
```
3. **현재 진행 상황 확인**:
```yaml
경로: content/rovel/{작품명}/연재상태.md
추출 정보:
- 마지막 완료 화수
- 현재 호감도 테이블
- 활성 복선 목록
- 다음 화 예정 설계
```
4. **연재 범위 결정**:
```yaml
시작 화수: 연재상태.md의 마지막 화 + 1
종료 화수: 마감 회차 또는 사용자 지정 화수
예시:
현재 1화 완료, 마감 150화
→ 2화부터 150화까지 연재 (149화 분량)
```
---
### Phase 2: 연재 루프 (각 화마다 반복)
> **핵심**: 각 화마다 `/rovel.write`와 동일한 품질 보장
#### Step 1: 일관성 검토 (5화마다)
```yaml
조건: (현재 화수 - 시작 화수) % 5 == 0
에이전트: story-continuity-specialist
프롬프트: |
최근 5화의 연재 일관성을 검토해주세요.
## 작품 정보
- 작품명: {작품명}
- 검토 범위: {N-4}화 ~ {N}화
## 검토 항목
1. 설정 일관성 (세계관, 캐릭터 외형)
2. 호감도 진행 (급격한 변화 없는지)
3. 복선 상태 (미회수 복선 초과 여부)
4. 타임라인 일관성
## 참조 파일
[연재상태.md]
[기획안.md]
[인물목록.md]
[최근 5화 chapters/]
## 출력
- 발견된 문제 (있을 경우)
- 수정 권장 사항
- 다음 5화 방향 제안
문제 발견 시: 사용자에게 보고 후 계속/중단 선택
```
#### Step 2: 화 설계
```yaml
참조 파일:
1. 연재상태.md → 다음 화 예정 설계
2. 아웃라인.md → 부별 계획, TODO
3. 스토리구성.md → 화 타입 규칙
화 설계 생성:
기본 정보:
화수: N화
타입: A/B/C/D/E (스토리구성.md 참조)
제목: 상처 중심 명명법
등장 인물:
- 아웃라인.md 회차별 계획 참조
- 자화연 2~3화마다 등장 유지
핵심 이벤트:
- 연재상태.md 다음 화 예정에서 추출
- 아웃라인.md TODO에서 해당 화 내용 추출
복선 관리:
- 연재상태.md 활성 복선에서 회수 대상 선정
- 새로 배치할 복선 계획
```
#### Step 3: 집필 (writing-specialist 호출)
```yaml
Task 도구 사용:
subagent_type: writing-specialist
prompt: |
다음 정보를 기반으로 {N}화를 집필해주세요.
## 작품 정보
- 작품명: {작품명}
- 화수: {N}화
- 화 타입: {타입}
- 제목: {제목}
## 참조 파일 내용
[연재상태.md 전체]
[문체.md 전체]
[스토리구성.md 해당 타입 섹션]
[기획안.md 캐릭터 말투 섹션]
[인물목록.md 등장 인물 섹션]
[이전 2화 마지막 부분]
## 화 설계
[Step 2에서 생성한 화 설계]
## 출력
- 파일 경로: {작품폴더}/drafts/{N}_draft.md
- 분량: 3,500자 (±500자)
```
#### Step 4: 퇴고 (revision-specialist 호출)
```yaml
Task 도구 사용:
subagent_type: revision-specialist
prompt: |
다음 초안을 퇴고해주세요.
## 작품 정보
- 작품명: {작품명}
- 화수: {N}화
- 초안 경로: {작품폴더}/drafts/{N}_draft.md
## 참조 파일 내용
[연재상태.md - 호감도 테이블 필수]
[문체.md]
[인물목록.md]
[기획안.md]
## 퇴고 후 작업
1. CRITICAL 오류 자동 수정
2. 최종본을 {작품폴더}/chapters/{N}.md에 저장
3. 퇴고 요약 보고 (Critical/Warning 건수)
```
#### Step 5: 상태 갱신
```yaml
갱신 파일:
1. 연재상태.md:
- 마지막 화: N화로 업데이트
- 작중 시간: 업데이트
- 마지막 장면: 이번 화 마지막 장면
- 호감도 테이블: 변화 반영
- 활성 복선: 회수/배치 반영
- 타임라인: 이번 화 추가
- 최근 화 요약: 추가 (5화 유지)
- 다음 화 예정 설계: 업데이트
- 갱신 로그: 날짜, 화수, 내용
2. 아웃라인.md TODO:
- 해당 화 완료 처리 [x]
- 새 복선 기록 (필요 시)
```
---
### Phase 3: 화 완료 보고 (각 화마다)
```markdown
## ✅ {N}화 완료
**파일**: `chapters/{N}.md`
**분량**: N자
**진행률**: {완료/전체}화 ({퍼센트}%)
### 주요 내용
- [장면 요약]
### 퇴고 결과
- Critical: N건 (모두 수정됨)
- Warning: N건
### 다음 화
- {N+1}화: {예정 내용}
---
[계속 진행 중...]
```
---
### Phase 4: 연재 완료
마감 회차 도달 시:
```markdown
# 연재 완료 보고서
## 기본 정보
| 항목 | 값 |
|------|-----|
| 작품명 | {작품명} |
| 총 연재 화수 | {시작화}~{종료화} ({N}화) |
| 총 분량 | 약 N만자 |
| 연재 기간 | {시작}~{종료} |
## 캐릭터 최종 상태
| 인물 | 최종 호감도 | 최종 단계 | 총 등장 | 아크 완성 |
|------|------------|----------|---------|----------|
| 자화연 | N/100 | XX | N화 | ✅/⚠️ |
| ...
## 복선 최종 상태
### 회수 완료
| 복선 | 심은 화 | 회수 화 |
|------|---------|---------|
### 미회수 (후속작용)
| 복선 | 심은 화 | 비고 |
|------|---------|------|
## 부별 완료 현황
| 부 | 화수 | 테마 | 상태 |
|----|------|------|------|
| 1부 | 1~30화 | 숨기며 돕기 | ✅ |
| 2부 | 31~70화 | 의심의 시작 | ✅ |
| ...
## 품질 지표
- 총 CRITICAL 수정: N건
- 총 WARNING: N건
- 설정 위반 0건 유지: ✅/❌
## 결말 확인
- 재각성 엔딩 완료: ✅/❌
- 천마 루트 확정: ✅/❌
- 에필로그 작성: ✅/❌
```
---
## 중단/재개 처리
### 중단 시
```yaml
저장 항목:
- 연재상태.md (자동 갱신되어 있음)
- 마지막 완료 화수 기록
재개 방법:
- /rovel.complete {작품명}
- 연재상태.md의 마지막 화+1부터 자동 재개
```
### 오류 발생 시
```yaml
집필 실패:
- 사용자에게 알림
- 해당 화 재시도 또는 스킵 선택
퇴고 실패:
- drafts/{N}_draft.md 유지
- 수동 퇴고 후 재개 가능
일관성 문제 발견:
- 사용자에게 보고
- 수정 후 계속 또는 중단 선택
```
---
## 진행 속도 조절
```yaml
기본: 각 화 완료 후 즉시 다음 화
선택 옵션:
- /rovel.complete {작품명} --pause
→ 각 화 완료 후 사용자 확인 대기
- /rovel.complete {작품명} --batch 5
→ 5화씩 배치 후 중간 보고
- /rovel.complete {작품명} --review
→ 매 화마다 상세 퇴고 보고서 출력
```
---
## Reference Files
| 유형 | 경로 | 용도 |
|------|------|------|
| 연재상태 | `content/rovel/{작품명}/연재상태.md` | 진행상황/호감도/복선 |
| 아웃라인 | `content/rovel/{작품명}/아웃라인.md` | 마감 회차, TODO |
| 기획안 | `content/rovel/{작품명}/기획안.md` | 핵심 규칙 |
| 문체 | `content/rovel/{작품명}/문체.md` | 문체 DNA |
| 스토리구성 | `content/rovel/{작품명}/스토리구성.md` | 화 구성 패턴 |
| 인물목록 | `content/rovel/{작품명}/인물목록.md` | 캐릭터 설정 |
## Agent Dependencies
| 에이전트 | 역할 | 호출 빈도 |
|----------|------|----------|
| writing-specialist | 집필 | 매 화 |
| revision-specialist | 퇴고 | 매 화 |
| story-continuity-specialist | 일관성 검토 | 5화마다 |
---
## 연재 완료 조건
```yaml
정상 완료:
- 마감 회차 도달
- 아웃라인.md 엔딩 완료 확인
- 모든 장기 복선 회수 (또는 후속작용 명시)
비정상 종료:
- 사용자 중단 요청
- 연속 3회 오류 발생
- 심각한 일관성 문제 (사용자 확인 필요)
```