Webnovel Write

A Chinese web novel writing pipeline that takes you from outline to published chapter through six enforced steps: context gathering, drafting, review, polishing, commit, and git backup. It won't let you skip or fake the review phase, uses separate subagents for context/review/data extraction instead of letting you handwave them, and blocks progression if there are issues like missed plot nodes or failed anti-AI checks. Built around a story-system that pulls constraints from master settings, volume configs, and chapter directives. The rigid state machine and CSV reference lookups feel heavy if you just want to draft quickly, but the separation between facts and projection plus the automatic conflict detection could save you from continuity disasters in longer serials.

skills.sh installs: 901
GitHub stars: 7.9K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add lingfengqaq/webnovel-writer --skill webnovel-write --agent claude-code

Installs into .claude/skills of the current project.

Files

写章流程

目标

产出可发布章节到 正文/第{NNNN}章-{title}.md。默认 2000-2500 字，用户/大纲另有要求时从之。

模式

模式	流程
默认	Step 1→2→3→4→5→6
`--fast`	Step 1→2→3(轻量)→4→5→6
`--minimal`	Step 1→2→3(写 no-review artifact)→4(仅排版)→5→6

硬规则

禁止并步、跳步、伪造审查
必须使用 Agent 工具调用指定 subagent；不得用主流程口头代替 subagent 输出
审查只跑一轮；blocking issue 定点修复或经用户裁决后才进 Step 4/5
失败只补跑失败步骤，不回退
参考资料按步骤按需加载

优先级

用户要求 > 状态机硬门槛 > 项目约束（总纲/设定/记忆）> skill 流程 > reference 建议

CSV 检索（Step 2 按需）

python -X utf8 "${SCRIPTS_DIR}/reference_search.py" --skill write --table {表名} --query "{关键词}" --genre {题材}

触发条件：新角色→命名规则，战斗→场景写法，多角色对话→写作技法，情感描写→写作技法，高频桥段→场景写法。

执行流程

准备：预检

export WORKSPACE_ROOT="${CLAUDE_PROJECT_DIR:-$PWD}"
export SCRIPTS_DIR="${CLAUDE_PLUGIN_ROOT:?}/scripts"
export SKILL_ROOT="${CLAUDE_PLUGIN_ROOT:?}/skills/webnovel-write"

python -X utf8 "${SCRIPTS_DIR}/webnovel.py" --project-root "${WORKSPACE_ROOT}" preflight
export PROJECT_ROOT="$(python -X utf8 "${SCRIPTS_DIR}/webnovel.py" --project-root "${WORKSPACE_ROOT}" where)"

python -X utf8 "${SCRIPTS_DIR}/webnovel.py" --project-root "${PROJECT_ROOT}" placeholder-scan --format text