catalog/repos/aicoder2048--story-writer.md

338 lines
11 KiB
Markdown
Raw Permalink Normal View History

2026-04-07 11:44:56 +08:00
# AI多类型小说自动创作
`小说生成` `Claude Code` `科幻` `武侠` `童话` `PDF导出` `创作工具`
# StoryWriter - AI小说创作系统
基于 Claude Code 的短篇小说自动创作系统,支持科幻、武侠、童话三种类型的小说创作。
## 功能特性
- **多类型支持**:科幻、武侠、童话三种小说类型
- **两种创作模式**:交互式创作 / 一键自动生成
- **专业创作指导**每种类型配备专属技能包Skill
- **完整创作流程**:大纲 → 人物 → 目录 → 章节 → PDF导出
- **风格化写作**:每种类型有独特的写作风格和方法论
---
## 快速开始
### 前置要求
- [Claude Code CLI](https://claude.com/claude-code) 已安装并配置
- 项目目录已初始化
### 使用方式
在 Claude Code 中使用斜杠命令:
```bash
# 一键生成完整小说(推荐)
/kehuan_writer_auto <故事名> <story_spec文件路径>
/wuxia_writer_auto <故事名> <story_spec文件路径>
/tonghua_writer_auto <故事名> <story_spec文件路径>
# 交互式创作(逐步引导)
/kehuan_writer <故事名>
/wuxia_writer <故事名>
/tonghua_writer <故事名>
```
---
## 创作命令详解
### 1. 科幻小说 `/kehuan_writer`
**风格特点**:融合阿西莫夫的逻辑严密与刘慈欣的宏大格局
| 命令 | 说明 | 参数 |
|------|------|------|
| `/kehuan_writer` | 交互式创作 | `<故事名>` |
| `/kehuan_writer_auto` | 一键生成 | `<故事名> <story_spec路径>` |
**创作元素**
- 硬核科技设定
- 宇宙尺度叙事
- 理性思辨对话
- 文明冲突与终极思考
### 2. 武侠小说 `/wuxia_writer`
**风格特点**:传承金庸武侠的典雅古风与侠义精神
| 命令 | 说明 | 参数 |
|------|------|------|
| `/wuxia_writer` | 交互式创作 | `<故事名>` |
| `/wuxia_writer_auto` | 一键生成 | `<故事名> <story_spec路径>` |
**创作元素**
- 古风典雅文笔
- 江湖恩怨情仇
- 武功招式描写
- 侠义精神内核
### 3. 童话小说 `/tonghua_writer`
**风格特点**:诗意优美的童话语言与温暖治愈的故事
| 命令 | 说明 | 参数 |
|------|------|------|
| `/tonghua_writer` | 交互式创作 | `<故事名>` |
| `/tonghua_writer_auto` | 一键生成 | `<故事名> <story_spec路径>` |
**创作元素**
- 诗意优美语言
- 奇幻魔法世界
- 温暖治愈主题
- 寓教于乐内涵
---
## Story Spec 文件格式
一键生成模式需要提供 `story_spec` 文件,定义故事的核心设定。
### 文件位置
```
story_specs/
├── 你的故事名.md
└── ...
```
### 文件格式
```markdown
## Q1核心创意世界观/背景设定)
描述故事发生的世界、时代背景、核心设定...
## Q2核心冲突主要矛盾/戏剧张力)
描述故事的核心矛盾、冲突来源...
## Q3主角设定人物设计/成长轨迹)
描述主角的身份、特点、内心矛盾...
```
### 示例:科幻故事 Spec
```markdown
## Q1核心创意
2247年超级智能LOGOS完成了对人类文明的统一建模
宣布人类成为"可预测文明"。银河系高等文明提出"温和收束"方案...
## Q2核心冲突
AGI与高等文明认为人类已被完全理解可进入"文明休眠态"
但存在无法被预测的异常个体,成为决定人类命运的关键变量...
## Q3主角设定
主角是一名文明归档校对员,被标记为"Low Utility"。
他坚持做"不必要"的事情——写一本没有读者的小说...
```
---
## 创作流程
### 一键生成模式(`*_auto`
```
┌─────────────────────────────────────────────────────────┐
│ /kehuan_writer_auto 不必要的存在 story_specs/xxx.md │
└─────────────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────────────┐
│ 阶段 1初始化 │
│ - 读取 story_spec 文件 │
│ - 创建项目目录结构 │
└─────────────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────────────┐
│ 阶段 2-4创作规划 │
│ - 生成 outline.md故事大纲2000-3000字
│ - 生成 character.md人物小传
│ - 生成 chapter_index.md5章目录
└─────────────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────────────┐
│ 阶段 5-9章节创作 │
│ - 创作 Chapter-01.md ~ Chapter-05.md │
│ - 每章 2000-3000 字 │
│ - 自动读取前章确保连贯性 │
└─────────────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────────────┐
│ 阶段 10PDF导出 │
│ - 转换所有章节为PDF格式 │
│ - 应用复古纸张样式 │
└─────────────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────────────┐
│ 阶段 11完成报告 │
│ - 文件清单 + 字数统计 + 耗时统计 │
└─────────────────────────────────────────────────────────┘
```
### 交互式创作模式
1. **启动命令**`/kehuan_writer 我的故事`
2. **回答问题**系统会询问Q1/Q2/Q3三个核心问题
3. **生成大纲**:基于回答创作故事大纲
4. **逐步完善**:可以修改大纲、人物、章节
5. **章节创作**:使用 `/kehuan-skill write chapter N` 创作指定章节
---
## 生成文件结构
```
故事名/
├── outline.md # 故事大纲(起承转合结构)
├── character.md # 人物小传(主角/配角/对立角色)
├── chapter_index.md # 章节目录5章规划
└── chapters/
├── Chapter-01.md # 第1章正文
├── Chapter-01.pdf # 第1章PDF
├── Chapter-02.md
├── Chapter-02.pdf
├── Chapter-03.md
├── Chapter-03.pdf
├── Chapter-04.md
├── Chapter-04.pdf
├── Chapter-05.md
└── Chapter-05.pdf
```
---
## 技能包说明
每种小说类型配备专属技能包Skill提供
| 组件 | 说明 |
|------|------|
| `SKILL.md` | 技能核心配置和执行流程 |
| `Outline-method.md` | 大纲创作方法论 |
| `Output-style.md` | 写作风格指南 |
| `templates/` | 文档格式模板 |
| `examples/` | 创作示例参考 |
### 技能包位置
```
.claude/skills/
├── kehuan-skill/ # 科幻创作技能包
├── wuxia-skill/ # 武侠创作技能包
└── tonghua-skill/ # 童话创作技能包
```
---
## 使用示例
### 示例1一键生成科幻小说
```bash
# 1. 创建 story_spec 文件
# story_specs/时间囚徒.md
# 2. 执行一键生成
/kehuan_writer_auto 时间囚徒 story_specs/时间囚徒.md
# 3. 等待约15-20分钟获得完整小说
```
### 示例2交互式创作武侠小说
```bash
# 1. 启动交互式创作
/wuxia_writer 龙吟月下
# 2. 根据提示回答三个核心问题
# Q1: 描述武侠世界的背景设定...
# Q2: 描述核心冲突和矛盾...
# Q3: 描述主角的身份和特点...
# 3. 系统生成大纲,可以修改完善
# 4. 继续创作人物、目录、章节
```
### 示例3单独创作某一章节
```bash
# 在已有项目基础上,创作或重写某一章
/kehuan-skill write chapter 3
```
---
## 常见问题
### Q一键生成需要多长时间
A通常需要 15-20 分钟完成全部创作,包括:
- 大纲2-3 分钟
- 人物1-2 分钟
- 目录约1 分钟
- 每章1-3 分钟
- PDF导出约1 分钟
### Q如何修改已生成的内容
A可以直接编辑对应的 `.md` 文件,或使用交互式命令重新生成特定部分。
### Q支持自定义写作风格吗
A可以修改 `.claude/skills/<type>-skill/Output-style.md` 来调整写作风格。
### Q生成的PDF使用什么样式
A默认使用复古纸张样式`vintage-paper.css`),可在 `.claude/skills/md2pdf/assets/` 中查看或修改。
---
## 项目结构
```
StoryWriter/
├── README.md # 本文件
├── .claude/
│ ├── commands/ # 创作命令
│ │ ├── kehuan_writer.md
│ │ ├── kehuan_writer_auto.md
│ │ ├── wuxia_writer.md
│ │ ├── wuxia_writer_auto.md
│ │ ├── tonghua_writer.md
│ │ └── tonghua_writer_auto.md
│ └── skills/ # 创作技能包
│ ├── kehuan-skill/
│ ├── wuxia-skill/
│ ├── tonghua-skill/
│ └── md2pdf/
├── story_specs/ # 故事规格文件
│ └── *.md
└── [故事目录]/ # 生成的小说项目
├── outline.md
├── character.md
├── chapter_index.md
└── chapters/
```
---
## 许可证
MIT License
---
## 致谢
- [Claude Code](https://claude.com/claude-code) - AI编程助手
- [Anthropic](https://anthropic.com) - Claude AI