# novel-project

> 创建规范化的小说工程文件夹结构，包含数据库、章节、进度管理等功能的完整写作项目管理体系。当用户需要开始新的小说写作项目时使用，自动生成标准化的目录结构和模板文件。

- Author: DannyJones
- Repository: YHIsMyLove/claude-code-marketplaces
- Version: 20251228200302
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-06
- Source: https://github.com/YHIsMyLove/claude-code-marketplaces
- Web: https://mule.run/skillshub/@@YHIsMyLove/claude-code-marketplaces~novel-project:20251228200302

---

---
name: novel-project
description: 创建规范化的小说工程文件夹结构，包含数据库、章节、进度管理等功能的完整写作项目管理体系。当用户需要开始新的小说写作项目时使用，自动生成标准化的目录结构和模板文件。
---

# Novel Project 技能

## 概述

此技能专门用于创建标准化的小说写作工程文件夹结构，为小说作者提供完整的项目管理解决方案。技能使用 Bun 运行时和 TypeScript 编写，支持自动生成文件夹结构、模板文件和进度管理。

## 核心功能

### 1. 项目结构生成
自动创建标准化的小说工程目录：
```
小说名/
├── 数据库/
│   ├── 人物设定/
│   ├── 世界观设定/
│   ├── 情节大纲/
│   ├── 素材收集/
│   └── 参考资料/
├── 章节/
│   ├── 第1章/
│   │   └── 第1章.md
│   └── ...
├── 进度.md
└── README.md
```

### 2. 模板系统
- 章节写作模板：包含章节概要、场景设置、正文、笔记等结构
- 进度管理模板：自动跟踪章节完成状态、字数统计、完成进度
- 人物设定模板：标准化的人物角色设定框架
- 项目说明文档：详细的使用指南和目录说明

### 3. 灵活配置
支持自定义项目参数：
- 章节数量（默认10章）
- 作者信息
- 小说类型/体裁
- 创建目录位置

## 使用流程

### 步骤1：收集项目信息
确定以下参数：
- 小说名称（必需）
- 作者名称（可选）
- 小说类型（可选）
- 章节数量（默认10章）
- 创建位置（默认当前目录）

### 步骤2：执行生成脚本
运行 `scripts/generate-novel-project.ts`：
```bash
bun run scripts/generate-novel-project.ts "小说名称" --chapters 20 --author "作者名" --genre "类型"
```

### 步骤3：验证创建结果
检查项目目录和文件是否正确生成。

## 使用场景

### 新小说项目创建
当用户开始新的小说创作时：
```
用户: 我想写一本名为"都市修仙传"的小说，帮我创建项目结构
Claude: 我来为你创建"都市修仙传"的小说工程项目，包含30章的目录结构
```

### 大型写作项目规划
对于需要系统管理的大型写作项目：
```
用户: 我要写一个50章的玄幻小说，作者是"网文作者"，类型是"东方玄幻"
Claude: 正在创建包含50章的玄幻小说项目结构，包含完整的人物设定和世界观管理
```

### 写作团队协作
为团队写作项目提供标准化结构：
```
用户: 我们团队要合写一部科幻小说，需要标准化的项目结构
Claude: 创建团队协作的小说工程项目，包含角色分工和进度管理功能
```

## 技能资源

### scripts/
- `generate-novel-project.ts`: TypeScript 主要脚本，使用 Bun 运行时
  - 参数解析和验证
  - 目录结构创建
  - 模板文件生成
  - 错误处理和用户反馈

### assets/
- `progress-template.md`: 进度管理文件模板
  - 项目基本信息记录
  - 章节完成状态跟踪
  - 字数统计和进度计算
  - 创作笔记和更新日志

### 配置文件
- `package.json`: Bun 运行时配置和依赖管理
- `tsconfig.json`: TypeScript 编译配置，支持现代 ES 特性

## 技术要求

- **运行时**: Bun >= 1.0.0
- **语言**: TypeScript
- **平台**: 跨平台（Windows、macOS、Linux）
- **依赖**: 仅需标准库，无外部依赖

## 特色优势

### 1. 标准化结构
提供经过验证的小说写作项目组织方式，分离创作内容和参考资料。

### 2. 自动化生成
一次性创建完整的项目结构，包含所有必要的模板和配置文件。

### 3. 进度管理
内置的进度跟踪系统帮助作者监控写作进展和目标完成情况。

### 4. 灵活扩展
模块化的结构设计支持后续功能扩展和个性化定制。

## 错误处理

技能包含完善的错误处理机制：
- 必需参数验证
- 文件系统权限检查
- 重复项目检测
- 清晰的错误提示和解决建议