القائمة
产出可发布章节，完整执行上下文→起草→审查→润色→提交→备份。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| 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 输出python -c "..." 或 skill_runner），不得用 PowerShell 原生命令。中文路径在 PowerShell Test-Path 和 Python os.path.isfile 之间编码不一致。用户要求 > 状态机硬门槛 > 项目约束（总纲/设定/记忆）> skill 流程 > reference 建议
用户可在 设定集/prompts/ 文件夹中放置 .md 文件，系统自动加载并注入写作上下文（优先级高于 master_constraints，低于章级 forbidden_zones）。详见 docs/guides/custom-style-prompts.md。
python -X utf8 "${SCRIPTS_DIR}/reference_search.py" --skill write --table {表名} --query "{关键词}" --genre {题材}
触发条件：新角色→命名规则，战斗→场景写法，多角色对话→写作技法，情感描写→写作技法，高频桥段→场景写法。
优先级：用户明确指定的章节号 > 自动检测。用户说"写第 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_questionmust_cover_nodesforbidden_zones，违反即不通过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"
必须使用 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
必须使用 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
必须使用 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 "${PROJECT_ROOT}/.webnovel/tmp/review_results.json" \
--metrics-out "${PROJECT_ROOT}/.webnovel/tmp/review_metrics.json" \
--report-file "审查报告/第{chapter_num}章审查报告.md" \
--save-metrics
blocking=true → 修复后重审，不进 Step 4。--fast 只检查 setting/timeline/continuity。--minimal 跳过。
审查发现 blocking issue 时，执行以下循环，最多 2 轮。目标是 1 轮内找全并修完所有问题。
每轮流程：
references/self-check-evidence.mdAskUserQuestion 选项：
references/self-check-evidence.md），进 Step 4# 校验审查结果文件
test -s "${PROJECT_ROOT}/.webnovel/tmp/review_results.json" || { echo "❌ 审查结果未生成"; exit 1; }
python -X utf8 "${SCRIPTS_DIR}/webnovel.py" --project-root "${PROJECT_ROOT}" \
workflow checkpoint --chapter {chapter_num} --stage REVIEWING
加载 polish-guide.md、typesetting.md、style-adapter.md。
顺序：修复非 blocking issue → 风格适配 → 排版 → Anti-AI 终检。
只改表达不改事实。anti_ai_force_check=fail 时不进 Step 5。--minimal 仅排版。
python -X utf8 "${SCRIPTS_DIR}/webnovel.py" --project-root "${PROJECT_ROOT}" \
workflow checkpoint --chapter {chapter_num} --stage REVISING
# 清空旧 tmp 文件，保留 review_results.json（chapter-commit 仍需）
python -X utf8 "${SCRIPTS_DIR}/skill_runner.py" clean-tmp --project-root "${PROJECT_ROOT}" --keep review_results.json
必须使用 Agent 工具调用 observer-agent，产出自由文本 raw_facts.txt。
Agent(
subagent_type: "observer-agent",
prompt: "project_root={PROJECT_ROOT}; chapter={chapter_num}; chapter_file={CHAPTER_FILE}。输出 raw_facts 到 {PROJECT_ROOT}/.webnovel/runtime/chapter-{chapter_num}.raw_facts.txt。"
)
产物：{PROJECT_ROOT}/.webnovel/runtime/chapter-{chapter_num}.raw_facts.txt
python -X utf8 "${SCRIPTS_DIR}/data_modules/observer_settler.py" \
--raw-facts "${PROJECT_ROOT}/.webnovel/runtime/chapter-{chapter_num}.raw_facts.txt" \
--project-root "${PROJECT_ROOT}" \
--chapter {chapter_num} \
--output "${PROJECT_ROOT}/.webnovel/tmp/extraction_result.json"
产物：{PROJECT_ROOT}/.webnovel/tmp/extraction_result.json
必须使用 Agent 工具调用 data-agent。data-agent 不再提取事实——仅做大纲履约对比和实体消歧。
Agent(
subagent_type: "data-agent",
prompt: "project_root={PROJECT_ROOT}; chapter={chapter_num}。extraction_result 已由 settler 生成在 {PROJECT_ROOT}/.webnovel/tmp/extraction_result.json。只产出 fulfillment_result.json 和 disambiguation_result.json。不重新提取事实。"
)
# 验证 data-agent 输出文件
for f in fulfillment_result.json disambiguation_result.json extraction_result.json; do
FP="${PROJECT_ROOT}/.webnovel/tmp/${f}"
if [ ! -s "$FP" ]; then
echo "❌ data-agent 输出缺失: $f"
exit 1
fi
done
产物：fulfillment_result.json + disambiguation_result.json
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"
自动判定：blocking_count>0 或 missed_nodes 非空 或 pending 非空 → rejected，否则 accepted。
projection_status 五项（state/index/summary/memory/vector）全部 done 或 skipped。
chapter_status 由 projection writer 自动推进：accepted→committed，rejected→rejected。
commit 未生成→重跑 5.2。projection 失败→只补跑失败项。不回退 Step 1-4。
python -X utf8 "${SCRIPTS_DIR}/skill_runner.py" verify-chapter-files \
--project-root "${PROJECT_ROOT}" --chapter {chapter_num} \
|| { echo "❌ 写后校验失败"; exit 1; }
# 校验投影与事件日志一致性
python -X utf8 "${SCRIPTS_DIR}/webnovel.py" --project-root "${PROJECT_ROOT}" \
ssot verify
python -X utf8 "${SCRIPTS_DIR}/webnovel.py" --project-root "${PROJECT_ROOT}" backup \
--chapter {chapter_num} \
--chapter-title "{title}"
备份必须以解析后的 PROJECT_ROOT 为准，禁止从工作区父目录执行裸全量 Git add，避免把书项目仓库作为父仓库的嵌入仓库/submodule 加入。
--minimal 除外）--minimal 除外）审查缺失→重跑 Step 3。摘要/状态/记忆缺失→重跑 Step 5。润色失真→回 Step 4 修复后重跑 Step 5。
番茄写作技巧、番茄风章节、番茄留存约束；Use ONLY when writing or revising Fanqie chapters. Supplements webnovel-write with opener, pacing, dialogue, hook, and retention rules.
将小说章节自动发布到国内主流小说平台（番茄等）。触发条件："发布小说"、"发布章节"、"上传到番茄"、"自动发布"、"清理草稿"、"发布草稿"。
七猫写作技巧、七猫风章节、七猫留存与签约约束；Use ONLY when writing or revising Qimao chapters. Supplements webnovel-write with opener, pacing, hook, expectation, character, and content-audit rules.
使用审查 Agent 评估章节质量，生成报告并写回审查指标。
深度初始化网文项目。通过分阶段交互收集完整创作信息，生成可直接进入规划与写作的项目骨架与约束文件。
基于总纲生成卷纲、时间线和章纲，并把新增设定增量写回现有设定集。