目标：让 /webnovel-resume 能基于真实断点恢复。即使 workflow_manager 出错，也只记录警告 ，审查继续。

推荐（bash）：

python "${SCRIPTS_DIR}/webnovel.py" --project-root "${PROJECT_ROOT}" workflow start-task --command webnovel-review --chapter {end} || true

步骤映射（必须与 workflow_manager.py get_pending_steps("webnovel-review") 对齐）：

• Step 1：加载参考
• Step 2：加载项目状态
• Step 3：并行调用检查员
• Step 4：生成审查报告
• Step 5：保存审查指标到 index.db
• Step 6：写回审查记录到 state.json
• Step 7：处理关键问题（AskUserQuestion）
• Step 8：收尾（完成任务）

步骤记录模板（bash，失败不阻断）：

python "${SCRIPTS_DIR}/webnovel.py" --project-root "${PROJECT_ROOT}" workflow start-step --step-id "Step 1" --step-name "加载参考" || true
python "${SCRIPTS_DIR}/webnovel.py" --project-root "${PROJECT_ROOT}" workflow complete-step --step-id "Step 1" --artifacts '{"ok":true}' || true

审查深度

• 核心（默认） : 一致性 / 连续性 / 角色崩坏 / 读者吸引力
• 完整（关键章节/用户要求） : 核心 + 爽点 + 节奏控制

步骤 1：加载参考（按需）

参考资料（按步骤导航）

• 步骤 1（必读，硬约束）：core-constraints.md
• 步骤 1（可选，完整审查或节奏/爽点相关问题）：cool-points-guide.md
• 步骤 1（可选，完整审查或节奏/爽点相关问题）：strand-weave-pattern.md
• 步骤 1（可选，仅在返工建议需要时）：common-mistakes.md
• 步骤 1（可选，仅在返工建议需要时）：pacing-control.md

参考加载级别（严格，惰性）

• L0：先确定审查深度（核心 / 完整），再加载参考。
• L1：只加载参考资料区的“必读”条目。
• L2：仅在问题定位需要时加载参考资料区的“可选”条目。

必读 :

cat "${SKILL_ROOT}/../../references/shared/core-constraints.md"

建议（完整审查或需要时） :

cat "${SKILL_ROOT}/../../references/shared/cool-points-guide.md"
cat "${SKILL_ROOT}/../../references/shared/strand-weave-pattern.md"

可选 :

cat "${SKILL_ROOT}/references/common-mistakes.md"
cat "${SKILL_ROOT}/references/pacing-control.md"

步骤 2：加载项目状态（若存在）

cat "$PROJECT_ROOT/.webnovel/state.json"

步骤 3：并行调用检查员（任务）

调用约束 :

• 必须通过 Task 工具调用审查子代理，禁止主流程直接内联审查结论。
• 所有子代理结果全部返回后再生成总评与优先级。

核心审查 :

• consistency-checker
• continuity-checker
• ooc-checker
• reader-pull-checker

完整审查追加 :

• high-point-checker
• pacing-checker

步骤 4：生成审查报告

保存到：审查报告/第{start}-{end}章审查报告.md

报告结构（精简版） :

# 第 {start}-{end} 章质量审查报告

## 综合评分
- 爽点密度 / 设定一致性 / 节奏控制 / 人物塑造 / 连贯性 / 追读力
- 总评与等级

## 修改优先级
- 🔴 高优先级（必须修改）
- 🟠 中优先级（建议修改）
- 🟡 低优先级（可选优化）

## 改进建议
- 可执行的修复建议

审查指标 JSON（用于趋势统计） :

{
  "start_chapter": {start},
  "end_chapter": {end},
  "overall_score": 48,
  "dimension_scores": {
    "爽点密度": 8,
    "设定一致性": 7,
    "节奏控制": 7,
    "人物塑造": 8,
    "连贯性": 9,
    "追读力": 9
  },
  "severity_counts": {"critical": 1, "high": 2, "medium": 3, "low": 1},
  "critical_issues": ["设定自相矛盾"],
  "report_file": "审查报告/第{start}-{end}章审查报告.md",
  "notes": ""
}

注意：此处只生成审查指标 JSON；落库见步骤 5。

步骤 5：保存审查指标到 index.db（必做）

python "${SCRIPTS_DIR}/webnovel.py" --project-root "${PROJECT_ROOT}" index save-review-metrics --data '@review_metrics.json'

步骤 6：写回审查记录到 state.json（必做）

将审查报告记录写回 state.json.review_checkpoints，用于后续追踪与回溯（依赖 update_state.py --add-review）：

python "${SCRIPTS_DIR}/webnovel.py" --project-root "${PROJECT_ROOT}" update-state -- --add-review "{start}-{end}" "审查报告/第{start}-{end}章审查报告.md"

步骤 7：处理关键问题

如发现关键问题（severity_counts.critical > 0 或 critical_issues 非空），必须使用 AskUserQuestion 询问用户：

• A) 立即修复（推荐）
• B) 仅保存报告，稍后处理

若用户选择 A：

• 输出“返工清单”（逐条关键问题 → 定位 → 最小修复动作 → 注意事项）
• 如用户明确授权可直接修改正文文件，则用 Edit 对对应章节文件做最小修复，并建议重新运行一次 /webnovel-review 验证

若用户选择 B：

• 不做正文修改，仅保留审查报告与指标记录，结束本次审查

步骤 8：收尾（完成任务）

python "${SCRIPTS_DIR}/webnovel.py" --project-root "${PROJECT_ROOT}" workflow start-step --step-id "Step 8" --step-name "收尾" || true
python "${SCRIPTS_DIR}/webnovel.py" --project-root "${PROJECT_ROOT}" workflow complete-step --step-id "Step 8" --artifacts '{"ok":true}' || true
python "${SCRIPTS_DIR}/webnovel.py" --project-root "${PROJECT_ROOT}" workflow complete-task --artifacts '{"ok":true}' || true

每周安装量

69

代码仓库

lingfengqaq/web…l-writer

GitHub 星标数

1.7K

首次出现

2026年1月23日

安全审计

Gen Agent Trust HubPassSocketPassSnykPass

安装于

opencode65

codex61

gemini-cli60

cursor60

kimi-cli58

github-copilot58