SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场webnovel-plan

webnovel-plan

写作与研究

查看项目

更新于 10-15 15:30

技能介绍

用途

webnovel-plan 是网文写作流程中的规划技能，主 agent 基于已有总纲增量细化卷纲、时间线和章纲，把新增设定写回设定集，并刷新 Story System 写作合同。它不重做全局故事，不重写整份总纲或设定集，只做增量补齐。

主要能力

  • 补齐设定基线：让世界观、力量体系、主角卡、反派设计从骨架进入可规划、可写作状态。
  • 生成卷节拍表：必须填写中段反转，危机链至少 3 次递增，卷末新钩子能落到最后一章的章末未闭合问题。
  • 生成卷时间线表：明确时间体系与本卷时间跨度，有倒计时事件时列出并标记 D-N。
  • 生成卷纲骨架：明确卷摘要、关键人物与反派层级、Strand 分布、爽点密度规划、伏笔规划、约束触发规划。
  • 批量生成章纲：默认 10 章/批，复杂题材或多线并进降到 8 章/批，简单升级流放宽到 12 章/批，不建议单批超过 12 章。每章包含目标、阻力、代价、时间锚点、章内时间跨度、与上章时间差、倒计时状态、爽点、Strand、反派层级、视角/主角、关键实体、本章变化、章末未闭合问题、钩子，以及结构化节点 CBN、CPNs、CEN、必须覆盖节点、本章禁区。
  • 设定回写：新角色写入角色卡或角色组，新势力/地点/规则写入世界观或力量体系，新反派层级写入反派设计。
  • 验证与状态更新：检查节拍表、时间线表、详细大纲存在且非空，每章时间字段齐全，时间线单调递增，倒计时推进正确，新设定已回写，BLOCKER=0。
  • 刷新 Story System 写作合同：生成 .story-system/MASTER_SETTING.json、volumes/、chapters/、reviews/ 等后续写作主链输入。

使用方式

技能通过环境变量与脚本调用执行，主要命令包括：

export WORKSPACE_ROOT="${CLAUDE_PROJECT_DIR:-$PWD}"
export SKILL_ROOT="${CLAUDE_PLUGIN_ROOT}/skills/webnovel-plan"
export SCRIPTS_DIR="${CLAUDE_PLUGIN_ROOT}/scripts"
export PROJECT_ROOT="$(python "${SCRIPTS_DIR}/webnovel.py" --project-root "${WORKSPACE_ROOT}" where)"

规划开始与结束都运行 placeholder-scan。执行流程分 Step 1 至 Step 10：加载项目数据并确认前置条件、补齐设定基线、选择目标卷并确认范围、生成卷节拍表、生成卷时间线表、生成卷纲骨架、批量生成章纲、把新增设定写回现有设定集、验证保存并更新状态、刷新 Story System 写作合同。

关键脚本调用示例：

python "${SCRIPTS_DIR}/webnovel.py" --project-root "$PROJECT_ROOT" master-outline-sync \
  --volume {volume_id} \
  --writeback-file "大纲/第{volume_id}卷-总纲写回.json" \
  --format text

python "${SCRIPTS_DIR}/webnovel.py" --project-root "$PROJECT_ROOT" update-state -- \
  --volume-planned {volume_id} \
  --chapters-range "{start}-{end}"

python -X utf8 "${SCRIPTS_DIR}/webnovel.py" --project-root "${PROJECT_ROOT}" story-system "${CHAPTER_GOAL}" \
  --genre "${GENRE}" --chapter {chapter_num} --persist --emit-runtime-contracts --format both

适用场景

适用于已有总纲、需要按卷推进网文创作的场景，尤其是需要把总纲细化为可写作的卷纲、时间线和章纲，并保持跨卷一致性（伏笔回收、角色关系延续、主角能力承接）的连载型网文项目。

限制

  • 项目根不合法或总纲缺失时阻断。
  • 总纲缺少卷名/章节范围/核心冲突/卷末高潮时阻断并请求用户补全。
  • 发现设定冲突时标记 BLOCKER，等待用户裁决。
  • 批量拆章时时间回跳且未标注闪回时阻断当前批次。
  • 验证失败时只重做失败批次，不覆盖整卷。
  • 进入写章前不得保留当前章相关实体的 [待...] / 暂名 / {占位}。
  • 向后兼容：旧项目章纲缺失结构化字段时，下游流程正常执行，仅跳过结构化检查。

优先级链

用户明确要求 > 总纲核心冲突与卷末高潮 > 时间线硬约束 > skill 默认流程 > reference 建议。