# Long Novelist

> |

- **Type:** Skill
- **Install:** `agentstack add skill-tianshiemo7-long-novelist-skill-long-novelist-skill`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [tianshiemo7](https://agentstack.voostack.com/s/tianshiemo7)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [tianshiemo7](https://github.com/tianshiemo7)
- **Source:** https://github.com/tianshiemo7/long-novelist-skill

## Install

```sh
agentstack add skill-tianshiemo7-long-novelist-skill-long-novelist-skill
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Long Novelist: 百万字长篇小说创作助手

## 核心设计理念

本技能面向**百万字级**长篇小说创作，核心差异在于：

1. **持久化至上**：所有状态、角色、伏笔均落盘，确保跨会话一致性
2. **用户主导节奏**：不自动连写，每章写完后展示并等待用户反馈
3. **副本弧线驱动**：以故事副本（Arc）为规划单元，而非死板规定每章内容。整体大纲列出副本序列，每个副本自含起承转合；细纲描述副本的发展过程，不规定"第X章写Y事件"，章节边界在写作中自然浮现
4. **起承转合**：每个副本内部拥有完整的起承转合，全书和每卷也遵循起承转合铁律
5. **角色状态追踪**：每个副本记录角色的"进入状态"和"离开状态"，确保人物弧线在百万字尺度上的连贯演进
6. **伏笔管理系统**：追踪每个伏笔的铺设与回收状态，按副本粒度管理

## 项目文件结构

每个小说项目创建以下文件：

```
./long-novelist/{YYYYMMDD-HHmmss}-{小说名称}/
├── 00-剧情梗概.md              # 百万字剧情总览，跨会话参考
├── 01-整体大纲.md              # 副本序列大纲：列出所有副本，每个副本含起承转合概要、弹性章节范围、角色状态变化
├── 02-细纲.md                  # 副本发展过程：每个副本的起承转合具体展开，不规定章节分配
├── 03-角色档案/                # 角色信息（解耦为独立文件）
│   ├── 角色索引.md              # 快速查找入口（按ID/副本/分组）
│   ├── 角色关系.md              # 所有角色关系 + 分组（势力/阵营/临时同盟等）
│   └── 角色/                    # 每个角色一个子文件夹
│       ├── {角色名}/
│       │   └── 角色信息.md       # YAML frontmatter + Markdown正文（含副本级状态追踪表）
│       └── ...
├── 04-伏笔清单.json            # 所有伏笔及回收状态（按副本粒度管理）
├── 05-写作计划.json            # 章节写作状态追踪（章节号在写作时动态分配）
├── 06-风格设定.md              # 写作风格、模仿对象、语言规范
├── 07-分卷规划.md              # 百万字分卷（每卷含若干副本）
├── 08-写作动态.md              # 跨会话恢复第一入口（当前位置/近5章/伏笔紧急清单/下次准备清单）
├── chapters/                   # 章节内容文件夹（txt格式）
│   ├── 第01章-xxx.txt
│   ├── 第02章-xxx.txt
│   └── ...
└── summaries/                  # 已完成内容的摘要
    ├── 卷一摘要.md
    └── ...
```

## 核心流程概览

### 第0步：初始化与续写检测
进入时读取项目状态，检测是否有未完成项目。 → [phase0-initialization.md](references/flows/phase0-initialization.md)

### 第一阶段：自主配置（交互式问答）
用户自主控制：题材、每章字数、写作风格、模仿对象。 → [phase1-config.md](references/flows/phase1-config.md)

### 第二阶段：大纲与细纲规划（副本嵌套层级）

用户提供创意种子 → AI加工为大副本序列（每个大副本含总目标+起承转合概要）→ **画出嵌套流程图给用户审核** → 用户确认 → 展开小副本和微副本 → 创建所有项目文件。 → [phase2-planning.md](references/flows/phase2-planning.md)

**三层副本包含关系**（默认三层，灵活调整）：
- **大副本**决定动力方向（如"复兴宗门"，50-150章）
- **小副本**展开具体事件（如"采集药材""开设坊市"，8-25章，各有独立起承转合）
- **微副本**填充场景细节（如"采药遇险""偶然得宝"，1-3章，服务于小副本的起承转合各阶段）

### 第三阶段：逐章写作（用户驱动）
用户说"开始写作"→ 写一章 → 输出txt到屏幕 → 等待用户反馈 → 修改或继续。 → [phase3-writing.md](references/flows/phase3-writing.md)

### 第四阶段：大纲辅助（按需触发）
用户询问后续大纲时，联网搜索提供创作建议。 → [phase4-outline-help.md](references/flows/phase4-outline-help.md)

---

## 写作技法指南

以下指南在创作每章时作为写作质量参考：

- [章节写作规范](references/guides/chapter-guide.md) — 十种开头技巧、打破读者预期、中文文学技法（白描/留白/意象/草蛇灰线）、章节质量检查清单
- [章节创作模板](references/guides/chapter-template.md) — TXT文件输出格式、章节内部结构、每章必须包含的元素
- [对话写作规范](references/guides/dialogue-writing.md) — 潜台词技巧、节奏控制、沉默的戏剧力量、对话中的权力博弈
- [内容扩充技巧](references/guides/content-expansion.md) — 场景肌理充实、关键时刻放慢、内心世界展开、感官维度叠加、防注水原则
- [人物塑造指南](references/guides/character-guide.md) — 矛盾创造深度、侧面揭示技法、主角/反派/配角设计、人物关系设计、长篇人物管理
- [角色状态管理](references/guides/character-state-management.md) — 状态持久化、位置追踪、关系演化日志、每章更新检查清单、被遗忘角色检测
- [伏笔管理指南](references/guides/foreshadowing-guide.md) — 伏笔铺设/回收技法、JSON管理操作、定期检查机制
- [长篇大纲编写指南](references/guides/outline-guide.md) — 起承转合四段设计、悬念弧线编排、节奏控制呼吸法则、世界观展开节奏
- [风格模仿指南](references/guides/style-imitation.md) — 联网搜索分析流程、风格卡片提取、模仿层级
- [标题创作指南](references/guides/title-guide.md) — 五种标题创作技巧、质量标准、百万字长篇标题考量
- [悬念钩子技法](references/guides/hook-techniques.md) — 悬念钩子十三式、章首引子七式、悬念编排策略、跨章悬念弧设计
- [情节结构模板](references/guides/plot-structures.md) — 起承转合/三幕式/英雄之旅/悬疑/言情/反转/多线叙事结构模板
- [副本模板与设计速查](references/guides/arc-template.md) — 六种常见副本类型模板（入门/挑战/对抗/揭露/低谷/集结）+ 副本设计自检清单
- [断章卡点技巧](references/guides/chapter-break-techniques.md) — 十大黄金卡点位置、卡点强度分级、多章连卡节奏编排
- [用户偏好持久化](references/guides/user-preferences-system.md) — 偏好存储/自动学习/跨会话一致性/feadbackPatterns自动记录

## 实用工具

- [字数检查脚本](scripts/check_wordcount.py) — 检查单章或批量检查所有章节的中文字数（适配TXT格式）

## 网文素材库

写作时按需查阅以下素材文件，提升效率与质量：

- [高频词替换表](references/素材库/01-高频词替换表.md) — 连接词/弱动词/高频词/对话标签的升级替换，AI味高频词清除清单
- [情绪描写速查](references/素材库/02-情绪描写速查.md) — 愤怒/悲伤/高兴/恐惧/惊讶/紧张的层级递进表+身体反应写法
- [动作神态对话素材](references/素材库/03-动作神态对话素材.md) — "看/笑/愣"的N种写法、对话标签系统、肢体动作速查
- [人物外貌描写素材](references/素材库/04-人物外貌描写素材.md) — 眼睛/眉/发型/面容/身材/气质的分维度词汇+四技法
- [场景描写素材](references/素材库/05-场景描写素材.md) — 七步造景法、战斗/城市/废墟/自然/宫殿素材、空间情绪配方
- [玄幻修炼设定素材](references/素材库/06-玄幻修炼设定素材.md) — 修仙境界体系、功法品阶、技能名称库、装备/丹药/资质设定
- [桥段爽点素材](references/素材库/07-桥段爽点素材.md) — 四大黄金法则、六种爽点类型、打脸公式、六流派模板、爽点递进节奏
- [黄金开篇素材](references/素材库/08-黄金开篇素材.md) — 黄金开篇核心公式、三章逐章任务、各题材开篇模板、2025开篇硬规则
- [言情甜宠桥段素材](references/素材库/09-言情甜宠桥段素材.md) — 追妻火葬场七步法、暧昧期十大节点、告白桥段库、甜宠/虐恋公式
- [服饰衣着描写素材](references/素材库/10-服饰衣着描写素材.md) — 古风服饰形制/面料纹样/首饰配件、现代穿搭描写、各题材服饰快查
- [多题材专题素材](references/素材库/11-多题材专题素材.md) — 悬疑推理/历史古风/科幻末世/无限流四大题材核心技法

---

## 五大黄金法则

### 1. 展示而非讲述
用动作、对话、细节表现，不要直接陈述。坏："他很愤怒"。好："他捏碎了手中的茶杯，碎片扎进掌心，血顺着指缝往下淌，他浑然不觉。"

### 2. 冲突驱动剧情
每章必须有至少一个冲突点（人物冲突/内心冲突/环境冲突），推动剧情前进。没有冲突的章节应删除或重构。

### 3. 悬念承上启下
每章结尾必须有钩子，让读者产生"下一章必须看"的冲动。参考悬疑钩子技法。

### 4. 人物驱动情节
情节服务于人物成长。每个人物的行为必须符合其性格核心和致命缺陷。让人物的选择推动故事，而不是作者安排。

### 5. 伏笔即是契约
铺设的每一个伏笔都是对读者的承诺。伏笔必须记录在案，并在适当时候回收。不允许"挖坑不填"。

### 6. 副本自治，章节弹性
每个副本是一个自洽的故事单元，拥有独立的起承转合。副本不规定"应该有多少章"——章节数量由副本发展过程的自然节奏决定。写作者在每个副本内部自由决定章节断点，不必死守预设的章节数。

### 7. 状态可追踪，弧线可验证
每个角色的关键状态（性格阶段、能力水平、关系深度、心理状态）在进入和离开每个副本时必须被记录和验证。百万字尺度上，角色的每一步变化都要有据可查。

---

## 起承转合：长篇结构铁律

百万字长篇小说必须在**全书、每卷、每个副本**三个层级遵循起承转合结构：

### 全书级起承转合

| 阶段 | 占比 | 核心任务 | 写作重点 |
|------|------|---------|---------|
| **起** | 20% | 建立世界观、引入主角、铺设核心冲突 | 人物弧线起点、日常世界、激励事件 |
| **承** | 30% | 冲突升级、人物成长、支线展开 | 能力提升、盟友加入、反派施压 |
| **转** | 30% | 重大转折、真相揭露、人物蜕变 | 背叛/牺牲、世界观颠覆、主角觉醒 |
| **合** | 20% | 最终对决、伏笔回收、结局收束 | 高潮决战、情感高潮、余韵 |

### 副本级起承转合

每个副本内部也拥有完整的小型起承转合：

| 阶段 | 在该副本中的作用 |
|------|-----------------|
| **起** | 进入新场景/新挑战，建立副本的核心冲突和规则 |
| **承** | 冲突展开，角色尝试解决问题但遭遇挫折 |
| **转** | 意外发生——规则被打破/真相浮现/角色做出关键选择 |
| **合** | 副本冲突解决，角色获得成长/失去/领悟，引出下一副本的钩子 |

这种"大起承转合套小起承转合"的结构确保每个副本既独立成章又服务于全书主线。

---

## 关键共享机制

### 字数配置
- 用户可在配置阶段设定每章字数（默认4000字）
- 每章完成后自动统计字数
- TXT文件使用纯文本格式，不含Markdown标记

### 风格一致性保障
- 每次写作前读取 `06-风格设定.md`
- 每次写作前读取 `03-角色档案/角色索引.md` 定位出场角色，再读取对应 `03-角色档案/角色/{角色名}/角色信息.md` 确保人物言行一致
- 每次写作前读取 `03-角色档案/角色关系.md` 确认角色间关系张力
- 每次写作前读取 `04-伏笔清单.json` 检查本章应铺设/回收的伏笔
- 每写完一章更新 `00-剧情梗概.md` 追加本章摘要
- 每写完一章更新 `08-写作动态.md` 刷新当前位置、活跃角色、伏笔紧急清单

### 中断续写
- 跨会话恢复时，**首先读取 `08-写作动态.md`** 获取当前状态快照
- 其次读取 `05-写作计划.json` 确认写作进度、当前副本、暂停中的副本
- 展示最近完成章节摘要和下次写作准备清单
- 如有暂停中的副本，询问"继续当前副本 or 切回暂停的副本？"
- 从下一章继续，不重写已完成内容

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [tianshiemo7](https://github.com/tianshiemo7)
- **Source:** [tianshiemo7/long-novelist-skill](https://github.com/tianshiemo7/long-novelist-skill)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-tianshiemo7-long-novelist-skill-long-novelist-skill
- Seller: https://agentstack.voostack.com/s/tianshiemo7
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.