ai-novelist: Instructions file for Claude Code

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

项目概述

这是一个 AI 辅助中文小说创作工作站，集成多个 Claude Code Skills，支持从大纲规划到成稿输出的完整创作流程。

核心技能 (Skills)

项目集成了以下 Claude Code Skills，通过 /skill-name 调用：

• chinese-novelist - 分章节创作中文小说（3000-5000字/章）
• humanizer-zh - 去除 AI 生成痕迹，24 种模式检测
• novelist-analyst - 叙事结构分析和角色弧光评估
• docx - Word 文档生成和编辑
• planning-with-files - 文件化任务规划（task_plan.md, findings.md, progress.md）
• frontend-design - 前端界面设计（用于阅读器等）

Python 环境

必须使用 uv 运行所有 Python 脚本：

# 添加依赖
uv add <package-name>

# 执行脚本
uv run <script.py>

Python 版本要求：>= 3.12

关键脚本

字数检查

# 检查单章
uv run .claude/skills/chinese-novelist/scripts/check_chapter_wordcount.py novels/<小说名>/第01章.md

# 检查全部章节
uv run .claude/skills/chinese-novelist/scripts/check_chapter_wordcount.py --all novels/<小说名>

阅读器生成

每个小说目录下有 build_reader.py，用于生成单文件 HTML 阅读器：

cd novels/<小说名>
uv run build_reader.py

项目结构

novelist-test/
├── novels/                    # 小说作品目录
│   └── <小说名>/
│       ├── 00-大纲.md         # 故事概述、章节规划
│       ├── 01-人物档案.md     # 主角、反派、配角档案
│       ├── 02-风格参考手册.md # 仿写风格分析（可选）
│       ├── 03-审查报告.md     # 质量审查结果（可选）
│       ├── 第01章.md          # 章节正文
│       ├── build_reader.py    # 阅读器生成脚本
│       └── reader.html        # 生成的阅读器
├── references/                # 仿写参考作品
│   └── *.txt                  # 参考小说原文
├── qimao/                     # 七猫平台相关资料
├── .claude/skills/            # Claude Code Skills
└── pyproject.toml             # Python 依赖配置

创作工作流

标准创作流程（3 阶段）

1. 阶段 1：规划 - 使用 chinese-novelist 生成大纲和人物档案
2. 阶段 2：创作 - 使用 chinese-novelist 逐章创作，每章 3000-5000 字
3. 阶段 3：润色 - 使用 humanizer-zh 去除 AI 痕迹

仿写工作流（6 阶段）

1. Phase 1：拆书分析 - 分析参考作品风格 → 02-风格参考手册.md
2. Phase 2：骨架搭建 - 使用 chinese-novelist 生成大纲和人物档案
3. Phase 3：逐章创作 - 使用 chinese-novelist 串行执行，短剧爽文节奏（2500-3500字/章）
4. Phase 4：润色去AI - 使用 humanizer-zh 检测，可并行处理
5. Phase 5：质量审查 - 8 维度评分 + 连贯性检查
6. Phase 6：输出成稿 - 合并章节 + 生成 Word 文档