Thesis Skills不是AI 写作助手，不是论文模板，也不会替你生成论文正文。

它是一个命令行工作流系统，用来连接很多研究生和科研作者已经在使用的工具：Word、Zotero、EndNote、LaTeX、结构化检查报告、安全修复补丁、审阅交接材料，以及提交前 readiness 检查。

┌───────────────────────────────────────────┐
Zotero / EndNote ─┤                                           ├─→ LaTeX 论文 
Word .docx ───────┤              Thesis Skills                ├─→ 审阅用 Word 导出 
LaTeX 项目 ───────┤                                           ├─→ 答辩准备材料 
                  └───────────────────────────────────────────┘
                                      │
                                      ▼
                 检查报告 → dry-run 修复 → readiness gate

目标很简单：把分散、手工、容易出错的论文后期工作，变成一个可检查、可复现、可审计的流程。

对重复性后期工作来说，节省时间是具体可感知的：

文献接入 30-60 分钟 2-5 分钟约 10 倍；

Word ↔ LaTeX 审阅交接 1-3 小时 5-10 分钟约 15 倍；

确定性格式检查 1-3 小时 2-5 分钟约 20 倍；

基于报告的安全修复 1-2 小时 5-10 分钟约 10 倍；

提交前 readiness 复核 30-60 分钟 1-2 分钟约 30 倍；

答辩前清单整理 2-4 小时 10-15 分钟约 15 倍。

注：时间节省是对重复性格式和交接工作的保守估算。Thesis Skills 不替代写作、思考、导师判断或学校/期刊规则的最终人工确认。

核心工作流

1. 接入          2. 检查            3. 安全修复          4. 放行判断      5. 交接 
──────────       ───────────        ─────────────        ─────────       ─────────────
Zotero           引用完整性         预览补丁             通过            导师审阅 Word
EndNote     →    语言规则      →    dry-run 优先   →     警告      →     审阅 TODO
Word/LaTeX       格式结构           显式确认修改         阻断            答辩准备材料 

Readiness gate 预览

┌──────────────────────────────────────────────────────────────┐
│ Readiness verdict: WARN（存在警告）                           │
├───────────────────────┬────────┬─────────────────────────────┤
│ 检查维度              │ 状态   │ 含义                        │
├───────────────────────┼────────┼─────────────────────────────┤
│ 引用                  │ PASS   │ 引用 key 全部可解析         │
│ 语言                  │ WARN   │ 仍有 2 条风格警告           │
│ 格式                  │ PASS   │ 标签和交叉引用稳定          │
│ 编译证据              │ WARN   │ demo 模式跳过编译           │
│ Word 导出证据         │ WARN   │ smoke test 不生成该产物     │
│ 审阅闭环证据          │ WARN   │ smoke test 不生成该产物     │
└───────────────────────┴────────┴─────────────────────────────┘

 下一步：
1. 查看 reports/check_language-report.json
2. 需要导师审阅交接时，再生成 Word 导出和 review-loop 产物 
3. 最终提交前，去掉 --skip-compile 重新运行

规则包

规则包是 Thesis Skills 最核心的概念之一：它把你学校的格式要求编码成结构化的 YAML 配置，让检查器知道什么算 " 对 "、什么算 " 错 "。

内置规则包

90-rules/packs/
 ├── university-generic/        # 通用高校论文启动包（默认、宽松）
 ├── journal-generic/           # 通用期刊文章启动包（英文、精简）
 ├── tsinghua-thesis/           # 清华大学硕士/博士学位论文包 
 │                              #   已按《研究生学位论文写作指南（202503）》做过首轮校准 
 │                              #   中英文混排规则、图表编号、参考文献默认项已按写作指南调整 
 └── demo-university-thesis/    # 非清华高校的具体示例包 

• university-generic适合大部分国内高校的学位论文，规则覆盖面广、阈值适中。

• tsinghua-thesis针对清华同学做了专门校准：引用格式按 GB/T 7714、中英混排参照学校写作指南、章节命名匹配中文学位论文惯例。对很多清华论文项目来说，这个包可以直接作为起点使用，但仍建议结合院系模板和本地要求再复核 1 轮。

• journal-generic适合英文期刊投稿场景，关闭了 CJK 特有规则（中英空格、全半角标点等）。

规则包内部结构

每个规则包是一个文件夹，包含三个文件：

90-rules/packs/your-school/
 ├── pack.yaml      # 包元信息：名称、类型、版本 
  ├── rules.yaml     # 规则定义：做什么检查、报什么级别 
 └── mappings.yaml  # 文件名/路径映射（如主文件候选名、bib 文件位置）