webnovel-write

Original：🇺🇸 English

Translated

Writes webnovel chapters (3000-5000 words). Use when the user asks to write a chapter or runs /webnovel-write. Runs context, drafting, review, polish, and data extraction.

4installs

Sourcelingfengqaq/webnovel-writer

Added on2026-02-14

NPX Install

npx skill4agent add lingfengqaq/webnovel-writer webnovel-write

SKILL.md Content

View Translation Comparison →

Chapter Writing Skill

Project Root Guard（必须先确认）

必须在项目根目录执行（需存在
```
.webnovel/state.json
```
）
若当前目录不存在该文件，先询问用户项目路径并
```
cd
```
进入
进入后设置变量：
```
$PROJECT_ROOT = (Resolve-Path ".").Path
```

Default flow

Context Agent → 创作任务书
写作 → 3000-5000字正文
审查 → 核心4个Checker
润色 → 修复问题
Data Agent → 提取数据
Git → 备份

Modes

```
/webnovel-write
```
：标准流程（含核心4个Checker）
```
/webnovel-write --fast
```
：跳过 Step 2B，其余同标准
```
/webnovel-write --minimal
```
：跳过 Step 2B，仅运行 consistency + continuity + ooc（不产出追读力数据）

Step 1: Context Agent

使用 Task 工具调用

context-agent

：

调用 context-agent，参数：
- chapter: {chapter_num}
- project_root: {PROJECT_ROOT}
- storage_path: .webnovel/
- state_file: .webnovel/state.json

缺失处理：大纲或 state.json 不存在时，提示用户先初始化。

要求：创作任务书必须包含“反派层级”（从大纲/章纲提取）。

Step 1.5: Contract v2 Guidance 注入

bash

python "${CLAUDE_PLUGIN_ROOT}/scripts/extract_chapter_context.py" --chapter {chapter_num} --project-root "{PROJECT_ROOT}" --format json

必须读取：
```
writing_guidance.guidance_items
```

推荐读取：

reader_signal

与

genre_profile.reference_hints

Step 2: 写作

遵循三大原则：大纲即法律 / 设定即物理 / 新实体需记录。
输出纯正文到
```
正文/第{NNNN}章.md
```
。
章节内容需体现本章“反派层级”要求（无反派层级时标注“无”）。
开写前加载核心约束：

bash

cat "${CLAUDE_PLUGIN_ROOT}/skills/webnovel-write/references/core-constraints.md"

场景写作与风格参考按需加载（见

references/workflow-details.md

）。

Reference Loading Levels (strict, lazy)

L0: 不加载额外参考，直到当前 step 明确。
L1: 仅加载本 step 的最小必需文件。
L2: 仅在触发条件满足时加载扩展参考。

L1 (minimum)

Step 2 写作前：
```
references/core-constraints.md
```
Step 4 润色前：
```
references/polish-guide.md
```

L2 (conditional)

仅当 Step 1.5 需要风格/体裁细化时加载：

```
references/style-variants.md
```

.claude/references/reading-power-taxonomy.md

```
.claude/references/genre-profiles.md
```

references/writing/genre-hook-payoff-library.md

（电竞/直播文/克苏鲁优先）

仅当需要模板细节时加载：

```
references/workflow-details.md
```
```
references/writing/typesetting.md
```

Step 3: 审查

默认核心4个 Checker：

```
consistency-checker
```
```
continuity-checker
```
```
ooc-checker
```
```
reader-pull-checker
```
（用于写入追读力数据）

关键章/卷末/用户明确要求：额外运行

```
high-point-checker
```
```
pacing-checker
```

审查汇总表格与审查指标 JSON 模板见

references/workflow-details.md

。

Step 4: 润色

加载润色参考：

bash

cat "${CLAUDE_PLUGIN_ROOT}/skills/webnovel-write/references/polish-guide.md"
cat "${CLAUDE_PLUGIN_ROOT}/skills/webnovel-write/references/writing/typesetting.md"

先修复 critical/high，再处理 medium/low。

Step 5: Data Agent

使用 Task 工具调用

data-agent

：

调用 data-agent，参数：
- chapter: {chapter_num}
- chapter_file: "正文/第{NNNN}章.md"
- review_score: {overall_score from Step 3}
- project_root: {PROJECT_ROOT}
- storage_path: .webnovel/
- state_file: .webnovel/state.json

债务利息计算默认关闭，仅在开启债务追踪或用户明确要求时执行（见

references/workflow-details.md

）。

Step 6: Git 备份

bash

git add . && git commit -m "Ch{chapter_num}: {title}"

详细流程与模板（按需加载）

需要以下内容时，读取：

```
references/workflow-details.md
```
- Step 1.5 章节设计（钩子/爽点/微兑现/差异化）
- 审查汇总表格 + 审查指标 JSON 模板
- 润色硬规则 + 检查清单
- 债务/Override 处理与利息开关

Step 1.5 需要时可直接加载（避免深层引用）：

```
references/style-variants.md
```

.claude/references/reading-power-taxonomy.md

```
.claude/references/genre-profiles.md
```

webnovel-write

NPX Install

Tags

SKILL.md Content

Chapter Writing Skill

Project Root Guard（必须先确认）

Default flow

Modes

Step 1: Context Agent

Step 1.5: Contract v2 Guidance 注入

Step 2: 写作

Reference Loading Levels (strict, lazy)

L1 (minimum)

L2 (conditional)

Step 3: 审查

Step 4: 润色

Step 5: Data Agent

Step 6: Git 备份

详细流程与模板（按需加载）