Quality Checker

核心功能为从字数、段落长度、对话比例、标点滥用、重复用词5个维度检测章节质量，输出0-100分的评分等级及针对性改进建议。典型场景含章节发布前把关、写作问题排查、质量量化对比。支持CLI调用，输入Markdown章节文件，可指定目标字数，输出结构化报告，还支持批量检测及与小说工具集成。

yuzhihui886

热度 41.77

最近更新 2026-05-11 17:40:12

分类：效率依赖：代码执行 / 读写文件应用场景：校对润色 / 报告撰写

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add quality-checker

Metadata

name: quality-checker
description: 章节质量检测器 - 检测章节正文的质量问题并生成评分报告。当需要评估章节质量、发现问题时使用，支持字数/段落/对话/标点/重复用词检测。

Quality Checker - 章节质量检测器

Overview

分析章节正文，检测潜在质量问题并生成详细报告，包含评分（0-100 分）和具体改进建议。

使用场景：

需要评估章节质量
需要发现写作问题（字数不足、段落过长、对话比例异常等）
需要量化质量指标进行对比
需要在发布前进行质量把关

检测项目

检测项	说明	阈值
字数检测	检查是否达到目标字数	≥ 目标字数 80%
段落长度	检测过长段落（影响阅读节奏）	≤ 200 字/段
对话比例	检测对话占比是否合理	20%-60%
标点滥用	检测感叹号/问号过度使用	≤ 10%
重复用词	检测高频重复词汇	≤ 5 次/词

质量评分

分数	等级	说明
90-100	优秀	可直接发布
80-89	良好	少量问题
70-79	中等	需要修改
60-69	及格	建议修改
<60	不合格	需要大修

CLI 使用

# 基本用法
python3 scripts/check_quality.py --input chapters/chapter-01.md

# 指定目标字数
python3 scripts/check_quality.py \
  --input chapters/chapter-01.md \
  --word-count 3000

# 输出报告到文件
python3 scripts/check_quality.py \
  --input chapters/chapter-01.md \
  --output reports/chapter-01-quality.md

# 简写
python3 scripts/check_quality.py -i chapter.md -w 3000 -o report.md

参数说明

参数	必填	说明
`--input` / `-i`	✅	章节正文文件路径（Markdown）
`--word-count` / `-w`	❌	目标字数（默认 3000）
`--output` / `-o`	❌	输出报告文件路径

输出报告格式

# 章节质量检测报告

**章节**: chapter-01.md
**检测时间**: 2026-04-04 23:50:00
**质量评分**: 85/100 (良好)

## 检测结果

| 检测项 | 状态 | 详情 |
|--------|------|------|
| 字数 | ✅ 通过 | 2850/3000 (95%) |
| 段落长度 | ⚠️ 警告 | 3 个段落超过 200 字 |
| 对话比例 | ✅ 通过 | 35% (正常范围 20%-60%) |
| 标点滥用 | ✅ 通过 | 感叹号占比 3% |
| 重复用词 | ⚠️ 警告 | "突然" 出现 8 次 |

## 问题详情

### 段落过长
- 第 3 段：256 字
- 第 7 段：234 字
- 第 12 段：218 字

### 重复用词
- "突然": 8 次
- "仿佛": 6 次
- "感觉": 5 次

## 改进建议

1. 拆分第 3、7、12 段，每段控制在 200 字以内
2. 减少"突然"的使用频率，尝试同义替换
3. 增加 150 字达到目标字数

依赖

Python 3.8+
rich (终端渲染)

安装依赖：

pip install -r scripts/requirements.txt

与其他技能集成

与 novel-writer 集成

# 1. 生成章节正文
python3 ../novel-writer/scripts/write_chapter.py \
  --book-dir projects/my-novel \
  --chapter 1 \
  --outline outlines/chapter-1.md \
  --output chapters/chapter-01.md

# 2. 检测质量
python3 scripts/check_quality.py \
  --input chapters/chapter-01.md \
  --word-count 3000 \
  --output reports/chapter-01-quality.md

批量检测

# 检测全部章节
for chapter in chapters/chapter-*.md; do
    python3 scripts/check_quality.py \
        --input "$chapter" \
        --word-count 3000 \
        --output "reports/$(basename "$chapter" .md)-quality.md"
done

注意事项

支持 UTF-8 和 GBK 编码的 Markdown 文件
质量评分仅供参考，具体标准可根据项目调整
对话检测基于引号识别，可能不完全准确
重复用词检测自动过滤常见虚词（的、了、是等）