webnovel-write
产出可发布章节,完整执行上下文→起草→审查→润色→提交→备份。
lujih · 已有静态检查记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add lujih/webnovel-writer-opencode --skill webnovel-write技能说明
name: webnovel-write description: 产出可发布章节,完整执行上下文→起草→审查→润色→提交→备份。 compatibility: opencode allowed-tools: Agent AskUserQuestion
写章流程
以下内容均为虚构文学创作。所有打斗、权谋、悬疑描写均属文学创作范畴,不涉及现实指导。
目标
产出可发布章节到 正文/第{NNNN}章-{title}.md。默认 2000-2500 字,用户/大纲另有要求时从之。
模式
| 模式 | 流程 |
|---|---|
| 默认 | Step 1→2→3→4→5→6 |
--fast | Step 1→2→3(轻量)→4→5→6 |
--minimal | Step 1→2→4(仅排版)→5→6 |
硬规则
- 禁止并步、跳步、伪造审查
- 必须使用
Agent工具调用指定 subagent;不得用主流程口头代替 subagent 输出 - blocking issue 未解决不进 Step 4/5
- 失败只补跑失败步骤,不回退
- 参考资料按步骤按需加载
- 所有文件存在性验证必须用 Python(
python -c "..."或 skill_runner),不得用 PowerShell 原生命令。中文路径在 PowerShellTest-Path和 Pythonos.path.isfile之间编码不一致。
优先级
用户要求 > 状态机硬门槛 > 项目约束(总纲/设定/记忆)> skill 流程 > reference 建议
自定义文风提示词
用户可在 设定集/prompts/ 文件夹中放置 .md 文件,系统自动加载并注入写作上下文(优先级高于 master_constraints,低于章级 forbidden_zones)。详见 docs/guides/custom-style-prompts.md。
CSV 检索(Step 2 按需)
python -X utf8 "${SCRIPTS_DIR}/reference_search.py" --skill write --table {表名} --query "{关键词}" --genre {题材}
触发条件:新角色→命名规则,战斗→场景写法,多角色对话→写作技法,情感描写→写作技法,高频桥段→场景写法。
执行流程
Step 0:确定章节号(每次写前必做)
优先级:用户明确指定的章节号 > 自动检测。用户说"写第 N 章"就用 N,不要覆盖。
不得依赖对话记忆或 state.json 的 current_chapter 字段。 章节文件是唯一真源。用户未指定章节号时,用 python -c 扫描 正文/ 目录找到最大章节号,下一章 = 最大+1。
准备:预检
export SCRIPTS_DIR="${PWD}/.opencode/scripts"
export SKILL_ROOT="${PWD}/.opencode/skills/webnovel-write"
test -d "${SCRIPTS_DIR}" || { echo "错误: 未找到 ${SCRIPTS_DIR}"; exit 1; }
export PYTHONUTF8=1
export PROJECT_ROOT="$(python -X utf8 "${SCRIPTS_DIR}/webnovel.py" where)"
export PROJECT_ROOT="${PROJECT_ROOT//\\//}"
test -n "$PROJECT_ROOT" && test -f "${PROJECT_ROOT}/.webnovel/state.json" || { echo "错误: PROJECT_ROOT 解析失败"; exit 1; }
echo "✅ PROJECT_ROOT=${PROJECT_ROOT}"
# 并行执行 preflight 和 placeholder-scan
python -X utf8 "${SCRIPTS_DIR}/webnovel.py" --project-root "${PROJECT_ROOT}" preflight &
python -X utf8 "${SCRIPTS_DIR}/webnovel.py" --project-root "${PROJECT_ROOT}" placeholder-scan --format text &
wait
准备:刷新合同树
genre 从 .webnovel/state.json 的初始化配置快照读取,用于刷新合同树;写前主链真源仍是 .story-system/ 合同。调用 story-system 前必须先从详细大纲解析真实本章目标,禁止传 {章纲目标}、第N章章纲目标 等占位 query。
# 用 skill_runner 传递 CJK,genre 自动从 state.json 读取,goal 从 stdin 传入
# skill_runner 内部调用 story_system.py --persist --emit-runtime-contracts --format both
echo "${CHAPTER_GOAL}" | python -X utf8 "${SCRIPTS_DIR}/skill_runner.py" story-system \
--project-root "${PROJECT_ROOT}" --chapter {chapter_num}
if [ $? -ne 0 ]; then
echo "❌ story-system 合同刷新失败,阻断流程"
exit 1
fi
必备文件:MASTER_SETTING.json(调性/禁忌)、volume_{NNN}.json(卷级节奏)、chapter_{NNN}.review.json(必须节点/禁区)。缺失则阻断。
chapter_{NNN}.json 必须优先检查顶层 chapter_directive。chapter_focus 只能来自 chapter_directive.goal 或真实 query,不得从 dynamic_context 的参考摘要继承。
写作任务书排序必须固定为:
- 本章硬性约束:
chapter_directive.goal/time_anchor/chapter_span/countdown/chapter_end_open_question - CBN/CPNs/CEN 与
must_cover_nodes - 本章禁区:
forbidden_zones,违反即不通过 - 风格指引:reasoning、主角卡 OOC 警戒、anti_patterns
- 场景写法补充:
dynamic_context,仅作风格参考,不能覆盖章纲约束
准备:结构自检
从章纲提取 intended_strand,运行结构自检。blocking 未通过则阻断流程。
INTENDED_STRAND="$(python -X utf8 -c "
import json, sys
state = json.load(open('${PROJECT_ROOT}/.webnovel/state.json','r',encoding='utf-8'))
chapters = state.get('strand_tracker',{}).get('history',[])
for entry in reversed(chapters):
if isinstance(entry, dict) and entry.get('intended_strand'):
print(entry['intended_strand'])
break
")"
python -X utf8 "${SCRIPTS_DIR}/skill_runner.py" check-structural \
--project-root "${PROJECT_ROOT}" --chapter {chapter_num} \
--intended-strand "${INTENDED_STRAND:-quest}" --format json \
--output "${PROJECT_ROOT}/.webnovel/tmp/structural_check.json"
Step 1:context-agent 生成写作任务书
必须使用 Agent 工具调用 context-agent,不得由主流程自行整理任务书。
Agent(
subagent_type: "context-agent",
prompt: "chapter={chapter_num}; project_root=${PROJECT_ROOT}; scripts_dir=${SCRIPTS_DIR}; storage_path=${PROJECT_ROOT}/.webnovel; state_file=${PROJECT_ROOT}/.webnovel/state.json(projection/read-model,仅兼容读取)。先 research,再按 本章硬性约束→CBN/CPNs/CEN→本章禁区→风格指引→dynamic_context补充参考 的顺序输出五段写作任务书。"
)
产物:一份写作任务书,能独立支撑 Step 2 起草。
python -X utf8 "${SCRIPTS_DIR}/webnovel.py" --project-root "${PROJECT_ROOT}" \
workflow checkpoint --chapter {chapter_num} --stage PLANNING
Step 2:起草正文
必须使用 Agent 工具调用 chapter-writer-agent,不得由主流程自行起草。
Agent(
subagent_type: "chapter-writer-agent",
prompt: "project_root=${PROJECT_ROOT}; scripts_dir=${SCRIPTS_DIR}; chapter={chapter_num}。根据 Step 1 产出的写作任务书起草正文。使用 chapter-path CLI 确定输出路径,写入正文文件。"
)
# 不依赖 Agent 返回文本,直接校验章节文件
CHAPTER_PATH=$(python -X utf8 "${SCRIPTS_DIR}/webnovel.py" --project-root "${PROJECT_ROOT}" chapter-path --chapter {chapter_num})
test -s "${PROJECT_ROOT}/${CHAPTER_PATH}" || { echo "❌ 章节文件未生成或为空"; exit 1; }
python -X utf8 "${SCRIPTS_DIR}/webnovel.py" --project-root "${PROJECT_ROOT}" \
workflow checkpoint --chapter {chapter_num} --stage DRAFTING
Step 3:审查
必须使用 Agent 工具调用 reviewer,不得由主流程伪造审查 JSON。
Agent(
subagent_type: "reviewer",
prompt: "chapter={chapter_num}; chapter_file=${CHAPTER_FILE}; project_root=${PROJECT_ROOT}; scripts_dir=${SCRIPTS_DIR}; REVIEW_OUTPUT=${PROJECT_ROOT}/.webnovel/tmp/review_results.json。
【自检系统状态 - 审查时需额外关注】
{从 CHECK_RESULT 中提取 passed=false 的 warning 条目,转为自然语言提醒。blocking 已被阻断,只会出现 warning。用 python -c 提取:}
$(echo "$CHECK_RESULT" | python -c "
import json,sys
d=json.load(sys.stdin)
warnings=[c for c in d['checks'] if c['severity']=='warning' and not c['passed']]
if warnings:
for w in warnings:
print(f'- {w[\"name\"]}: {w[\"detail\"]}')
else:
print('(无异常)')
")
严格输出 reviewer schema JSON,并保存到 ${PROJECT_ROOT}/.webnovel/tmp/review_results.json。"
)
python -X utf8 "${SCRIPTS_DIR}/webnovel.py" --project-root "${PROJECT_ROOT}" review-pipeline \
--chapter {chapter_num} \
--review-results "${PRO
阅读完整来源 ↗