Tomsawyerhu/Chinese-WebNovel-Skill

중국어-웹소설-스킬

무엇인가 – 대규모 언어 모델(LLM) 에이전트가 중국어 웹소설을 쓰는 데 도움이 되도록 설계된 프롬프트 및 데이터 모듈의 모음입니다. 단일한 거대한 프롬프트 대신, 이 저장소는 글쓰기 워크플로를 라우터 (SKILL.md)와 전문적인 하위 스킬들(예: 플롯 기획, 서문, 대사, 일관성 검토 등)로 나눕니다. 각 하위 스킬은 자체 튜토리얼, 런타임 규칙, 좋은/나쁜 예시, 필요 시 템플릿 자산을 함께 제공합니다.

왜 중요한가 – 중국어 웹소설 플랫폼은 매우 구체적인 구조를 요구합니다(첫 300단어 내에 훅을 넣고, 단단한 장 끝맺음, 일관된 캐릭터 목소리 등). 문제를 재사용 가능한 모듈로 나누고, 실제 소설 문장의 로컬 코퍼스와 결합함으로써 시스템은 LLM이 다음을 수행할 수 있게 합니다:

현재 작업 중인 글쓰기 단계를 진단합니다,
코퍼스에서 관련 예시 자료를 가져옵니다,
해당 단계에만 초점을 맞춘 집중적인 프롬프트를 적용합니다,
최종 일관성 검토를 실행합니다.

이 모듈식 접근은 프롬프트를 짧고 유지보수하기 쉽게 만들며, 이야기의 모든 측면을 한 번에 다루려는 시도로 인해 발생하는 '프롬프트 과잉' 현상에서 벗어나게 합니다.

핵심 설계

계층	내용	목적
1. `SKILL.md`	전반적인 원칙, 흐름 제약, 라우팅 테이블	사용자의 요청에 따라 어떤 모듈을 호출할지 결정
2. `references/modules/`	고빈도 글쓰기 문제(예: `opening`, `dialogue`)마다 하나의 폴더를 두며, `README.md`, `tutorial.md`, `runtime.md`, `good_examples.md`, `bad_examples.md`, `source_index.md` 포함	해당 문제에 대한 지식, 규칙, 예시를 캡슐화
3. `data/` 및 `analysis/`	원시 소설 기사, 구조화된 추출물의 CSV, 모방 지수, 통계	모델이 참조할 수 있는 검색 가능한 로컬 코퍼스 제공
4. `scripts/` 및 `templates/`	코퍼스 검색을 위한 파이썬 스크립트, 개요용 몇 가지 템플릿 파일	검색 단계를 구현하고 미리 만들어진 개요 자산을 제공

모듈 (현재 구현됨)

concept_planning – 한 문장의 전제를 장르, 훅, 전제, 스토리 엔진, 길이 추정, 첫 번째 시즌 방향으로 전환합니다.
opening – 독자를 끌어들이는 첫 300~3000자 범위의 글을 생성합니다.
volume_outline – 스토리 엔진을 3장짜리 '황금' 아크, 전체 시즌 개요, 장 수준의 개요로 확장합니다.
plot_logic – 인과관계 체인, 동기, 촉발 요소, 결정, 보상 등을 수정합니다.
character_consistency – 캐릭터의 목표, 감정, 관계, 신체적 특징, 목소리가 일관되게 유지되도록 합니다.
transition – 시간 이동, 장면 전환, 시점 변화, 장 간 연결을 처리합니다.
dialogue – 관계적 긴장감, 캐릭터 목소리, 정보 삽입, 강렬한 대사를 구성합니다.
chapter_ending – 훅, 남아 있는 긴장감, 다음 장을 위한 준비를 추가합니다.
anti_ai_voice – 일반적인 AI 스타일 표현, 반복적인 설명, 일관된 톤을 제거합니다.
consistency_review – 장이 완료된 것으로 간주되기 전에 플롯, 캐릭터, 전환, 대사, 끝맺음의 일관성을 최종 검토합니다.

각 모듈은 동일한 구조를 따르므로, 메인 프롬프트의 크기를 늘리지 않고도 새로운 문제 중심 모듈을 쉽게 추가할 수 있습니다.

작동 방식 (고수준 흐름)

사용자 입력 – 간단한 이야기 아이디어 또는 특정 글쓰기 문제.
라우터 (SKILL.md) 는 요청이 고수준 기획 작업인지, 지역적 문제인지 결정합니다.
모듈 활성화 – 적절한 하위 스킬이 로드되며, 그 tutorial.md와 runtime.md가 LLM을 안내합니다.
코퍼스 조회 – search_corpus_examples.py 스크립트가 data/articles/와 analysis/excerpts.csv에서 2~~4개의 긍정적 예시와 1~~2개의 부정적 예시를 가져옵니다.
프롬프트 구성 – LLM은 다음을 포함하는 간결한 프롬프트를 받습니다:
- 라우팅 결정,
- 모듈의 규칙과 예시,
- 조회된 코퍼스 스니펫.
생성 – 모델이 타겟된 세그먼트에 대한 계획, 초안, 또는 수정본을 생성합니다.
일관성 검토 – 장이 작성된 후, consistency_review가 자동으로 실행되어 잔여 모순을 포착합니다.

이 저장소에는 계획 → 실행 → 최종 검토의 3단계 파이프라인과 라우터, 모듈, 로컬 코퍼스 간의 데이터 흐름을 시각화하는 Mermaid 다이어그램도 포함되어 있습니다.

시작하기

# 저장소 복제
git clone https://github.com/Tomsawyerhu/Chinese-WebNovel-Skill.git
cd Chinese-WebNovel-Skill

# 코퍼스 검색 실행 (예: '위기' 상황에 대한 서문 훅 찾기)
python3 scripts/search_corpus_examples.py \
    --type '시작 훅' \
    --tag '위기압박' \
    --limit 5

# 전체 스킬을 사용하려면, SKILL.md의 내용을 시스템 프롬프트로 사용하여 스토리 전제를 LLM에 전달하세요.
# 정확한 API 호출은 사용하는 LLM에 따라 다릅니다(예: OpenAI, Anthropic, Claude 등).

단일 문제 해결을 원한다면, 해당 모듈을 직접 호출하세요(예: dialogue)并将 다음 순서를 따르세요:

모듈의 README.md → tutorial.md → runtime.md를 읽으세요.
스크립트가 관련 예시를 가져오게 하세요.
수집된 정보로 모델에 프롬프트를 전달하세요.

누구에게 적합한가

중국어 웹소설 작가들: 장르 규범을 존중하고 일반적인 AI 문체를 피하는 AI 보조 기능을 원하는 분들.
프롬프트 엔지니어들: 중국어 소설을 위한 LLM 기반 글쓰기 보조 도구를 개발하는 분들.
연구자들: 모듈식 프롬프트 설계, 검색 기반 생성, 도메인 특화 AI 글쓰기 파이프라인에 관심 있는 분들.

유지보수 철학

전역 라우터는 최소한으로 유지하고, 새로운 문제는 별도의 모듈로 추가하세요.
각 모듈은 반드시 튜토리얼 + 런타임 규칙 + 좋은/나쁜 예시를 포함해야 합니다.
모델에 프롬프트를 전달하기 전에 반드시 구체적인 코퍼스 자료를 가져와야 합니다.
매 장마다 consistency_review를 실행하세요.

결론 – Chinese-WebNovel-Skill은 LLM이 중국어 웹소설의 체계적이고 검색 기반 프롬프트 프레임워크를 통해 규율 있는 공동 작가 역할을 할 수 있도록 해주는 도구입니다. 글쓰기 과정을 명확하고 유지보수 가능한 단위로 나누면서도, 실제 소설 예시에 기반한 출력을 보장합니다.