modoojunko/awesome-novel-agent

awesome-novel-agent

무엇인가요 – 대규모 언어 모델 에이전트(Claude Code, OpenCode, Reasonix, Codex, ZCode, DeepSeek Harness)를 공동 소설 작성 보조자로 바꾸는 멀티플랫폼 스킬입니다. 9개의 전문 에이전트(アウトラ인 기획자, 프롬프트 제작자, 작가, AI 필터, 리뷰어, 업데이터 등)와 지식 기반을 제공하여 장르 선택에서 완성된 원고에 이르기까지 사용자를 안내합니다.

주요 기능

• 원클릭 설치 – AI 도구에 "install awesome-novel-agent"라고 말하면 install.sh가 실행되어 선택된 플랫폼에 적절한 사용자 레벨 디렉터리에 스킬을 배치합니다.
• 프로젝트 초기화 – init.py가 스토리 인덱스, 설정, 볼륨, 챕터, 프롬프트, 아카이브, 메모리, 지식, 플랫폼별 에이전트 정의를 포함하는 완전한 소설 워크스페이스를 생성합니다.
• 에이전트 기반 워크플로우 – 상위 레벨의 novel-agent가 하위 에이전트를 설정 → 아웃라인 → 초안 → AI 필터 → 선택적 리뷰 → 아카이브 단계로 조율합니다. 사용자는 각 단계에서 확인 또는 편집만 하면 됩니다.
• 스타일 추출 – 샘플 텍스트를 가져오면 style-distiller가 문장 길이, 대화 비율, 형용사 밀도와 같은 정량적 스타일 파라미터를 추출하고 프롬프트에 주입하여 모델의 목소리를 지속적으로 개선합니다.
• AI 필터링 – 전용 anti-ai 에이전트가 다단계 게이트를 실행하여 일반적인 "기계적" 표현을 탐지하고 제거하며 결과에 점수를 매깁니다.
• 동적 메모리 – 모든 상호작용, 선호도, 규칙 업데이트는 프로젝트별 memory/ 파일에 저장되며, 자주 사용되는 규칙은 영구 메모리로 승격됩니다.
• 장르 프리셋 – 24개의 내장된 장르 프로파일(xianxia, 도시, 미스터리, SF 등)이 기본 세계관 구축, 캐릭터 아키타입, 템포 템플릿을 제공합니다.
• 두 가지 협업 모드 – 단계별 (기본, 확인을 요청) 또는 전체 권한 ("당신은 전체 권한을 가집니다")으로 손을 놓고 생성합니다.

지원 플랫폼

플랫폼	설치 경로 (사용자 레벨)	프로젝트 레벨 폴더
Claude Code	~/.claude/skills/awesome-novel/	.claude/
OpenCode	~/.config/opencode/skills/awesome-novel/	.opencode/
Reasonix	(프로젝트 레벨만) .<project>/.reasonix/skills/	.reasonix/
Codex	~/.codex/skills/awesome-novel/	.codex/
ZCode	~/.zcode/skills/awesome-novel/	.zcode/
DeepSeek Harness	~/.dsh/skills/awesome-novel/	.dsh/

일반적인 사용법

1. 설치 – 선택된 AI 콘솔에서 帮我安装 awesome-novel-agent라고 말합니다. 도구가 ./install.sh <platform>를 실행합니다.
2. 소설 프로젝트 생성 – 빈 폴더로 이동하여 스킬을 호출합니다 (/awesome-novel 또는 @novel-agent). 에이전트가 장르, 세계관, 캐릭터, 스타일을 안내합니다.
3. 작성 – 写下一章, 帮我继续写, 또는 solo (완전 자동) 같은 명령어를 사용합니다. 에이전트가 아웃라인, 프롬프트, 초안을 생성하고 AI 필터를 실행하며, 선택적으로 리뷰하고 완성된 챕터를 아카이브합니다.
4. 반복 – 언제든지 설정을 수정(改一下世界观里的…)하거나 자체 스타일 샘플을 가져올 수 있습니다.

설치 세부사항

• Python 3.9+ 필요 (macOS는 3.9 제공; 3.11+ 권장). OpenCode/Codex/ZCode/DeepSeek는 pyyaml도 필요 (pip install pyyaml).
• ./install.sh <platform> (Windows에서는 install.ps1)를 실행합니다. 스크립트는 Python 버전과 종속성을 확인한 후 스킬을 복사합니다.
• Reasonix의 경우, 글로벌 설치기 대신 init.py를 통해 프로젝트별로 배포됩니다.

프로젝트 구조 (init 후)

<novel>/
├─ story.md                # 고수준 인덱스
├─ settings/…              # 세계, 스타일, 장르, 타임라인, 캐릭터
├─ volumes/                # 볼륨 수준 아웃라인
├─ chapters/               # 챕터 수준 아웃라인
├─ prompts/                # 생성된 프롬프트
├─ archives/               # 최종 챕터
├─ .agent/                 # 상태 및 작업 파일
├─ .<platform>/            # 선택된 플랫폼용 에이전트, 지식, 메모리
└─ ...                     # 선택적 사전, 샘플 등

선택된 플랫폼과 일치하는 디렉터리만 생성됩니다.

라이선스 – GPL 3.0 (개인 사용은 무료; 상업적 사용은 저자 허가 필요).

커뮤니티 – 지원, 피드백, 생성된 소설 공유를 위한 QQ 디스커션 그룹(ID 1006050538) 제공.

기여 방법 – CONTRIBUTING.md 참조. 기여는 다음과 같습니다:

• GitHub 이슈를 통한 버그 보고 / 기능 요청.
• 새로운 장르 프로파일 또는 AI 필터 규칙 예시 추가.
• 에이전트 정의(agents/*.md) 또는 스킬 SOP 개선.
• 프로젝트의 Python/Markdown 규약에 따라 코드 변경.

---

이 요약은 리포지토리의 README에 기반하며, 추가 기능은 추측하지 않았습니다.