webnovel-write by lingfengQAQ

---
name: webnovel-write
description: 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.
allowed-tools: Read Write Edit Grep Bash Task
---

# Chapter Writing Skill

## 0. 项目根校验（必须）

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

## 1. 模式定义

| 模式 | 启用步骤 | 说明 |
|------|---------|------|
| `/webnovel-write` | Step 1 → 1.5 → 2A → 2B → 3 → 4 → 5 → 6 | 标准流程 |
| `/webnovel-write --fast` | Step 1 → 1.5 → 2A → 3 → 4 → 5 → 6 | 跳过 Step 2B |
| `/webnovel-write --minimal` | Step 1 → 1.5 → 2A → 3(仅3个基础审查) → 4 → 5 → 6 | 跳过 Step 2B；不产出追读力数据 |

## 2. 引用加载策略（严格按需）

- L0：不提前加载参考。
- L1：只加载当前步骤的最小必需文件。
- L2：仅在触发条件满足时加载扩展参考。

### L1 最小集合

- Step 2A 前：`references/core-constraints.md`
- Step 4 前：`references/polish-guide.md`

### L2 条件集合

- 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`

## 3. 执行步骤

### 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 缺失时，明确提示先初始化。
- 任务书必须包含“反派层级”（无则标注“无”）。

### 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 2A：正文起草

- 遵循三原则：大纲即法律 / 设定即物理 / 发明需识别。
- 输出纯正文：`正文/第{NNNN}章.md`
- 开写前加载：

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

### Step 2B：风格适配（`--fast` / `--minimal` 跳过）

- 仅做风格转译，不改剧情事实。
- 细则见：`references/workflow-details.md`、`references/style-adapter.md`。

### Step 3：审查

调用约束：

- 必须使用 `Task` 工具调用各审查 subagent，禁止主流程直接内联“自审”替代。
- 可并行发起审查 Task，全部返回后统一汇总 `issues/severity/overall_score`。

默认核心 4 审查器：

- `consistency-checker`
- `continuity-checker`
- `ooc-checker`
- `reader-pull-checker`

关键章/卷末/用户明确要求时追加：

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

`--minimal` 模式仅运行前三个基础审查器，不产出追读力数据。

### 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。
- 这里执行去AI化与毒点规避规则（见 `polish-guide.md`）。

### 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
```

- `review_score` 优先使用 Step 3 的 `overall_score`；若最小模式未产出则传 `0` 并在 notes 标注 `minimal mode`。
- 债务利息默认关闭，仅在用户明确要求或开启追踪时执行（详见 `references/workflow-details.md`）。

### Step 6：Git 备份

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

## 4. 最小交付检查

- [ ] 正文文件已生成（章节编号正确）。
- [ ] 审查已执行（模式对应的最小集合）。
- [ ] 润色已处理 critical/high。
- [ ] data-agent 已回写状态与索引。
- [ ] Git 备份成功或已说明失败原因。

## 5. 参考入口

- 执行模板与细节统一以 `references/workflow-details.md` 为准。
- 写作硬约束以 `references/core-constraints.md` 为准。
- 润色规则以 `references/polish-guide.md` 为准。