exam-help

Name: exam-help
Author: ZeKaiNie

258stars14forks

How to install exam-help?

zekainie/universal-examprep-skill/exam-help

$npx -y skills add ZeKaiNie/universal-examprep-skill --skill exam-help

Installs into the current project.

Summary

备考教练的一屏速查卡：工作流、3×4 学习选择、产物偏好、工作区文件、6 大题型、来源规则与子技能路由。用户问怎么用、有哪些模式、文件用途或支持题型时使用。

Files · 1

View on GitHub

SKILL.md

1	# exam-help — quick-reference card
2
3	## Purpose
4
5	Render one read-only card covering the validated workflow, three modes, four time tiers, `lightweight\|full`, `chat\|visual`, workspace truth/views, six quiz types, provenance, and subskill routing.
6
7	## Activation
8
9	Use only when the student asks how the suite works, which modes/types exist, or what workspace files mean.
10
11	## Inputs
12
13	No files, arguments, or state reads. The caller supplies the selected language.
14
15	## Workflow
16
17	1. Emit the matching static language-pack card: persisted `zh`, `en`, or `bilingual`, otherwise an explicit ad-hoc request.
18	2. Read no wiki, bank, plan, progress, or workspace file; run no script/subskill.
19	3. Stop without tutoring, quizzing, ingesting, grading, or initialization.
20
21	The card must say:
22
23	- `processing_mode=lightweight` is the default/recommended startup choice. It
24	inventories names, then visually processes only the current-phase PDF pages or
25	definitely single-frame PNG/JPEG/BMP (maximum eight primary pages and one active
26	batch). Overview contact sheets group at most four pages at roughly 768 px/tile;
27	page/prompt/dependency detail and target-answer-only solution calls use
28	source-qualified locations and canonical PNG evidence under `.lightweight/assets/`.
29	Bind exact external answer pages with `register-answer-dependency`; dependency
30	pages are locator/detail only. Figure prompt/answer crops stay distinct. An
31	unfinished batch can close only through receipt-backed `abandon --reason`; taught
32	progress cannot be abandoned, while `replace-taught --reason` preserves it as
33	superseded history and plans an exact-slice successor. It keeps the page-batch /
34	progress state machines and creates no Study Guide/PDF. `processing_mode=full` is
35	explicit opt-in and opens the complete ingestion/review route. Input-token savings
36	never shorten the teaching explanation.
37	- `artifact_mode` is independent from processing intensity and never inferred from
38	subscription. Missing/legacy/unknown means `chat`. In full mode, `chat` stops
39	without PDF while standing `visual` additionally requires typed Guide, render,
40	receipt hashes, every-page QA, and `artifact_ready=ready`. A one-shot artifact
41	leaves stored state unchanged. In lightweight, a saved `visual` preference is
42	dormant and effective output remains `chat`; it never builds a Study Guide.
43	- `answer_explanation_mode` is also independent. Its stored-schema fallback is
44	`ordinary`, and every full-Guide item still gets a detailed beginner-first
45	explanation. At full-v2 Guide entry, a verified host-native child with a fresh
46	independent context plus exact single-item input/tool restrictions makes
47	`isolated` the default unless the learner opted out; tell the learner once about
48	extra host quota/time, with no second API key or external upload. Missing or
49	incomplete capability stays `ordinary` and is stated honestly. A separately
50	billed external Provider is explicit-request-only and retains no-upload planning,
51	current pricing/privacy disclosure, and exact-plan upload consent. A model name,
52	subscription, key, `full`, or `visual` alone proves neither route.
53	- `ingest_course.py` is the full-mode build entry; exit 10 is process success with
54	blocked readiness, and teaching remains forbidden. `.ingest/` is full-mode
55	build/review truth, `.lightweight/session.json` is on-demand page-batch truth,
56	`study_state.json` is progress truth, and Markdown is a generated view.
57	- Lightweight completion uses current-phase taught-batch/notebook events and skips
58	typed Guide/full-build evidence; superseded predecessors/events remain history but
59	leave the current denominator. `verified` needs revision-bound checkpoints from an
60	unchanged bank that pre-existed lightweight initialization; startup captures only
61	its immutable stat baseline. Routine health checks use metadata/physical identity,
62	not stream hashes; exact hashes occur at transitions/completion or explicit
63	`status --verify-live`. Older taught history is `unchecked_historical` until that
64	phase is resumed.
65	- MinerU, Docling, and LangGraph are named-request-only and remote/cloud-only. Never
66	download, install, probe, import, or execute them locally.
67	- Provenance is exact: 🟢 来自资料 / 🟡 AI补充，可能与你老师讲的不完全一致 / ⚠️ AI生成答案，非老师/教材提供.
68
69	## Output Contract
70
71	Output exactly one help card and mutate nothing. Student prose is English by default, Simplified Chinese for a Chinese opening, or explicit bilingual composition.
72
73	## Language packs
74
75	- `中文` → [`../../locales/zh/skills/exam-help.md`](../../locales/zh/skills/exam-help.md)
76	- `English` → [`../../locales/en/skills/exam-help.md`](../../locales/en/skills/exam-help.md)
77	- `双语` → compose both blockwise, zh then `> EN:`, under [`docs/language-policy.md`](../../docs/language-policy.md)
78
79	Display aliases are normalized to `zh`, `en`, or `bilingual`.
80
81	## Bound

People who liked this also viewed

6 picks

Type

exam-help

258stars14forks

View on GitHub

How to install exam-help?

zekainie/universal-examprep-skill/exam-help

$npx -y skills add ZeKaiNie/universal-examprep-skill --skill exam-help

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# exam-help — quick-reference card
2
3	## Purpose
4
5	Render one read-only card covering the validated workflow, three modes, four time tiers, `lightweight\|full`, `chat\|visual`, workspace truth/views, six quiz types, provenance, and subskill routing.
6
7	## Activation
8
9	Use only when the student asks how the suite works, which modes/types exist, or what workspace files mean.
10
11	## Inputs
12
13	No files, arguments, or state reads. The caller supplies the selected language.
14
15	## Workflow
16
17	1. Emit the matching static language-pack card: persisted `zh`, `en`, or `bilingual`, otherwise an explicit ad-hoc request.
18	2. Read no wiki, bank, plan, progress, or workspace file; run no script/subskill.
19	3. Stop without tutoring, quizzing, ingesting, grading, or initialization.
20
21	The card must say:
22
23	- `processing_mode=lightweight` is the default/recommended startup choice. It
24	inventories names, then visually processes only the current-phase PDF pages or
25	definitely single-frame PNG/JPEG/BMP (maximum eight primary pages and one active
26	batch). Overview contact sheets group at most four pages at roughly 768 px/tile;
27	page/prompt/dependency detail and target-answer-only solution calls use
28	source-qualified locations and canonical PNG evidence under `.lightweight/assets/`.
29	Bind exact external answer pages with `register-answer-dependency`; dependency
30	pages are locator/detail only. Figure prompt/answer crops stay distinct. An
31	unfinished batch can close only through receipt-backed `abandon --reason`; taught
32	progress cannot be abandoned, while `replace-taught --reason` preserves it as
33	superseded history and plans an exact-slice successor. It keeps the page-batch /
34	progress state machines and creates no Study Guide/PDF. `processing_mode=full` is
35	explicit opt-in and opens the complete ingestion/review route. Input-token savings
36	never shorten the teaching explanation.
37	- `artifact_mode` is independent from processing intensity and never inferred from
38	subscription. Missing/legacy/unknown means `chat`. In full mode, `chat` stops
39	without PDF while standing `visual` additionally requires typed Guide, render,
40	receipt hashes, every-page QA, and `artifact_ready=ready`. A one-shot artifact
41	leaves stored state unchanged. In lightweight, a saved `visual` preference is
42	dormant and effective output remains `chat`; it never builds a Study Guide.
43	- `answer_explanation_mode` is also independent. Its stored-schema fallback is
44	`ordinary`, and every full-Guide item still gets a detailed beginner-first
45	explanation. At full-v2 Guide entry, a verified host-native child with a fresh
46	independent context plus exact single-item input/tool restrictions makes
47	`isolated` the default unless the learner opted out; tell the learner once about
48	extra host quota/time, with no second API key or external upload. Missing or
49	incomplete capability stays `ordinary` and is stated honestly. A separately
50	billed external Provider is explicit-request-only and retains no-upload planning,
51	current pricing/privacy disclosure, and exact-plan upload consent. A model name,
52	subscription, key, `full`, or `visual` alone proves neither route.
53	- `ingest_course.py` is the full-mode build entry; exit 10 is process success with
54	blocked readiness, and teaching remains forbidden. `.ingest/` is full-mode
55	build/review truth, `.lightweight/session.json` is on-demand page-batch truth,
56	`study_state.json` is progress truth, and Markdown is a generated view.
57	- Lightweight completion uses current-phase taught-batch/notebook events and skips
58	typed Guide/full-build evidence; superseded predecessors/events remain history but
59	leave the current denominator. `verified` needs revision-bound checkpoints from an
60	unchanged bank that pre-existed lightweight initialization; startup captures only
61	its immutable stat baseline. Routine health checks use metadata/physical identity,
62	not stream hashes; exact hashes occur at transitions/completion or explicit
63	`status --verify-live`. Older taught history is `unchecked_historical` until that
64	phase is resumed.
65	- MinerU, Docling, and LangGraph are named-request-only and remote/cloud-only. Never
66	download, install, probe, import, or execute them locally.
67	- Provenance is exact: 🟢 来自资料 / 🟡 AI补充，可能与你老师讲的不完全一致 / ⚠️ AI生成答案，非老师/教材提供.
68
69	## Output Contract
70
71	Output exactly one help card and mutate nothing. Student prose is English by default, Simplified Chinese for a Chinese opening, or explicit bilingual composition.
72
73	## Language packs
74
75	- `中文` → [`../../locales/zh/skills/exam-help.md`](../../locales/zh/skills/exam-help.md)
76	- `English` → [`../../locales/en/skills/exam-help.md`](../../locales/en/skills/exam-help.md)
77	- `双语` → compose both blockwise, zh then `> EN:`, under [`docs/language-policy.md`](../../docs/language-policy.md)
78
79	Display aliases are normalized to `zh`, `en`, or `bilingual`.
80
81	## Bound

People who liked this also viewed

6 picks

Type