mcpField
W
webnovel-doctor

webnovel-doctor

github.com/lingfengqaqCreative & media7.7k352 installsUpdated 1w ago
Repository

About webnovel-doctor

webnovel-doctor is a read-only diagnostic skill for checking the completeness of a novel project. It performs stage-aware checks of files, configuration, and dependencies, then reports impacts and suggested fixes without applying changes or starting the Dashboard.

Key features

  1. 01Stage-aware project checks
  2. 02Check directories, files, and JSON
  3. 03Inspect SQLite and RAG configuration
  4. 04Check Python dependencies and Dashboard artifacts
  5. 05Report issue impacts and suggested fixes

Use cases

  1. 01Verify files expected at the current project stage
  2. 02Find missing RAG, Python, or Dashboard configuration
  3. 03Locate abnormal files and understand their impact

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/lingfengqaq/webnovel-writer --skill webnovel-doctor

After installing, type/webnovel-doctorin Claude Code to confirm it loaded.

Details

From the project README

Webnovel Doctor

目标

只读诊断当前书项目:确认所处阶段应有的目录、文件、JSON、SQLite、RAG 配置、Python 依赖与 Dashboard 构建产物是否完整。

原则

  1. 只读诊断:不写项目文件、不自动修复、不安装依赖、不启动 Dashboard。
  2. 先 project-status 取短状态,再 doctor 做阶段感知检查。
  3. 统一用 python -X utf8,避免中文路径编码问题。
  4. 缺失项按 runtime 推导的阶段解释影响与修复建议,不把 init 刚结束的项目按已写多章项目检查。

执行

准备路径:

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

短状态:

python -X utf8 "${SCRIPTS_DIR}/webnovel.py" --project-root "${WORKSPACE_ROOT}" project-status --format summary

标准体检:

python -X utf8 "${SCRIPTS_DIR}/webnovel.py" --project-root "${WORKSPACE_ROOT}" doctor --format text

指定章节加 --chapter {chapter_num},深度体检加 --deep。

输出方式

汇报包含:当前 phase 与 target_chapter、是否有 blocker、缺失或异常文件路径、RAG / Python / Dashboard 配置是否缺失、每个问题的影响和建议修复动作。

不执行真实修复,不展示或要求粘贴 API key。

Comments

Markdown supported