小説ライブラリ一括整理ツール

# 小説ライブラリ一括整理ツール 使用ガイド

## 概要

Novel Library Batch Organizerは、整理されていないローカルの中国語小説コレクションをTXT形式で整理するために設計されています。テキストファイルのUTF-8への変換、品質に基づく文書の分類、章構成の標準化、書式のクリーンアップ、処理後の結果の検証を行えます。

エンコーディングが統一されていない、章タイトルの形式が一貫していない、段落の書式が乱れている、または一括で品質をチェックする必要がある小説テキストファイルのコレクションに適しています。

## 実行できる整理作業

- **エンコーディングの標準化**: テキストファイルをUTF-8に変換し、異なるソースから取得したTXTファイル間のエンコーディングの差異を軽減します。
- **品質分類**: 文書をスキャンして品質別に分類し、追加処理が必要なファイルを特定しやすくします。
- **章の標準化**: 章を識別、マッピング、置換、再番号付けして、章構成の一貫性を高めます。
- **基本的なクリーンアップ**: 一般的な書式の乱れを除去し、テキストのレイアウトを改善します。
- **結果の検証**: 整理完了後に処理結果を確認します。

## 推奨ワークフロー

### 1. TXT形式の小説ライブラリを準備する

処理対象がローカルにあるTXT形式の中国語小説ファイルであることを確認し、エンコーディングの標準化、章の整理、または書式のクリーンアップが必要なファイルを特定します。

### 2. エンコーディングを前処理してからスキャンおよび分類する

最初にエンコーディングの前処理を行い、その後に文書の品質スキャンと分類を実行します。ツールキットには、エンコーディングの前処理用として`preprocess_encoding.py`、スキャンに基づく分類用として`scan_and_classify.py`が用意されています。

### 3. 章を標準化する

章タイトルに一貫性がない、または章の順序を調整する必要があるテキストファイルには、章のマッピング、置換、再番号付けの処理を使用します。ツールキットには`auto_chapter_map.py`、`chapter_replace.py`、`renumber.py`が含まれています。章のルールについては`references/chapter_patterns.md`を参照してください。

### 4. 本文の書式をクリーンアップする

基本的なクリーンアップ処理を使用して、テキスト内の一般的な書式の問題に対処します。ツールキットには`clean_basic.py`と、混入パターンの参照ファイル`references/pollution_patterns.md`が用意されています。

### 5. 整理結果を検証する

エンコーディング、章、書式の処理後に、検証処理を使用して結果を確認します。ツールキットには、整理後の出力を検証するための`validate.py`が用意されています。

## 関連リソース

ツールキットには、以下の補助リソースが含まれています。

- エンコーディング処理リファレンス: `references/encoding_guide.md`
- 章パターンリファレンス: `references/chapter_patterns.md`
- 混入パターンリファレンス: `references/pollution_patterns.md`
- クリーンアップ、章処理、検証用のプロンプトテンプレート: `templates/`ディレクトリ
- 進捗管理およびチャンク分割用スクリプト: `progress_manager.py`、`merge_progress.py`、`split_chunks.py`

Skillリポジトリ:
https://github.com/jy02534655/ux-skill/tree/8dae19f37c0c9925871fb752b7df3612d27bdfac/skills/novel-formatter

## 使用前に確認する情報

提供されている資料には、各スクリプトの具体的なコマンド、パラメータ、入出力ディレクトリのルール、処理方針が記載されていません。一括処理を開始する前に、メンテナーから`SKILL.md`の操作手順を入手するか、対象ファイルの範囲、章の基準、検証要件を確認してください。