summary-and-test

一个skill，用于从课程课件生成知识总结和模拟试卷。

English

功能简介

从课程 PPT/PDF 课件和一份可选的样例试卷出发，本 skill 可以生成：

1. 知识总结 — 以 cheat sheet 风格整理课件中的所有核心概念、公式和算法
2. 模拟试卷（×3 份） — 三套完整的模拟试卷及参考答案，知识点分布与样例试卷对齐

快速开始

安装

通过 npm 安装（推荐）：

npm install -g summary-and-test

这会自动将 skill 文件复制到 Claude skills 目录（~/.claude/skills/summary-and-test/）。

手动安装：

git clone https://github.com/YifeiZhang0508/summary-and-test.git
cp -r summary-and-test ~/.claude/skills/

或在 Windows 上：

xcopy /E /I summary-and-test %USERPROFILE%\.claude\skills\summary-and-test

使用

在 Claude Code 中，用自然语言触发 skill 或直接/summary-and-test。

项目结构

summary-and-test/
├── SKILL.md                    # 主 skill 定义（578 行）
├── README.md                   # 英文文档
├── README.zh-CN.md             # 中文文档（本文件）
├── LICENSE                     # MIT 许可证
├── references/
│   ├── failure-paths.md        # 17 条故障路径及恢复策略
│   ├── quality-check.md        # 质量检查标准（五维度）
│   └── workflow-checklist.md   # 执行检查清单
├── templates/
│   ├── summary.tex             # 知识总结 LaTeX 模板
│   ├── summary.md              # 知识总结 Markdown 模板（回退方案）
│   └── exam-paper.tex          # 模拟试卷 LaTeX 模板
├── examples/
│   └── example-usage.md        # 示例会话记录
└── docs/
    └── customization.md        # 自定义指南

交付产品

skill 在 Summary-and-Test/ 文件夹下生成 4 个文件：

| 文件 | 说明 | |------|------| | <名称>.tex | 知识总结 LaTeX 源文件 | | <名称>.pdf | 知识总结编译 PDF | | 模拟试卷与答案.tex | 模拟试卷+答案 LaTeX 源文件 | | 模拟试卷与答案.pdf | 模拟试卷+答案编译 PDF |

环境要求

• Claude Code（CLI、桌面应用或 IDE 扩展）
• xelatex — 用于 PDF 编译（TeX Live 或 MiKTeX）
• Python 及 pdfplumber 或 pypdf — 用于 PDF 文本提取

自定义

参见 docs/customization.md：

• 适配不同考试格式
• 修改 LaTeX 样式
• 添加新的知识点类别
• 调整模拟试卷数量

许可证

MIT 许可证。详见 LICENSE。