Files
Ex2-novel-agent/.claude/commands/rovel.write.md
rupy1014 f66fe445bf Initial commit: Novel Agent setup
- 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>
2025-12-14 21:31:57 +09:00

14 KiB

description
description
웹소설 다음화 집필 - 이전화 다음 챕터를 작성하고 퇴고까지 자동 수행

User Input

$ARGUMENTS

User input must be considered (if not empty).

Overview

The text following /rovel.write is the chapter path or instructions. Assume $ARGUMENTS is always available.

Examples:

  • /rovel.write content/rovel/협회 소속 양호선생님 다음화
  • /rovel.write 협회 소속 양호선생님 4화 루나 치료 에피소드
  • /rovel.write 003.md 다음화 (현재 작업 중인 작품 기준)

This is a 2-Agent workflow:

┌─────────────────────────────────────────────────────────┐
│  Phase 1: 준비                                           │
│  - 연재상태.md 파악                                       │
│  - 다음 화 설계                                          │
│  - 참조 파일 수집                                        │
└─────────────────────────────────────────────────────────┘
                           ↓
┌─────────────────────────────────────────────────────────┐
│  Phase 2: 집필 (writing-specialist 에이전트)              │
│  - 문체.md + 스토리구성.md 기반 집필                      │
│  - 호감도 기반 말투/호칭 적용                             │
│  - drafts/ 폴더에 초안 저장                              │
└─────────────────────────────────────────────────────────┘
                           ↓
┌─────────────────────────────────────────────────────────┐
│  Phase 3: 퇴고 (revision-specialist 에이전트)            │
│  - 설정/캐릭터/문체 일관성 검토                           │
│  - CRITICAL 자동 수정                                    │
│  - chapters/ 폴더에 최종본 저장                          │
└─────────────────────────────────────────────────────────┘
                           ↓
┌─────────────────────────────────────────────────────────┐
│  Phase 4: 갱신                                           │
│  - 연재상태.md 업데이트                                   │
│  - 호감도/복선/타임라인 갱신                              │
└─────────────────────────────────────────────────────────┘

Execution Flow

Phase 1: 파일 경로 파싱

  1. 입력 분석:

    • 절대 경로가 주어지면 그대로 사용
    • 상대 경로나 화수만 주어지면 현재 작품 폴더에서 탐색
    • "다음화", "다음 화" 키워드 → 마지막 화 번호 + 1
  2. 작품 폴더 결정:

    기본: content/rovel/{작품명}/
    예시: content/rovel/협회 소속 양호선생님/
    
  3. 다음 화 번호 계산:

    • chapters/ 폴더의 가장 큰 번호 확인
    • 예: 003.md가 마지막이면 → 004.md 생성

Phase 2: 연재상태 파악 (⚠️ 최우선)

가장 먼저 연재상태.md를 읽어 현재 상황을 파악합니다.

필수 읽기 파일:
  1. 연재상태.md: ⚠️ 최우선
     - 경로: {작품폴더}/연재상태.md
     - 추출:
       - 마지막 화/장면 (어디서 이어쓸지)
       - 작중 시간 (타임라인 연속성)
       - 호감도 테이블 (말투/호칭 결정)
       - 활성 복선 목록 (회수/배치할 복선)
       - 다음 화 예정 설계 (이미 계획된 내용)

  2. 기획안.md:
     - 경로: {작품폴더}/기획안.md
     - 추출: 핵심 규칙, 세계관 설정, 당직 체계, 캐릭터별 말투

  3. 문체.md: ⚠️ 필수
     - 경로: {작품폴더}/문체.md
     - 추출: 문장 호흡(15-30자), 감정 표현 패턴, 시스템창 스타일, 금지 패턴

  4. 스토리구성.md: ⚠️ 필수
     - 경로: {작품폴더}/스토리구성.md
     - 추출: 화 타입(A/B/C/D), 장면 구성 규칙, 복선 관리, 시스템창 배치

  5. 인물목록.md:
     - 경로: {작품폴더}/인물목록.md
     - 추출: 외형 설정, 말투 패턴, 호칭 체계, 호감도 테이블

  6. 아웃라인.md:
     - 경로: {작품폴더}/아웃라인.md
     - 추출: TODO, 복선 관리, 다음화 예정 내용

  7. 이전 2~3화:
     - 경로: {작품폴더}/chapters/{이전화들}.md
     - 추출: 연속성 확인, 마지막 장면, 시간 흐름

Phase 3: 다음 화 설계 (스토리구성.md 기반)

집필 전 반드시 화 설계를 먼저 수행합니다:

  1. 화 타입 결정:

    A타입: 신규 환자 첫 등장 (도입→등장→갈등→치료→마무리)
    B타입: 단골 환자 심화 (일상→정기치료→새발견→감정진전→마무리)
    C타입: 복수 캐릭터 등장 (A장면→전환→B장면→연결)
    D타입: 이벤트/클라이맥스 (긴장→사건→능력발휘→여파→새국면)
    
  2. 호감도 기반 캐릭터 설정 확인:

    연재상태.md의 호감도 테이블 확인:
      - 현재 호감도 → 현재 단계 결정
      - 단계에 맞는 호칭/말투 적용
      - 이번 화에서 호감도 변화 계획
    
    예시:
      자화연 현재 호감도: 18 (초면)
      → 호칭: "필부", "네 놈"
      → 이번 화 이벤트: 온기 느낌 (+5)
      → 예상 종료 호감도: 23 → "한시우" 호칭 해금!
    
  3. 화 설계 체크리스트 작성:

    기본 정보:
      - 화수: ___화
      - 타입: A/B/C/D
      - 예상 분량: ___자
    
    등장 인물:
      - 메인: (이름, 현재 호감도, 단계)
      - 서브:
      - 언급만:
    
    시간/공간:
      - 시작 시간: (연재상태.md 타임라인 이어서)
      - 종료 시간:
      - 장소:
    
    핵심 이벤트:
      1.
      2.
      3.
    
    복선 관리:
      - 회수할 복선: (연재상태.md 활성 복선에서)
      - 새로 심을 복선:
    
    호감도 변화:
      - 누가: 현재 → 예상 종료
      - 트리거 이벤트:
    
    연결:
      - 이전 화 끝: (연재상태.md 마지막 장면)
      - 다음 화 예정:
    

Phase 4: 집필 (writing-specialist 에이전트 호출)

중요: Task 도구로 writing-specialist 에이전트를 호출하여 집필 수행

에이전트 호출 방식:

Task 도구 사용:
  subagent_type: writing-specialist
  prompt: |
    다음 정보를 기반으로 {N}화를 집필해주세요.

    ## 작품 정보
    - 작품명: {작품명}
    - 화수: {N}화
    - 화 타입: {A/B/C/D/E}

    ## 참조 파일 내용
    [연재상태.md 내용]
    [문체.md 내용]
    [스토리구성.md 내용]
    [기획안.md 내용]
    [인물목록.md 내용]
    [이전화 마지막 부분]

    ## 화 설계
    [Phase 3에서 작성한 화 설계 체크리스트]

    ## 출력
    - 파일 경로: {작품폴더}/drafts/{화수}_draft.md
    - 분량: 3,500자

에이전트가 참조할 가이드:

  • .claude/agents/writing-specialist.md - 집필 전문가 가이드
  • rules/novel-writer.md - 집필 규칙

초안 저장 위치: {작품폴더}/drafts/{화수}_draft.md


Phase 5: 퇴고 (revision-specialist 에이전트 호출)

중요: Task 도구로 revision-specialist 에이전트를 호출하여 퇴고 수행

에이전트 호출 방식:

Task 도구 사용:
  subagent_type: revision-specialist
  prompt: |
    다음 초안을 퇴고해주세요.

    ## 작품 정보
    - 작품명: {작품명}
    - 화수: {N}화
    - 초안 경로: {작품폴더}/drafts/{화수}_draft.md

    ## 참조 파일 내용
    [연재상태.md 내용 - 호감도 테이블 필수]
    [문체.md 내용]
    [인물목록.md 내용]
    [기획안.md 내용]

    ## 퇴고 후 작업
    1. CRITICAL 오류 자동 수정
    2. 최종본을 {작품폴더}/chapters/{화수}.md에 저장
    3. 퇴고 보고서 출력

에이전트가 참조할 가이드:

  • .claude/agents/revision-specialist.md - 퇴고 전문가 가이드

퇴고 체크리스트 (에이전트가 자동 수행):

우선순위 검토 항목 설명
⚠️ 최우선 호감도/호칭 현재 호감도에 맞는 호칭만 사용
CRITICAL 캐릭터 외형 눈동자, 머리카락 색상 등
CRITICAL 말투 패턴 캐릭터별 말투 규칙
WARNING 문체 일관성 문장 호흡, 감정 표현
WARNING 설정 일관성 세계관, 시간 흐름

최종본 저장 위치: {작품폴더}/chapters/{화수}.md


Phase 6: 퇴고 보고서 출력

# 퇴고 보고서: {화수}

## 🔴 CRITICAL (즉시 수정 필요)
| 라인 | 문제 | 현재 | 수정안 |
|------|------|------|--------|

## 🟡 WARNING (검토 권장)
| 라인 | 문제 | 설명 |
|------|------|------|

## 🟢 SUGGESTION (선택적 개선)

## 📊 요약
- Critical: N건
- Warning: N건
- Suggestion: N건

Phase 7: 자동 수정 및 갱신

  1. CRITICAL 자동 수정:

    • 설정 오류 (눈동자 색상 등) → 즉시 수정
    • 말투/호칭 오류 → 즉시 수정
    • 호감도 단계 불일치 → 즉시 수정
  2. 인물목록.md 갱신:

    • 호감도 테이블 업데이트 (새 화수 추가)
    • 관계 변화 이력 추가
    • 호칭 변화 기록 (단계 변화 시)
    • 새 인물 추가 (등장 시)
  3. 아웃라인.md TODO 갱신:

    • 해당 화 완료 처리 [x]
    • 새 복선 기록
    • 다음 화 TODO 추가

Phase 8: 연재상태.md 갱신 (⚠️ 필수)

중요: 매 화 집필 완료 후 반드시 연재상태.md를 갱신해야 함

갱신 항목:

1. 현재 진행 상황:
   - 마지막 화: N화 → N+1화
   - 작중 시간: 업데이트
   - 마지막 장면: 이번 화 마지막 장면
   - 다음 화 예정: 예상 내용

2. 호감도 테이블:
   - 등장한 인물의 호감도 업데이트
   - 변화 트리거 기록
   - 단계 변화 시 호칭 해금 기록

3. 활성 복선 목록:
   - 회수한 복선: 상태 → ✅ 회수
   - 새로 심은 복선: 추가
   - 진행 중 복선: 상태 업데이트

4. 타임라인:
   - 이번 화 시간대/이벤트 추가

5. 최근 화 요약:
   - 이번 화 행 추가 (오래된 화 삭제하여 5화 유지)

6. 다음 화 예정 설계:
   - 다음 화 기본 설계 업데이트

7. 갱신 로그:
   - 날짜, 화수, 갱신 내용 기록

Output Format

집필 완료 후 다음 형식으로 요약 출력:

## ✅ 집필 완료

**파일**: `content/rovel/{작품명}/chapters/{화수}.md`
**분량**: N자

### 주요 내용
- [장면 1 요약]
- [장면 2 요약]
- ...

### 호감도 변화
| 인물 | 이전 | 이후 | 단계 변화 |
|------|------|------|----------|
| 자화연 | 18 | 23 | 초면 → 관심 ("한시우" 해금) |
| 루나 | 3 | 15 | 초면 유지 |

### 복선 관리
- 회수: [복선 내용]
- 배치: [새 복선 내용]

### 퇴고 결과
- 🔴 Critical 수정: N건 → 모두 수정 완료
- 🟡 Warning: N건 (검토 권장)
- 🟢 Suggestion: N건

### 갱신된 파일
- [x] 연재상태.md
- [x] 인물목록.md (호감도 업데이트)
- [x] 아웃라인.md (TODO 갱신)

### 다음 화 예정
- [다음 화 예상 내용]

Reference Files

유형 경로 용도
연재상태 content/rovel/{작품명}/연재상태.md 진행상황/호감도/복선 ⚠️ 최우선
집필 가이드 rules/novel-writer.md 집필 + 퇴고 프로세스
집필 에이전트 .claude/agents/writing-specialist.md 집필 전문가 가이드
퇴고 에이전트 .claude/agents/revision-specialist.md 퇴고 전문가 가이드
기획안 content/rovel/{작품명}/기획안.md 핵심 규칙
문체 가이드 content/rovel/{작품명}/문체.md 문체 DNA ⚠️ 필수
스토리구성 content/rovel/{작품명}/스토리구성.md 화 구성/복선 ⚠️ 필수
인물목록 content/rovel/{작품명}/인물목록.md 캐릭터 설정/호감도
아웃라인 content/rovel/{작품명}/아웃라인.md TODO, 복선

Agent Workflow

┌──────────────────┐     초안      ┌──────────────────┐     최종본     ┌──────────────┐
│ writing-specialist│ ──────────→ │revision-specialist│ ──────────→ │  chapters/   │
│   (집필 전문가)    │   drafts/   │   (퇴고 전문가)    │              │   {N}.md     │
└──────────────────┘              └──────────────────┘              └──────────────┘
        ↑                                  ↑
        │                                  │
   문체.md                            연재상태.md
   스토리구성.md                       인물목록.md
   기획안.md                           문체.md