Communitygithub.com

学习站点

用于创建交互式、单文件HTML学习页面,如课程笔记、章节复习、考试准备或课程索引,基于幻灯片、PDF、历年试卷、练习题或仅凭主题名称。

学习站点 是什么?

该技能专为构建高质量的单文件HTML学习页面而设计,可发布为“制品”或保存为 `.html` 文件。它从一个标准模板 `assets/template.html` 开始,确保所有关键功能(如暗色主题切换、滚动位置恢复、进度跟踪和搜索)始终包含在内。该技能通过一系列规则和检查表引导用户(或AI代理)完成从需求澄清、材料收集到页面构建和发布的完整流程,确保内容结构清晰、教学性强,并针对不同学科(理论、系统、语言、数学、描述性)提供自适应教学重点。它支持课程页面(含考试模式和复习工具)和通用主题页面,并能自动处理历年试题、图解说明、交互式选择题和答题反馈。最终输出是可直接运行的、设计精良的交互式学习资源,遵循极简、语义化的设计原则,避免常见的“AI生成”风格。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Ranjit-choudhary/claude-skills-ranjit/tree/HEAD/study-site

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

学习站点 是做什么的?

构建交互式、单文件 HTML 学习页面,作为“制品”发布(或在无法使用“制品”的地方保存为 .html 文件)。每个页面都从 assets/template.html 开始,因此永远不会遗漏标准功能。

0. 设置 — 根据自身情况编辑

设置项值
主索引 URL(连接所有课程的枢纽)none — 设置为你自己的枢纽 URL,或保留 none 以跳过索引更新
默认主题light(始终包含暗色切换按钮)
章节导航仅返回课程索引的链接 — 不包含上一页/下一页链接
索引卡片样式极简:图标、课程代码、课程名称 — 无统计数据

1. 先提问(一轮问题)

仅询问请求中尚未明确的点:

  1. 这是针对某门课程的吗? 如果是:哪门课程、哪个章节或哪部分内容。课程页面会在标准功能基础上增加考试模式和复习工具;非课程页面(通用主题、一次性讲解)则跳过这些功能。
  2. 它应该被列在哪里? 直接在主索引上、在某个课程的学习索引内(哪个索引)、或者不列入任何地方。如果主索引设置为 none,则跳过此问题。
  3. 如果不知道课程学习索引的 URL,请询问 — 页面的“返回”链接需要它。

如果用户保存了关于他们希望如何教授某门课程的笔记(备忘录、项目说明、之前的信息),请阅读并遵循它们,覆盖下述默认设置。

2. 在构建前收集材料

  • 完整阅读每个附件:幻灯片、笔记、历年试卷、练习题。
  • 收集属于每个主题的历年试题(PYQ)和练习题。
  • 静默修正原始材料中的错误;除非被要求,否则不要指出它们。
  • 只有在此之后,再规划主题列表:每个逻辑主题一个 <section class="topic">,足够小以便一口气完成。

3. 教学规则(所有学科)

  • 假设无先验知识。从基础开始构建,首次使用时定义每个术语,细化而非压缩。
  • 每个主题内的顺序:讲解 → 紧跟其图解 → 图解说明 → 示例 → PYQ/练习题 → 练习选择题。 切勿将图解批量放在末尾。
  • 每个图解都必须配有说明。绝不发布没有说明的图解。
  • 使用 .callout.imp 标记考试重点,使用 .callout.mistake 标记常见陷阱。
  • 题目: 完整写出每道题目,然后给出解答,切勿缩写。回答所有题目;不留任何未解答的题目。用来源、年份和分值标记 PYQ(例如 PYQ 2024 期中 · 5分)。
  • 每个主题至少 3 道练习选择题,包含似是而非的干扰项和 .why 解释。
  • 图解使用内联 SVG,绝不用 ASCII。对于逐步演进的内容,使用 .stepper(每个状态一个 figure.fig.step)。
  • 除非被要求,否则不制定学习计划或日程安排。

4. 按学科调整

学科类型重点
理论 / 证明(计算理论、离散数学、算法)每个自动机的状态图;追踪输入字符串的步进器;证明模板(泵引理、归约、归纳法)作为填空步骤;许多小例子
系统(操作系统、计算机体系结构、网络)视觉优先;流水线、调度甘特图、页面置换、缓存查找的步进器;逐步求解的数值题;教科书章节末习题
语言 / 形式化符号(程序设计语言、编译器)干净的 SVG 树形图的 BNF/EBNF、语法分析树和属性文法;逐步构建正则表达式;内联解答的练习题
数学密集型(机器学习、统计学、信号)先直觉,然后逐行推导,每一步都要有理由;SVG 绘图;带有解答的教科书习题
描述性(生物学、管理学、人文学科)以历年试卷为驱动:按主题分组 PYQ,以考试长度提供模型答案,使用流程图和比较表进行流程讲解

对于未列出的学科,选择最接近的一行。用户自己的课程笔记优先于本表。

5. 页面功能(内置于模板中)

功能工作原理你的职责
浅色主题 + 暗色切换默认为浅色;🌙 切换;记住选择仅使用 CSS 变量 — 不要硬编码颜色
滚动位置恢复保存并在重新打开时恢复滚动位置无需操作
进度跟踪每个主题“标记为已完成”,进度条,目录中的 ✓每个主题部分设置唯一的 id
搜索过滤主题并高亮匹配项无需操作
复制图像每个 figure.fig 上的悬停按钮可复制 PNG(触摸设备上始终可见)将每个图解或图像包裹在 figure.fig 中
移动端友好响应式;表格横向滚动保持基于 viewBox 的 SVG;不使用固定宽度
练习选择题即时反馈;记住答案data-answer = 正确选项的 0 基索引
显示答案details.answer用于每个长形式解答
返回链接页眉链接到课程学习索引填写 {{COURSE_INDEX_URL}}
仅课程页面: 复习工具速查表(.cheatsheet)+ 闪卡(.flashdeck)公式、定义、关键图表的单页摘要;10 张以上闪卡
仅课程页面: 考试模式模糊显示直到点击开始;计时器;提交时批改选择题;显示模型答案混合使用带 data-marks 的选择题和仿照课程历年试卷风格的长问题;设置 data-minutes

进度和分数存储在浏览者的浏览器中,每个页面独立 — 索引页面无法显示章节进度,并且无法跨设备同步。

6. 设计规则

  • 极简且平静。正文使用衬线字体以便长时间阅读,UI 使用无衬线字体。内容宽度约 820px。
  • 避免 AI 生成内容的俗套:无紫色渐变、英雄横幅、全居中布局、Inter 字体或表情符号五彩纸屑。
  • 颜色承载含义:蓝色 = 信息,金色 = 考试重要,红色 = 错误,绿色 = 正确/完成。
  • SVG 图解:标注所有元素;使用 var(--text)、var(--accent) 等作为描边和填充;文本在移动端宽度下 ≥ 12px。

7. 课程学习索引页面

对于课程索引或枢纽:极简卡片(见设置),相同页眉(搜索 + 主题切换),滚动恢复,浅色默认主题。

8. 构建、发布、检查

  1. 复制 assets/template.html,填写 {{占位符}},对于非课程页面删除课程专属区块(对于课程页面则取消注释)。
  2. 作为“制品”发布(或保存为 .html)。先展示页面;发布后检查。
  3. 在桌面端和约 390px 宽度下检查,并在两种主题下检查:每个图形都有复制按钮,每个选择题都有正确的 data-answer,每个问题都有答案,没有剩余的 {{占位符}}。
  4. 按照步骤 1 中选择的位置,将页面链接添加到主索引或课程索引中。不要重新设计索引页面。

相关技能