textbook-chapter

Solid

按大纲切片与 UbD 锚点写一章教材正文时用它:固定四段式结构——概念讲解 → 示范例题 → 引导练习 → 独立习题。触发语如"写第三章"、"按大纲写这一章"。通常由 textbook 调度,也可单独运行,用来写一篇带完整例题的深度技术文章。不负责设计大纲,也不负责整本书的调度;只是问一个知识点、要一段解释而不是成篇教材内容时,也不要用它。需与 textbook 系列其余 skill 装在同一 skills 目录下。

AI & Automation 27 stars 7 forks Updated 1 weeks ago MIT

Install

View on GitHub

Quality Score: 86/100

Stars 20%
48
Recency 20%
90
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# textbook-chapter 按四段式模板写一章教材正文:概念讲解 → 示范(教)→ 引导(扶)→ 独立(放)四段,外加章引言与本章小结。章结构的权威来源是 [references/chapter-template.md](references/chapter-template.md),文体规范是 [references/writing-style.md](references/writing-style.md)。 四段的**标题文案**、后三段的**具体教学动作**、配图类型与文体附加条款取自输入契约里 `学科档案` 指定的档案第 4 节——规格与索引见 [../textbook/references/subject-profile-spec.md](../textbook/references/subject-profile-spec.md),开写前先读该档案第 4 节。 ## 何时不触发 - 设计教材大纲(用 textbook-outline) - 全书多章调度(用 textbook) - 只要题目不要正文(用 textbook-exercises) ## 两种调用模式 - **被 textbook 调度**(常规):输入 = 契约 `{章号, 章标题, 该章大纲切片, UbD五件套, 术语表, 前章小结, 学科档案, 答案排版}`(字段定义见 [../textbook/references/handoff-contract.md](../textbook/references/handoff-contract.md) 第 2 节;第 1 章的前章小结为空)。 - **独立触发**(写深度技术文章):`答案排版` 恒为 `inline`(没有教材项目目录,答案无处可搬);一轮问清 `{主题, 读者水平, 篇幅}`;按主题自行判定学科档案(索引见 subject-profile-spec.md 第 5 节,找不到匹配项按该文档第 7 节处理);自拟**轻量版五件套**(只取三件)——1 条持久理解("读者将理解:……"句式)+ 1 个核心问题 + 1–3 条学习目标(章首学生版目标的来源),连同选定的档案 id 一并向用户展示后开写(不设 gate,展示即可);无外部术语表时自建(两节结构与列定义同契约文档第 3 节,附加结构按档案第 4 节),无前章小结则引言直接从动机切入。 ## 上下文隔离纪律(不可违反) 只接收上述输入契约,**不读入其他章正文**。跨章一致性靠三个轻量载体:术语表、前章小结、UbD 五件套(契约文档第 6 节)。"顺便读一下前几章找感觉"是违规——上下文膨胀会让长教材写不完。 ## 写作流程 1. **打印进度**:被调度时打印 `▶ 第 N/M 章:<章标题>`;独立触发时打印章标题。 2. **起草章骨架**:按 [references/chapter-template.md](references/chapter-template.md) 第 2 节的完整模板起草—— - 引言:从前章小结的核心结论衔接进入,呼应五件套中的一条核心问题,先"为什么"再"学什么"; - `## 本章学习目标`(章首件,任何档案下标题都是这一行):把大纲切片里"该章承载的学习目标原文"改写成学生版——第二人称、**去掉编号与 Bloom 标注**、保留可判断的动词,条数与切片给的**一样多**,不新增不合并(要点见 [references/chapter-template.md](refer...

Details

Author
cabbage2000-lab
Repository
cabbage2000-lab/textbook-writer-skills
Created
1 months ago
Last Updated
1 weeks ago
Language
Python
License
MIT

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Solid

textbook

写一整本多章节教材或成体系的课程讲义(含习题)时用它:按 UbD 逆向设计调度五个阶段——教学定位 → UbD 预期结果(gate)→ 章节树(gate)→ 逐章写作 → 审核定稿;进度落盘 .progress.json,中断后可从断点续写。触发语如"写教材"、"写一本教材"、"编写课程讲义"、"系统教材"、"textbook"。只写单篇教程、只写一章(用 textbook-chapter)、只出习题(用 textbook-exercises)时不要用它。需与 textbook-outline、textbook-chapter、textbook-exercises 装在同一 skills 目录下。

27 Updated 1 weeks ago
cabbage2000-lab
AI & Automation Solid

textbook-init

动笔写教材前要先规划并创建工作目录时用它:规划单本教材项目目录或多教材工作区,可选 git 版本管理与 README 工作说明,建好后把产出交接给 textbook。触发语如"初始化教材项目"、"创建教材工作目录"、"规划教材工作区"、"建一个写教材的目录"。只搭目录骨架,不创建流水线文件(.progress.json、00-教材设计.md、术语表.md)。写正文用 textbook(不经 init 它也会自建默认目录),续写已有项目直接用 textbook。需与 textbook 系列其余 skill 装在同一 skills 目录下。

27 Updated 1 weeks ago
cabbage2000-lab
AI & Automation Solid

textbook-outline

教材项目要做教学设计时用它:产出教学定位、UbD 预期结果五件套(大概念 / 持久理解 / 核心问题 / 迁移目标 / 学习目标)、章节树与例题 Bloom 梯度规划,写入 00-教材设计.md。触发语如"设计教材大纲"、"教材规划"、"课程体系设计"。通常由 textbook 调度,也可单独运行。不负责写章节正文,也不负责生成习题。需与 textbook 系列其余 skill 装在同一 skills 目录下。

27 Updated 1 weeks ago
cabbage2000-lab