1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | universal-examprep-skill |
| 作者/维护者 | ZeKaiNie（个人开发者，GitHub API） |
| 来源链接 | https://github.com/ZeKaiNie/universal-examprep-skill |
| 许可证 | MIT（GitHub API 获取） |
| GitHub Stars | 258（GitHub API） |
| Forks | 14（GitHub API） |
| 最新版本 | v4.3（2026-07-19 发布，GitHub Releases） |
| 安装方式 | 让 Agent 按自然语言指令拉取安装（README 为各平台提供专用指令），或手动下载 release zip |
项目自述名称为「Exam Cram Coach」（README 标题），与仓库名不一致，本报告统一使用正式名称 universal-examprep-skill。
2. 功能介绍与亮点
- 把用户提供的课程材料（讲义、作业、历年真题）解析成带章节结构的知识库与标准题库。
- 答案标注三级来源可信度：🟢 来自资料原文、可溯源到具体文件与位置；🟡 AI 补充，可能与任课教师讲法不同；⚠️ AI 生成待验证。材料覆盖不到的地方会明确说“不知道”，而不是编造。
- 两种处理模式可选：轻量按需（只处理正在学的章节，适合考前时间紧张）与完整建库（预先生成整门课的章节 wiki、标准题库与复习队列）。
- 内部由 exam-ingest、exam-tutor、exam-study-guide、exam-quiz、exam-review、exam-cheatsheet、exam-audit、confusion-tracker 等子模块协同构成一个统一产品，而非彼此独立的技能集合。
- 支持中文/英文/双语混排教学，并跨会话保留复习进度与错题记录。
- 配有 CI 与独立的行为冒烟测试基准套件，仓库自 2026-06-13 创建以来已连续发布 v3.0 至 v4.3 共 5 个版本，工程化程度在同类个人项目中较高。
3. 适用场景
所属分类：内容创作与知识管理
适合考前需要基于自己课程材料（而非通用互联网知识）快速复习的学生：大学/研究生课程期末冲刺、需要把讲义与历年真题转成结构化知识库与刷题题库的场景，尤其适合时间紧张、只想覆盖薄弱章节的“临考抱佛脚”场景，时间充裕时也可切换为完整建库模式做系统复习。
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持——README 提供 Claude Code 专用安装指令，验证 SKILL.md 后即可使用。
- Codex：✅ 原生支持——README 提供 Codex 专用安装指令。
- OpenClaw：❓ 未验证——已抓取材料中未提及。
- Hermes Agent：❓ 未验证——已抓取材料中未提及。
（README 另为 Cursor、Windsurf、Gemini CLI、Antigravity 提供了专门安装路径，遵循的是通用 Agent Skills 规范而非单平台专属实现。）
5. 推荐理由
不同于直接问答，这个技能强制要求每条答案标注是否来自用户自己的课程材料，材料覆盖不到的地方明确标“AI 生成待验证”而不是编造——对备考学生而言，错的解释比没有解释更危险。轻量按需模式让用户考前一天也能立刻开始，不需要预先花时间建立整门课的知识库，且全程本地处理课程文件、不需要任何付费 API key，使用门槛和风险都很低。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 6 | GitHub 258 stars、14 forks，仓库创建于 2026-06-24，约一个月内即达到当前规模，增长速度较快；经检索未发现第三方平台的独立讨论 |
| 可用性 | 8 | README 为 Claude Code、Codex、Cursor、Windsurf、Gemini CLI 等多个 Agent 平台提供了明确安装指令；配有 CI 与行为冒烟测试套件，2026-07-19 仍有新版本发布；纯本地处理课程文件，不需要任何付费 API key |
| 安全性 | 8 | 见下方安全检查清单 |
安全检查清单：
- ① Shell 命令：通过本地 Python 脚本读写用户提供的课程材料文件夹与技能自身状态文件，范围明确、限定在用户指定的工作区内
- ② 联网外发：核心处理为本地文件解析与本地状态维护，未发现向外部服务器发送课程材料内容的证据
- ③ API key/凭据：不需要任何外部 API key 或凭据
- ④ 可疑指令：抓取到的 SKILL.md 与脚本代码中未发现提示注入或隐蔽指令迹象；代码含符号链接检测、原子写入等防御性设计
- ⑤ 作者/组织信誉：两名有历史记录的真实 GitHub 账号活跃贡献，未见刷星或操纵性措辞
- ⑥ License：MIT，明确
- ⑦ 最近维护：最近一次发布为 2026-07-19（v4.3），维护活跃
综合评分 = 三项均值 ≈ 7.3
7. 跟同类 Skills 相比的优势
| 名称 | 定位 | 与本技能的差异 |
|---|---|---|
| anki-connect-skill（crisak） | 通过 Anki-Connect API 控制已安装的 Anki 应用制作/复习闪卡 | 依赖用户已安装并运行 Anki 桌面应用，负责把内容塞进现成的间隔重复系统，不涉及从原始课程材料构建带溯源标记的知识库与题库 |
| cca-f-exam-prep（abiodedeyi） | 面向 Anthropic 官方 CCA-F 认证考试的专用备考技能 | 内容固定针对单一认证考试大纲，不接受用户自己上传的课程材料，覆盖面窄但更贴合该特定考试 |
universal-examprep-skill 的差异化在于“以用户自己的课程材料为唯一权威来源”：所有教学内容都可追溯到具体文件与位置，材料之外的补充会被明确标注风险等级，而不是像通用刷题工具那样直接给出可能与任课教师讲法不符的标准答案。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价；GitHub 议题区的历史记录以维护者自身的功能开发与修复条目为主，暂无外部用户的独立反馈。
9. 其他补充
README 提供中英双语版本；仓库自 2026-06-13 创建以来已连续发布 v3.0 至 v4.3 共 5 个版本，附带 CI 工作流与独立的行为冒烟测试基准套件，工程化程度在同类个人项目中较高。
10. 安装使用方式
- Claude Code：告知 Agent“安装/更新 https://github.com/ZeKaiNie/universal-examprep-skill 到 ~/.claude/skills/universal-exam-cram-coach”，Agent 会自行拉取、校验 SKILL.md 并报告安装路径与版本。
- Codex / Cursor / Windsurf / Gemini CLI：README 为各平台提供了专用的一段式安装指令，直接复制给对应 Agent 执行即可。
- 手动方式：从 Releases 下载
universal-exam-cram-coach.zip，解压到对应 Agent 的技能目录。 - 安装后无需重启，直接告诉 Agent 课程材料所在文件夹、考试时间与期望的复习语言即可触发；技能会先展示确认信息（材料路径、复习模式、时间预算）再开始教学。
11. 注意事项
- 若 Agent 无法联网或执行终端命令，需改用手动下载安装的路径，功能等价但少了自动校验环节。
- 涉及大量 PDF、公式、图片的课程材料时，README 建议优先使用带图形界面的桌面版/IDE 版 Agent，纯终端聊天可能无法清晰展示图片与公式。
- 仓库创建约一个月，星标增长快但样本周期短，长期稳定性与社区反馈仍待观察。
- “完整建库”模式会预先解析整门课程材料，耗时与 token 消耗高于按需模式，考前时间紧张时建议优先选择轻量按需模式。