メインコンテンツへスキップ
B

dsh-plugin-socratic-tutor

bortpro/dsh-plugin-socratic-tutor

Socratic tutor with topic-specific curricula, diagnostic questions, a saved skill map, spaced review, and a final assessment.

インストール

dsh plugin --profile web add github:bortpro/dsh-plugin-socratic-tutor

README

Socratic Tutor for DeepSeek Harness

Socratic Tutor runs an ongoing lesson in a DeepSeek Harness conversation. It builds a curriculum from the topic, asks one question at a time, tracks evidence against a 0–5 skill scale, and uses spaced review and a final assessment.

Install

Use DeepSeek Harness 0.2.2-rc.5, Node.js 24.9.0 or later, and pnpm on your path.

dsh plugin --profile web add https://github.com/bortpro/dsh-plugin-socratic-tutor/releases/download/v1.0.0/dsh-plugin-socratic-tutor-1.0.0.tgz
dsh --profile web

To build and install from a local checkout:

npm ci
npm pack
dsh plugin --profile web add ./dsh-plugin-socratic-tutor-1.0.0.tgz
dsh --profile web

The package declares its profile layer through dsh.bundle.patch. Harness bundle documentation

Use

InputEffect
/tutor <topic>Start a lesson for the current conversation and ask the first diagnostic question.
/tutor <topic> --full-masteryRequire level 5 in every skill before the final assessment.
/progress or show progressDisplay the skill map.
/tutor-save or save stateReturn a portable JSON snapshot.
/tutor stopPause the current lesson and keep its progress.
/tutor resumeResume the lesson saved for the current conversation.
/tutor resume <saved JSON> or resume from: <saved JSON>Restore a portable snapshot in this conversation.

You can also start with Teach me linear algebra, Quiz me on SQL joins, or Help me master fractions. Requests such as Help me understand fractions prompt for confirmation when no lesson is active. Standalone queries such as What is covariance? follow the ordinary chat route. During a lesson, type harder, easier, or just tell me to change how the tutor handles the current question.

The Cordis configuration field defaultTargetLevel accepts integers from 1 to 5 and defaults to 4. Progress is written after each lesson action to a conversation-specific JSON file under .socratic-tutor/ in the current workspace. Reopening the same conversation in that workspace preserves progress across Harness restarts and model switches. Use a portable snapshot to move a lesson to another workspace or conversation. Snapshots can contain pending questions and notes on misconceptions.

Harness enforces state transitions and the evidence required to promote a level. The selected model generates the curriculum, asks the questions, and evaluates answer quality. Use a model and agent preset with tool calling enabled.

Development

npm ci
npm test

The tests use the Harness command registry, prompt assembly, and native tool executor with scripted model actions.

関連プラグイン