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
- 01Stage-aware project checks
- 02Check directories, files, and JSON
- 03Inspect SQLite and RAG configuration
- 04Check Python dependencies and Dashboard artifacts
- 05Report issue impacts and suggested fixes
Use cases
- 01Verify files expected at the current project stage
- 02Find missing RAG, Python, or Dashboard configuration
- 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-doctorAfter installing, type/webnovel-doctorin Claude Code to confirm it loaded.
Details
From the project READMEWebnovel Doctor
目标
只读诊断当前书项目:确认所处阶段应有的目录、文件、JSON、SQLite、RAG 配置、Python 依赖与 Dashboard 构建产物是否完整。
原则
- 只读诊断:不写项目文件、不自动修复、不安装依赖、不启动 Dashboard。
- 先
project-status取短状态,再doctor做阶段感知检查。 - 统一用
python -X utf8,避免中文路径编码问题。 - 缺失项按 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