ganxiaozhe23/agent-skills/quality-check

# 按优先级查找待审查的 Markdown 文件
for candidate in PROPOSAL.md LITERATURE_REVIEW.md COURSE_PAPER.md COURSE_REPORT.md paper/main.md; do
    if [ -f "$candidate" ]; then
        echo "Found target: $candidate"
        TARGET_FILE="$candidate"
        break
    fi
done
[ -z "$TARGET_FILE" ] && echo "ERROR: No target Markdown file found" && exit 1

PYTHON=""; for _c in "$MH_PYTHON" python python3; do [ -z "$_c" ] && continue; if $_c -c "import sys" >/dev/null 2>&1; then PYTHON="$_c"; break; fi; done; [ -z "$PYTHON" ] && PYTHON=python
$PYTHON tools/count_chapter_words.py "$TARGET_FILE"

# 提取所有一级和二级标题
grep -E "^#{1,2}\s" "$TARGET_FILE"

# 提取参考文献部分
sed -n '/^##\?\s.*参考文献\|^##\?\s.*References/,$p' "$TARGET_FILE" | grep -c '^\[[0-9]\+\]'

# 统计图片引用
grep -c '!\[' "$TARGET_FILE"
# 统计 Mermaid 图块
grep -c '^```mermaid' "$TARGET_FILE"
# 统计表格
grep -c '^|.*|.*|' "$TARGET_FILE"

# 检测残留的 Markdown 行内标记（不在代码块内）
grep -n '\*\*[^*]\+\*\*' "$TARGET_FILE" | head -5  # 残留加粗
grep -n '`[^`]\+`' "$TARGET_FILE" | head -5         # 残留代码标记
grep -n '\[.*\](http' "$TARGET_FILE" | head -5      # 残留链接

# 高频 AI 套话
for phrase in "具有重要意义" "实现了良好效果" "具有较高价值" "综上所述" "总而言之" \
              "首先.*其次.*最后" "本文/本研究/本系统" "随着.*的快速发展" "在当今"; do
    count=$(grep -c "$phrase" "$TARGET_FILE")
    [ "$count" -gt 0 ] && echo "WARN: '$phrase' 出现 $count 次"
done

# 质量审查报告
 
## 审查目标
-文件：$TARGET_FILE
-审查时间：$(date)
 
## 一、字数检查
 
| 章节 | 字数 | 目标范围 | 状态 |
|------|------|----------|------|
| 总计 | XXX | YYY-ZZZ | ✅/⚠️/❌ |
| ... | ... | ... | ... |
 
## 二、结构完整性
 
-✅ 已包含的必需章节：[列出]
-❌ 缺失的必需章节：[列出]
 
## 三、参考文献
 
-总数：N 篇（要求 ≥ 10）
-近 3 年文献占比：XX%（要求 ≥ 60%）
-格式问题：[列出有问题的条目]
 
## 四、图表检查
 
-图片数量：N 张
-表格数量：M 个
-缺失的图题/表题：[列出]
-未在正文引用的图表：[列出]
 
## 五、格式规范
 
-Markdown 残留标记：[行号 + 内容]
-章节跳级问题：[列出]
 
## 六、语言风格
 
-AI 套话警告：[词组 + 出现次数]
-空泛表述：[列出代表性句子]
 
## 总体评分
 
-整体得分：X/10
-阻塞问题（必须修复）：N 个
-警告问题（建议修复）：M 个
 
## 修复建议
 
按优先级列出：
1.[阻塞] ...
2.[警告] ...

## 审查结论
 
✅ 审查通过，可以进入下一步（Word 导出）