Textbook exercises
Skill cabbage2000-lab/textbook-writer-skills/skills/textbook-exercises
基于 UbD 逆向设计的教材写作 skill 组合(支持 Claude Code / Codex CLI):教学定位 → 五件套 gate → 章节树 gate → 逐章写作,例题真算验证、中断可续写,面向数学/物理/计算机等 STEM 学科成体系教材写作
npx -y skills add cabbage2000-lab/textbook-writer-skills --skill textbook-exercisesAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- 23 days oldThe repository was created 23 days ago. New is not bad, but a brand new repository carrying a familiar-sounding name is the shape a typosquat arrives in, and there has been no time for anyone else to find a problem with it.
- 9 stars9 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
Use when generating verified STEM exercises with Bloom-level tags — 示范例题(完整解题过程)、引导练习(带提示)、独立习题(附参考答案)— e.g. "出几道矩阵乘法的练习题"、"给这一章生成例题". Every computational answer is actually verified (真算核对) before output. Usually called by textbook-chapter; can run standalone. Not for 文科论述题 (v2) or exam paper assembly.
SKILL.md
4.0 KB, ~1.3k tokens by cl100k_base, as published. Nobody here has run it
textbook-exercises
为 STEM 教材生成三类题(示范例题/引导练习/独立习题),每道题带 Bloom 层级标注,每个计算答案都经过真算验证才输出。设计与验证规范的权威来源是 references/exercise-design.md。
何时不触发
- 文科论述题、案例分析题(v1 不支持;被要求时说明属 v2 范围,可改出概念辨析题替代)
- 组卷/试卷排版(本 skill 只产题目内容)
- 非 STEM 内容的一般性问答
两种调用模式
- 被 textbook-chapter 调用(常规):输入 = 契约
{章上下文, 题目计划, 术语表}(字段定义见 ../textbook/references/handoff-contract.md 第 2 节)。按题目计划逐条生成,不多不少。 - 独立触发:一轮问清
{主题, 读者水平, 三类题各要几道, 期望 Bloom 层级分布}(用户已说明的不重复问),术语自拟并保持内部一致;编号中的章号默认取 1,用户指定章号则从之。
生成流程(每道题走完 1–4 才算完成一道)
-
设计题面:按 references/exercise-design.md 第 4 节对应题类的要点设计,对照题目计划的主题与 Bloom 层级;层级判定标准查 ../textbook-outline/references/bloom-levels.md 第 4 节(同题多问取最高层,歧义就低不就高)。
-
同步写完整解答:示范例题 = 逐步推导每步一行理由;引导练习 = 提示阶梯(提示 1 方向 → 提示 2 关键步骤)+ 完整解答;独立习题 = 参考答案或含关键中间结果的解题路径。禁止先攒题后补答案。
-
真算验证(红线,不可省略):按 exercise-design.md 第 2 节选验证方式——
- 数值计算/符号推导类:写一段与解答路径不同的 Python(sympy/numpy)复算代码,用 Bash 实际执行,比对结果;
- 代码题:实际运行代码核对输出;
- 证明题:逐步核验每步依据(引用的定义/定理是否成立且已在教材前文出现);
- 概念辨析:核对定义来源;
- 当前环境无法执行 Python 时:手算两遍交叉核对,验证状态注明"手算交叉核对"。
-
处理验证结果:复算一致 → 标
✅ 已验证(<方式>);不一致 → 修题或修解答后重新验证;连续 2 次验证失败 → 弃题换题。确实无法机器验证且手算不可行(如开放性数值实验)→ 标⚠️ 需作者确认(<原因>),绝不假装已验证。
输出
- 按契约逐题给出
{编号, 类型, 题干, 解答或提示, Bloom层级, 验证状态}; - 正文格式遵循 exercise-design.md 第 6 节(编号规则
例 N-M/习题 N-M,引导练习计入"例"序列加后缀); - 验证用的复算代码随题附上(放在"验证"行后的代码块中),供作者复查;
- 术语用词严格对照传入的术语表;独立触发时保持自拟术语的内部一致。
纪律(违反任何一条即返工)
- 绝不输出未验证的计算答案——"应该没错"不是验证;
- 开放题给参考要点并标注"开放题",不编造标准答案;
- 每题必有 Bloom 标注,漏标即不完整;
- "留给读者作为练习"式悬空 = 违规(exercise-design.md 第 3 节第 6 条);
- 出题偏离题目计划的主题或层级时,须在输出中注明偏离原因(如"该主题在应用层无自然题型,改为分析层"),由调用方决定是否接受。