exam-review

Name: exam-review
Author: ZeKaiNie

258stars14forks

How to install exam-review?

zekainie/universal-examprep-skill/exam-review

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

Installs into the current project.

Summary

考前复盘已记录错题与概念疑难：重做原题、复述疑难、更新已订正/已回顾/待回顾状态，并形成最后扫雷清单。进入最终复习阶段或用户要求复盘、查漏补缺时使用。

Files · 1

View on GitHub

SKILL.md

1	# exam-review — mistake and confusion review
2
3	## Purpose
4
5	Clear recorded mistakes/confusions before the exam. Replay only existing records; teach no new chapter and invent no question.
6
7	## Activation
8
9	Use at final review or when the student explicitly asks to replay mistakes/find gaps.
10
11	## Inputs
12
13	- `study_state.json`'s `mistake_archive` and `confusion_log` when state exists; otherwise generated 「❌ 错题档案」 and confusion compatibility rows.
14	- `references/quiz_bank.json`, used to fetch each recorded mistake by exact ID.
15
16	## Workflow
17
18	1. Replay recorded mistakes. Reload state (or `update_progress.py show`), fetch each exact bank item, and ask it again. Never add an unrecorded/bank-external question.
19
20	For `requires_assets=true` or `maybe_requires_assets=true`, before asking, explaining, hinting, or solving, render every question-side `question_context` / `figure` / `diagram` / `table` asset, labelled `题面图` or `Question-side asset`. Only later may solution/review show `答案图` / `Answer-side asset`. A path is not an image. Preserve but never display `student_attempt`; its physical path is tainted across the complete quiz, teaching, and content-unit layers, including duplicate official-looking declarations. Missing/unreadable or UI-unrenderable prompt assets cause a fail-closed skip; `stub` / `page_reference` also require the original prompt page first. Use `scripts/show_question_assets.py` for every replay and treat a nonzero result as a skip; do not render a raw bank path directly. See [`exam-quiz`](../exam-quiz/SKILL.md) and [`docs/file-format.md`](../../docs/file-format.md) §4.
21
22	2. Update mistakes. Correct replay → `已订正`; still wrong → explain from the stored explanation and retain it.
23
24	3. Replay confusions. Reload `confusion_log`; ask the student to restate what/why/how. Correct restatement → `已回顾`; vague → explain once and retain `待回顾`.
25
26	4. Persist the open list first. Compile unresolved mistakes plus `待回顾` confusions for the final sprint/`exam-cheatsheet`. Pipe each conclusion/list to `python "${CLAUDE_SKILL_DIR}/scripts/notebook.py" --workspace <ws> add-entry --chapter <ch> --type review --id <slug> --title <gist>`; same IDs replace and rebuild the index. Then send a digest and language-pack notebook link. If writing fails, say so and give the full list in chat; file-less clients use chat/text breakpoints.
27
28	5. Persist row status. If `study_state.json` is absent and Python works, run `update_progress.py --workspace <ws> init` first; only when Python truly cannot run may Markdown rows be changed in place. Write results via `update_progress.py set-mistake-status` / `set-confusion-status`, and genuinely new rows via `add-mistake` / `add-confusion`. A nonzero Python command is a fail-loud error, not permission to hand-edit. Never leave a mastered row stale or overwrite another skill's writes.
29
30	## Output Contract
31
32	- Produce one 「还没拿下的清单」 with current `已订正` / `已回顾` / `待回顾` statuses, notebook link, and refreshed panel.
33	- Persist conclusions before the digest and persist every status via `update_progress.py set-mistake-status` / `set-confusion-status`.
34	- Student prose is English by default, Simplified Chinese for a Chinese opening, or explicit bilingual blocks.
35
36	## Language packs
37
38	- `中文` → [`../../locales/zh/skills/exam-review.md`](../../locales/zh/skills/exam-review.md)
39	- `English` → [`../../locales/en/skills/exam-review.md`](../../locales/en/skills/exam-review.md)
40	- `双语` → compose both blockwise, zh then `> EN:`, under [`docs/language-policy.md`](../../docs/language-policy.md)
41
42	Display aliases are normalized to `zh`, `en`, or `bilingual`.
43
44	## Boundaries
45
46	- `study_state.json` is the source of truth; mutate rows only via `update_progress.py`. Mark replay results via `update_progress.py set-mistake-status` / `set-confusion-status`; `set-check` alone is not a substitute.
47	- Default question scope is mixed. A restricted scope excludes/counts missing `source_type`; announce any one-turn override first: 「⚠️ 临时覆盖你的 <scope> 范围偏好」 / `⚠️ Temporarily overriding your <scope> scope preference`. Use `scripts/select_questions.py`.
48	- Share confusion rows with `confusion-tracker`; replay only recorded bank items and never erase concurrent writes.

People who liked this also viewed

6 picks

Type

exam-review

258stars14forks

View on GitHub

How to install exam-review?

zekainie/universal-examprep-skill/exam-review

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

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# exam-review — mistake and confusion review
2
3	## Purpose
4
5	Clear recorded mistakes/confusions before the exam. Replay only existing records; teach no new chapter and invent no question.
6
7	## Activation
8
9	Use at final review or when the student explicitly asks to replay mistakes/find gaps.
10
11	## Inputs
12
13	- `study_state.json`'s `mistake_archive` and `confusion_log` when state exists; otherwise generated 「❌ 错题档案」 and confusion compatibility rows.
14	- `references/quiz_bank.json`, used to fetch each recorded mistake by exact ID.
15
16	## Workflow
17
18	1. Replay recorded mistakes. Reload state (or `update_progress.py show`), fetch each exact bank item, and ask it again. Never add an unrecorded/bank-external question.
19
20	For `requires_assets=true` or `maybe_requires_assets=true`, before asking, explaining, hinting, or solving, render every question-side `question_context` / `figure` / `diagram` / `table` asset, labelled `题面图` or `Question-side asset`. Only later may solution/review show `答案图` / `Answer-side asset`. A path is not an image. Preserve but never display `student_attempt`; its physical path is tainted across the complete quiz, teaching, and content-unit layers, including duplicate official-looking declarations. Missing/unreadable or UI-unrenderable prompt assets cause a fail-closed skip; `stub` / `page_reference` also require the original prompt page first. Use `scripts/show_question_assets.py` for every replay and treat a nonzero result as a skip; do not render a raw bank path directly. See [`exam-quiz`](../exam-quiz/SKILL.md) and [`docs/file-format.md`](../../docs/file-format.md) §4.
21
22	2. Update mistakes. Correct replay → `已订正`; still wrong → explain from the stored explanation and retain it.
23
24	3. Replay confusions. Reload `confusion_log`; ask the student to restate what/why/how. Correct restatement → `已回顾`; vague → explain once and retain `待回顾`.
25
26	4. Persist the open list first. Compile unresolved mistakes plus `待回顾` confusions for the final sprint/`exam-cheatsheet`. Pipe each conclusion/list to `python "${CLAUDE_SKILL_DIR}/scripts/notebook.py" --workspace <ws> add-entry --chapter <ch> --type review --id <slug> --title <gist>`; same IDs replace and rebuild the index. Then send a digest and language-pack notebook link. If writing fails, say so and give the full list in chat; file-less clients use chat/text breakpoints.
27
28	5. Persist row status. If `study_state.json` is absent and Python works, run `update_progress.py --workspace <ws> init` first; only when Python truly cannot run may Markdown rows be changed in place. Write results via `update_progress.py set-mistake-status` / `set-confusion-status`, and genuinely new rows via `add-mistake` / `add-confusion`. A nonzero Python command is a fail-loud error, not permission to hand-edit. Never leave a mastered row stale or overwrite another skill's writes.
29
30	## Output Contract
31
32	- Produce one 「还没拿下的清单」 with current `已订正` / `已回顾` / `待回顾` statuses, notebook link, and refreshed panel.
33	- Persist conclusions before the digest and persist every status via `update_progress.py set-mistake-status` / `set-confusion-status`.
34	- Student prose is English by default, Simplified Chinese for a Chinese opening, or explicit bilingual blocks.
35
36	## Language packs
37
38	- `中文` → [`../../locales/zh/skills/exam-review.md`](../../locales/zh/skills/exam-review.md)
39	- `English` → [`../../locales/en/skills/exam-review.md`](../../locales/en/skills/exam-review.md)
40	- `双语` → compose both blockwise, zh then `> EN:`, under [`docs/language-policy.md`](../../docs/language-policy.md)
41
42	Display aliases are normalized to `zh`, `en`, or `bilingual`.
43
44	## Boundaries
45
46	- `study_state.json` is the source of truth; mutate rows only via `update_progress.py`. Mark replay results via `update_progress.py set-mistake-status` / `set-confusion-status`; `set-check` alone is not a substitute.
47	- Default question scope is mixed. A restricted scope excludes/counts missing `source_type`; announce any one-turn override first: 「⚠️ 临时覆盖你的 <scope> 范围偏好」 / `⚠️ Temporarily overriding your <scope> scope preference`. Use `scripts/select_questions.py`.
48	- Share confusion rows with `confusion-tracker`; replay only recorded bank items and never erase concurrent writes.

People who liked this also viewed

6 picks

Type