| name | bishe-guider |
| description | 中文学术毕业论文（本科/硕士/博士）全流程写作指导与质量检查 Skill。
用于辅助毕业论文的撰写、修改、审查与定稿，覆盖写作风格、文献检索、
论文结构规范、排版语法、实验规范、盲审合规性、图表一致性等维度。
使用场景：
(1) 撰写或修改论文章节内容时，确保符合学术写作规范
(2) 润色文本，去除 AI 写作痕迹，使行文自然如人类研究者亲笔
(3) 检索、筛选和管理学术参考文献
(4) 检查论文结构、逻辑一致性、盲审匿名性、图表风格一致性
(5) 定稿前的全面复盘检查
|
Bishe Guider: 毕业论文写作指导
概述
本 Skill 提供中文学术毕业论文从撰写到定稿的全流程指导，包含 4 大规则模块。每个规则对应一个独立文件夹，内含详细的参考文档和工具脚本。
适用对象： 本科、硕士、博士学位论文（以中文学术论文为主）
核心目标：
- 消除 AI 写作痕迹，使论文行文自然严谨
- 确保论文符合学校评审标准与盲审要求
- 规范实验描述、图表排版、引用格式
- 在定稿前执行系统性复盘检查
规则模块
| 规则编号 | 规则名称 | 路径 | 核心功能 |
|---|
| 规则 0 | 项目初始化 | rule-05-project-init/reference.md | 构建标准化的毕业论文项目目录结构 |
| 规则 1 | 像个人类一样写作 | rule-01-humanizer/reference.md | 检测并去除 AI 写作痕迹，注入学术语体的人味 |
| 规则 2 | 查阅参考文献 | rule-02-reference-search/reference.md | Google Scholar 检索、筛选、引用、管理文献 |
| 规则 3 | 毕业论文写作要点 | rule-03-thesis-writing/reference.md | 论文结构、实验规范、排版语法、用词规范 |
| 规则 4 | 复盘检查 | rule-04-review-check/reference.md | 结构、逻辑、盲审、图表一致性等终稿检查 |
使用方式
根据当前任务阶段，加载对应的规则参考文档：
- 项目未初始化 → 优先加载规则 0，构建标准项目结构
- 撰写/润色阶段 → 加载规则 1 + 规则 3
- 文献调研阶段 → 加载规则 2
- 修改/审查阶段 → 加载规则 1 + 规则 3 + 规则 4
- 定稿前 → 加载全部 4 个规则，按规则 4 的复盘流程执行
核心工作流
工作流 A：项目启动（如未初始化）
1. 检测当前目录是否已存在标准项目结构（检查 src/、references/ 等核心目录）
2. 如未初始化，加载规则 0（项目初始化）
3. 询问用户项目名称和论文题目
4. 执行 init_project.sh 生成完整目录结构
5. 在 src/ 中生成 LaTeX 模板骨架
6. 以表格形式输出初始化结果
工作流 B：章节撰写
1. 用户提交待撰写的章节主题和大纲
2. 加载规则 3（毕业论文写作要点），确认该章节的结构规范
3. 协助用户撰写内容
4. 加载规则 1（像人类一样写作），润色文本去除 AI 痕迹
5. 以表格形式输出审查结果
工作流 C：文献检索与引用
1. 用户提出文献检索需求（主题、时间范围等）
2. 加载规则 2（查阅参考文献）
3. 🔴 Zotero MCP 前置检索（优先使用已有文献库）:
a. zotero search_library(q="主题关键词")
→ 查询Zotero文献库中已有条目，避免重复发现
b. zotero search_fulltext(q="关键词", itemKeys=[相关item])
→ 在已有PDF中全文检索相关段落
c. zotero get_annotations(itemKey=论文key)
→ 获取用户之前做的高亮和笔记（保留研究上下文）
d. 输出：已有文献覆盖报告，标记"Zotero已有"/"需新检索"
4. 使用 gs-search / gs-advanced-search 检索 Zotero 未覆盖的文献
5. 按筛选标准评估结果
6. 导出到 Zotero 或生成 BibTeX，存入 references/from-scholar/
7. 🔴 RAG 知识库补充（如已索引相关论文）:
a. python academic_rag/run_rag.py search "主题" --top-k 10
→ 获取已索引文献中的相关段落和图表
b. python academic_rag/run_rag.py find-figure "主题"
→ 获取图表资产用于论文撰写
8. 以表格形式输出检索与评估结果
工作流 D：全面复盘检查
1. 用户提交论文全文或指定章节
2. 加载规则 4（复盘检查）
3. 按检查清单逐项执行：
- 结构检查（四级标题、章节逻辑一致性）
- 用词检查（夸张词汇、人称、缩写）
- 盲审合规性（匿名性、无个人信息）
- 图表检查（编号、caption、颜色一致性）
- 排版检查（公式标点、表格对齐、首行缩进）
- 逻辑检查（创新点一致性、引用完整性）
4. 运行 check_figure_colors.py 检查图片颜色分布
5. 以表格形式输出全部检查结果
输出格式要求（强制）
所有形式的错误、有效或警告汇报，最终都必须以表格形式返回。
审查结果表格模板
| 检查项 | 位置/上下文 | 严重级别 | 问题描述 | 修改建议 | 状态 |
|---|
| 夸张词汇 | 第 1 章第 3 段 | 错误 | 出现"首次提出" | 改为"提出了一种" | 待修改 |
| 人称使用 | 第 2 章第 5 段 | 错误 | 出现"我们认为" | 改为"本文认为" | 待修改 |
| 图表大小 | 图 4-1 | 警告 | 图中文字偏小 | 调整字号至 ≥8pt | 待修改 |
| 公式标点 | 式 (3.2) | 错误 | 公式后缺少标点 | 添加逗号 | 待修改 |
| 颜色一致性 | 图 5-2 | 警告 | 与整体画风差异较大 | 调整配色方案 | 待修改 |
严重级别定义
| 级别 | 含义 | 处理方式 |
|---|
| 错误 | 违反硬性规范，必须修改 | 不修改无法通过评审 |
| 警告 | 影响论文质量，建议修改 | 修改后提升论文水平 |
| 提示 | 优化建议，可酌情处理 | 时间允许时改进 |
状态定义
| 状态 | 含义 |
|---|
| 待修改 | 发现问题，等待用户修改 |
| 已修改 | 用户已修改，建议复查 |
| 通过 | 检查项无问题 |
| 不适用 | 该检查项与当前内容无关 |
各规则详细说明
规则 0：项目初始化
参考文档： rule-05-project-init/reference.md
配套脚本：
rule-05-project-init/scripts/init_project.sh — 一键初始化标准项目结构rule-05-project-init/scripts/compile_tikz_to_png.sh — TikZ 编译为 PNGrule-05-project-init/scripts/extract_figures_from_pdf.py — 从 PDF 提取图片
核心内容：
- 标准项目目录结构定义（src/、references/、proposal/、example-theses/、experiments/、scripts/）
- 各目录用途和存放规范
- LaTeX 模板骨架生成
- 文献笔记模板、服务器访问信息模板
触发时机：
- 用户表示"开始写论文"
- 当前目录缺少
src/ 等核心目录
- 用户要求"初始化项目"
项目结构总览：
| 目录 | 英文名称 | 用途 |
|---|
| 论文源代码 | src/ | LaTeX 源码、章节文件、TikZ 图表、BibTeX |
| 参考文献 | references/ | 开题原始文献、Scholar 下载文献、阅读笔记、提取内容 |
| 开题资料 | proposal/ | 开题报告、PPT、相关材料 |
| 参考范文 | example-theses/ | 往届优秀论文（可选） |
| 实验结果 | experiments/ | 代码、数据、结果、设计图、服务器访问信息 |
| 工具脚本 | scripts/ | TikZ 编译、PDF 图片提取等辅助脚本 |
规则 1：像个人类一样写作
参考文档： rule-01-humanizer/reference.md
核心内容：
- 24 种 AI 写作痕迹的检测与修复指南
- 中文学术论文专属检查项（"本研究"/"我们"/夸张词汇/长句堆砌等）
- 包含大量修改前后的对比示例
触发时机：
- 用户提交文本要求润色
- 完成章节撰写后
- 发现文本读起来"像 AI 写的"
规则 2：查阅参考文献
参考文档： rule-02-reference-search/reference.md
核心内容：
- Google Scholar 检索流程（基础检索 + 高级检索）
- 文献筛选与评估标准（相关性、时效性、权威性、被引量）
- 引用追踪（正向追踪 + 反向追踪）
- 引用规范（格式、原则、常见错误）
- 文献综述写作规范
关联 Skill：
gs-search — 基础检索gs-advanced-search — 高级检索gs-cited-by — 引用追踪gs-export — 导出到 Zotero
Zotero MCP 集成（优先于 Google Scholar）：
zotero search_library — 查询已有文献库，避免重复发现zotero search_fulltext — 在已有PDF中全文检索zotero get_annotations — 获取用户高亮和笔记zotero get_content — 获取PDF全文和图片zotero semantic_search — 语义检索（基于embedding）
RAG 知识库补充：
python academic_rag/run_rag.py search "主题" --top-k 10 — 语义检索已索引文献python academic_rag/run_rag.py find-figure "主题" — 获取已索引图表
触发时机：
- 用户需要查找某主题文献
- 需要补充某章节的参考文献
- 需要追踪某篇论文的引用情况
规则 3：毕业论文写作要点
参考文档： rule-03-thesis-writing/reference.md
核心内容：
- 教育部平台与工程硕士评审标准对照表
- 第一章绪论规范（文献总结、科学问题凝练、研究框架图）
- 章节结构规范（每章小结、总结与展望）
- 实验规范（实验设置、实验内容、对比实验、消融实验）
- 排版与语法规范（图表、公式、用词、语言、参考文献）
- 优先级说明（P0/P1/P2）
触发时机：
- 开始撰写新章节
- 需要确认某部分的规范要求
- 对照评审标准自查
规则 4：复盘检查
参考文档： rule-04-review-check/reference.md
配套脚本： rule-04-review-check/scripts/check_figure_colors.py
核心内容：
- 14 项系统性检查清单
- 结构检查（四级标题、章节逻辑一致性）
- 用词检查（夸张词汇、人称、缩写）
- 盲审合规性（匿名性、无个人信息）
- 图表一致性（编号、Caption、颜色分布）
- 排版细节（公式标点、表格对齐、首行缩进）
- 逻辑与内容（创新点一致性、引用完整性、可复现性）
脚本功能：
- 提取所有图片的主色调、饱和度、明度
- 计算图片间的颜色相似度矩阵
- 生成 HTML 报告，标记颜色风格不一致的图片
- 支持 PNG、JPG、PDF 格式
依赖安装：
pip install Pillow matplotlib numpy scikit-learn PyMuPDF
使用方法：
cd /path/to/thesis/figures
python /path/to/bishe-guider/rule-04-review-check/scripts/check_figure_colors.py \
--input ./ --output ./color_report.html --recursive
触发时机：
优先级体系
本 Skill 采用三级优先级体系：
| 优先级 | 含义 | 处理方式 |
|---|
| P0 | 必须满足，硬性要求 | 立即修改，不通过无法毕业 |
| P1 | 重要要求，影响质量 | 尽量满足，提升论文水平 |
| P2 | 优化建议，锦上添花 | 时间允许时改进 |
在输出审查结果时，必须在"严重级别"列体现优先级对应的级别（P0→错误，P1→警告，P2→提示）。
盲审特别注意事项
-
绝对禁止在论文正文中出现：
- 学校名称
- 导师姓名
- 作者姓名
- 课题组名称
- 个人联系方式/链接
-
致谢处理：
- 盲审版本删除致谢或仅保留"感谢导师和家人的支持"等泛称
- 正式版本保留完整致谢
-
用词保守：
- 避免"首次""开创性""革命性"等绝对化表述
- 避免过度自夸，用事实和数据说话
-
格式统一：
