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

webnovel-write

写作与研究

查看项目

更新于 10-15 14:34

技能介绍

用途

webnovel-write 用于产出可发布的章节，目标文件为 正文/第{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。
  • 预检与占位符扫描：通过 webnovel.py 的 preflight、where、placeholder-scan 等命令确认项目环境。
  • 刷新合同树：从 .webnovel/state.json 读取 genre，调用 story-system 生成运行时合同，并用 write-gate 的 prewrite 阶段校验必备文件（MASTER_SETTING.json、volume_{NNN}.json、chapter_{NNN}.review.json）。
  • 写作任务书：必须通过 Agent 工具调用 context-agent 生成，按“本章硬性约束 → CBN/CPNs/CEN → 本章禁区 → 风格指引 → dynamic_context 补充参考”的顺序输出五段任务书。
  • 起草正文：只根据任务书起草，输出纯正文，无占位符，中文思维写作。
  • 审查：必须通过 Agent 工具调用 reviewer，只返回严格 schema JSON；主流程负责写入 review_results.json，再运行 review-pipeline 生成标准 artifact 与审查报告。审查只跑一轮，blocking 问题定点修复或经用户裁决。
  • 润色：按 polish-guide.md 的执行顺序修复非 blocking issue → 风格适配 → 排版 → Anti-AI 终检；只改表达不改事实。
  • 提交：通过 Agent 工具调用 data-agent 产出 fulfillment_result、disambiguation_result、extraction_result 三份 JSON，再运行 precommit gate、只读 git diff 校验、chapter-commit，并验证 projection 五项（state/index/summary/memory/vector）。
  • 备份：通过 webnovel.py backup 命令以解析后的 PROJECT_ROOT 为准执行 Git 备份。
  • 断点续跑：通过 run-ledger write-resume 读取可信断点，给出续跑建议，不自动覆盖文件。

使用方式

技能以命令行脚本驱动，核心命令包括：

python -X utf8 "${SCRIPTS_DIR}/webnovel.py" --project-root "${WORKSPACE_ROOT}" preflight
python -X utf8 "${SCRIPTS_DIR}/webnovel.py" --project-root "${PROJECT_ROOT}" placeholder-scan --format text
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
python -X utf8 "${SCRIPTS_DIR}/webnovel.py" --project-root "${PROJECT_ROOT}" write-gate --chapter {chapter_num} --stage prewrite --format json
python -X utf8 "${SCRIPTS_DIR}/webnovel.py" --project-root "${PROJECT_ROOT}" review-pipeline --chapter {chapter_num} --review-results "${PROJECT_ROOT}/.webnovel/tmp/review_results.json" --metrics-out "${PROJECT_ROOT}/.webnovel/tmp/review_metrics.json" --report-file "审查报告/第{chapter_num}章审查报告.md" --save-metrics
python -X utf8 "${SCRIPTS_DIR}/webnovel.py" --project-root "${PROJECT_ROOT}" chapter-commit --chapter {chapter_num} --review-result "${PROJECT_ROOT}/.webnovel/tmp/review_results.json" --fulfillment-result "${PROJECT_ROOT}/.webnovel/tmp/fulfillment_result.json" --disambiguation-result "${PROJECT_ROOT}/.webnovel/tmp/disambiguation_result.json" --extraction-result "${PROJECT_ROOT}/.webnovel/tmp/extraction_result.json"
python -X utf8 "${SCRIPTS_DIR}/webnovel.py" --project-root "${PROJECT_ROOT}" backup --chapter {chapter_num} --chapter-title "{title}"

CSV 检索在 Step 2 按需触发，命令为：

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

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

适用场景

适用于按章推进的长篇小说写作项目，尤其是需要严格流程控制、审查留痕、事实提取入账与版本备份的场景。技能支持 --fast 与 --minimal 两种降级模式，适合对审查强度有不同要求的写作节奏。

限制与硬规则

  • 禁止并步、跳步、伪造审查。
  • 必须使用 Agent 工具调用指定 subagent，不得用主流程口头代替 subagent 输出。
  • 审查只跑一轮；blocking issue 定点修复或经用户裁决后才进 Step 4/5。
  • 失败只补跑失败步骤，不回退。
  • 参考资料按步骤按需加载。
  • 优先级：用户要求 > 状态机硬门槛 > 项目约束（总纲/设定/记忆）> skill 流程 > reference 建议。
  • 调用 story-system 前必须先从详细大纲解析真实本章目标，禁止传占位 query。
  • 备份必须以解析后的 PROJECT_ROOT 为准，禁止从工作区父目录执行裸全量 Git add。
  • 正文被手动改过、章纲更新晚于正文、本章已 accepted 又重跑时，必须停下用有限选项询问，不得覆盖作者手改。
  • 充分性闸门要求：正文文件存在且非空；审查已落库（--minimal 除外）；blocking=true 必须在 Step 3 定点修复或经用户裁决；anti_ai_force_check=pass（--minimal 除外）；accepted CHAPTER_COMMIT 且 projection 五项 done/skipped；chapter_status=committed；write-gate 的 prewrite / precommit / postcommit 均通过。
  • 最终报告必须面向作者，不输出原始 JSON、traceback 或长命令日志，使用固定三段式并汇报指定文件路径与状态。

暂未提供

关于该技能的收费、价格、平台支持范围、具体效果数据等信息，资料中暂未提供。