ZeKaiNie/universal-examprep-skill

これは何か

Exam Cram Coach は、Claude Code、Codex、Cursor、Windsurf、Gemini CLI などのコーディングエージェントに「スキル」としてインストールできる AI 試験対策チューターです。コース資料（講義スライド、ノート、宿題、過去問）のフォルダを指定すると、章ごとにコースを教え、自分のノートから実際の図を表示し、実際の宿題/試験問題でクイズを出し、間違いを追跡し、チートシートをまとめます。

仕組み

このプロジェクトはエージェントスキル（エージェントが読む一連の指示）と、小さな Python ツール coach.py で構成されています。エージェントは coach.py setup などのコマンドを実行して資料を解析します：コースを章に分割し、PDF ページから図を切り抜き、宿題ファイルを解答ファイルとペアリングし（例：hw2.pdf と hw2solutions.pdf）、問題を問題バンクに抽出します。学習セッション中、エージェントはすべての主張に特定のファイルとページを引用し、切り抜き図をインラインで表示し、そのバンクからクイズを出します。すべての状態はローカルの study_state.json に保存されるため、チャットを閉じて後で再開できます。

主要な技術ポイント

• 設計による幻覚防止：すべての文に provenance がタグ付けされています——🟢（あなたの資料から、file p.N 引用付き）、🟡（AI 補足）、または ⚠️（資料にない AI 生成の回答）。範囲外のクエリは回答を捏造する代わりに非ゼロステータスで終了します。
• データベースなしの永続メモリ：進捗、クイズ結果、間違いはプレーンな JSON ファイルに保存されます；間違いは間隔をあけた再クイズで優先されます。ベクトル DB もトークン膨張もありません。
• 弱い/小さいモデルでも動作：Gemini Flash-Lite と Claude Haiku で 1,000 ページ以上の実際の確率ノートでベンチマーク済み——コマンド捏造ゼロ、幻覚引用ゼロが報告されています。
• 自動図抽出：pypdfium2 を使用して PDF ページからベクター図を切り抜くため、チューターは講義や解答の正確な図を表示できます。

範囲と制限

スタンドアロンアプリではありません——ターミナル付きのコーディングエージェントが必要です。PDF サポートには pypdfium2 が必要です（オプション；PPTX/DOCX/Markdown などの他の形式はそれなしで動作します）。スキャンまたは手書きのページは検出されてスキップされ、Excel/オーディオファイルは読み取られません。2 つのエディションがあります：Flash（軽量、推奨、小さいモデルで動作）と Full（v4.3、印刷可能な HTML/PDF 学習ガイドと検証パイプラインを追加しますが、より強力なモデルが必要です）。