← 返回 Skills 市场
zhoucha833-lang

exam-rescue-html

作者 zhoucha833-lang · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ 安全检测通过
104
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install exam-rescue-html
功能描述
读取 knowledge_map.json,生成三分区考前抢救清单 HTML: 核心公式速记 / 高频考点清单 / 高频错点清单,以卡片形式呈现,支持打印。 全程零等待,自动完成内容生成、模板填充、文件写入。
使用说明 (SKILL.md)

⚡️ 静默执行协议

[SYSTEM CRITICAL]

  1. Do not ask for confirmation to proceed.
  2. 全流程一次完成。 生成三类卡片内容 → 写 JSON → 填模板 → 写 HTML → 引导。
  3. 不向用户输出中间生成过程。 不输出"正在处理第X个考点…"之类提示。
  4. All errors are silent fallback. 遇到问题静默处理,不暴露给用户。

Skill:exam-rescue-html

1. 触发条件

  • 自动触发:exam-question-generator 完成后,用户说「继续」
  • 用户触发:用户说「生成抢救清单」或「最后冲刺」或「重新生成」

2. 执行流程

Step 1   确认 .exam-session/knowledge_map.json 存在且有效
Step 2   读取 {baseDir}/references/content-rules.md(三类卡片生成规则)

Step 3   生成「核心公式速记」(formula_cards):
           从 knowledge_map.points 中找含公式/定理/法则/定律的考点
           调用 knowledge-base 技能的 note_retrieve 接口检索原文
           为每条生成:name + formula + condition(可选)+ memory_hook(可选)

Step 4   生成「高频考点清单」(hotspot_cards):
           筛选 importance ≥ 0.75 的考点,按 importance 降序,最多 20 个
           调用 knowledge-base 技能的 note_retrieve 接口检索原文
           为每条生成:name + core_note(≤2句话)

Step 5   生成「高频错点清单」(mistake_cards):
           取 is_weak_point = true 的考点,补充知识库返回含"误区/注意/陷阱"的考点
           调用 knowledge-base 技能的 note_retrieve 接口检索原文
           为每条生成:name + wrong(❌开头)+ right(✅开头)+ tip(可选)

Step 6   写入 .exam-session/rescue_notes.json(格式见"输出格式")
Step 7   读取 {baseDir}/assets/template.html
Step 8   为三类卡片各自生成 HTML 片段(格式见"模板填充规范")
Step 9   将 template.html 中所有 {{占位符}} 替换为实际值,得到完整 HTML
Step 10  将完整 HTML 字符串写入 exam-rescue-YYYYMMDD.html(写到工作区根目录)
Step 11  发送引导消息

3. 输出格式

写入 .exam-session/rescue_notes.json

{
  "rescue": {
    "exam_type": "string",
    "exam_date": "YYYY-MM-DD",
    "days_remaining": 0,
    "target_score": "string",
    "generated_at": "YYYY-MM-DD",
    "formula_count": 0,
    "hotspot_count": 0,
    "mistake_count": 0,
    "formula_cards": [
      {
        "id": "f_001",
        "name": "公式/定理名",
        "formula": "公式内容(数学用 $LaTeX$,其他学科用文字)",
        "condition": "适用条件 | null",
        "memory_hook": "口诀 | null"
      }
    ],
    "hotspot_cards": [
      {
        "id": "h_001",
        "name": "考点名",
        "importance": 0.92,
        "is_weak_point": false,
        "core_note": "≤2句核心要点"
      }
    ],
    "mistake_cards": [
      {
        "id": "m_001",
        "name": "错点名称",
        "wrong": "❌ 常见错误理解",
        "right": "✅ 正确做法",
        "tip": "辨别提示 | null"
      }
    ]
  }
}

4. 模板填充规范

输出路径exam-rescue-YYYYMMDD.html(工作区根目录)

模板占位符

占位符 取值
{{exam_type}} rescue.exam_type
{{days_remaining}} rescue.days_remaining
{{target_score}} rescue.target_score
{{formula_count}} rescue.formula_count
{{hotspot_count}} rescue.hotspot_count
{{mistake_count}} rescue.mistake_count
{{formula_cards_html}} 所有公式卡片 HTML 拼接
{{hotspot_cards_html}} 所有考点卡片 HTML 拼接
{{mistake_cards_html}} 所有错点卡片 HTML 拼接

HTML 片段格式

\x3C!-- 公式卡片 -->
\x3Cdiv class="formula-card">
  \x3Cdiv class="formula-name">{name}\x3C/div>
  \x3Cdiv class="formula-body">{formula}\x3C/div>
  \x3C!-- condition 不为 null 时输出 -->
  \x3Cdiv class="formula-condition">适用:{condition}\x3C/div>
  \x3C!-- memory_hook 不为 null 时输出 -->
  \x3Cspan class="formula-hook">🔑 {memory_hook}\x3C/span>
\x3C/div>

\x3C!-- 考点卡片(importance≥0.8→imp-dot high;0.6-0.79→mid;\x3C0.6→low) -->
\x3C!-- is_weak_point=true 时加 class="hotspot-card is-weak" -->
\x3Cdiv class="hotspot-card is-weak">
  \x3Cdiv class="hotspot-header">
    \x3Cspan class="hotspot-name">{name}\x3C/span>
    \x3Cspan class="imp-dot high">\x3C/span>
    \x3C!-- is_weak_point=true 时才输出 weak-tag -->
    \x3Cspan class="weak-tag">⚠️ 薄弱\x3C/span>
  \x3C/div>
  \x3Cdiv class="hotspot-note">{core_note}\x3C/div>
\x3C/div>

\x3C!-- 错点卡片 -->
\x3Cdiv class="mistake-card">
  \x3Cdiv class="mistake-name">{name}\x3C/div>
  \x3Cdiv class="mistake-wrong">{wrong}\x3C/div>
  \x3Cdiv class="mistake-right">{right}\x3C/div>
  \x3C!-- tip 不为 null 时输出 -->
  \x3Cdiv class="mistake-tip">💡 {tip}\x3C/div>
\x3C/div>

分区隐藏规则:某类卡片数量为 0 时,在 HTML 中完整省略该 \x3Cdiv class="section"> 块(不输出空分区)。


5. 引导消息

写入 HTML 成功后立即发送:

你的考前抢救清单已生成 ✅

📐 核心公式速记 {formula_count} 条
🎯 高频考点清单 {hotspot_count} 个
⚠️ 高频错点清单 {mistake_count} 个

右上角有打印按钮,考前1小时翻看效果最佳。

接下来:
• 说「重新生成」→ 重新生成抢救清单
• 说「重新出题」→ 回到模拟题

6. 错误处理

场景 处理
knowledge_map.json 不存在 提示"请先运行考前冲刺分析",不继续
筛选后考点数 \x3C 5 触发降级条件,降至 importance ≥ 0.6
某类卡片数量为 0 省略该分区,其余正常生成
某考点知识库无内容返回 仅凭 point.name 生成,继续
rescue_notes.json 写入失败 存入会话上下文,继续执行 Step 7-11
template.html 读取失败 终止并提示"skill 文件缺失,请检查安装"

7. Anti-Patterns(严禁)

❌ 生成过程中询问"要包含哪些考点?"
❌ 将清单内容以 Markdown 文字直接输出给用户——必须按模板填充规范生成 HTML
❌ 输出 .md 文件作为产物,最终产物必须是 exam-rescue-YYYYMMDD.html(根目录)
❌ 不读取 assets/template.html 直接自行构造 HTML 结构——必须基于 template.html 填充占位符
❌ 将引导消息嵌入 HTML 文件——引导消息只能在聊天对话中以纯文本发送
❌ 向用户展示 rescue_notes.json 原始内容
❌ 某类卡片为空时输出空白分区——直接省略该 section 块
❌ wrong / right 字段写成解释而非对比——必须形成"错误理解 vs 正确做法"的直接对比

8. 用户操作响应

用户说 处理
「重新生成」 重新执行 Step 3-11,覆盖旧文件
「重新出题」 触发 exam-question-generator
其他 重新展示引导消息选项

9. 验证矩阵

场景 预期行为 禁止行为
正常流程 三分区卡片→JSON→HTML→引导 中间确认
无公式类考点(纯文科) 省略公式分区,其余正常 输出空公式分区
无薄弱点 省略错点分区或仅用RAG线索补充 强行输出空分区
考点数 \x3C 5 自动降级至 importance ≥ 0.6 提示用户"考点不足"
知识库某考点无返回 仅凭考点名生成,继续其余 跳过或报错
用户说"重新生成" 覆盖旧文件,重新执行 询问是否确认
安全使用建议
This appears safe for its stated purpose. Install it if you are comfortable with it reading your exam-session and knowledge-base notes, creating local JSON/HTML files, and loading KaTeX from a CDN when the HTML is opened. Review the final HTML for accuracy before relying on it for exam preparation.
功能分析
Type: OpenClaw Skill Name: exam-rescue-html Version: 1.0.0 The skill 'exam-rescue-html' is designed to generate a study aid HTML file based on exam knowledge maps. While it includes a 'Silent Execution Protocol' in SKILL.md that instructs the agent to operate without confirmation and suppress errors, these instructions are aligned with the stated goal of providing a 'zero-wait' automated experience. The skill's operations are limited to reading local session data, retrieving notes via a knowledge-base interface, and writing an HTML file to the workspace. No indicators of data exfiltration, unauthorized access, or malicious intent were found.
能力评估
Purpose & Capability
The stated purpose matches the artifacts: it reads an exam knowledge map and bundled template/rules, then generates a printable HTML review sheet.
Instruction Scope
The skill asks the agent to proceed without confirmation and hide intermediate progress/errors; this is aligned with the advertised zero-wait workflow but reduces transparency.
Install Mechanism
There is no install spec or runtime dependency. The only script file is explicitly marked deprecated and contains no executable logic.
Credentials
It reads local exam-session and knowledge-base content and writes local JSON/HTML outputs, which is proportionate to the skill but should be run only in the intended workspace.
Persistence & Privilege
It creates persistent files under .exam-session and the workspace root, but does not request credentials, elevated privileges, background execution, or account access.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install exam-rescue-html
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /exam-rescue-html 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
Initial release of exam-rescue-html. - Generates a printable three-section "exam rescue" checklist HTML: Core Formulas, High-Frequency Points, and Common Mistakes, based on knowledge_map.json. - Fully automated, silent execution: no confirmation or process messages, all errors handled silently. - Outputs HTML via template filling (assets/template.html), with dynamic sections omitted if empty. - Includes rescue_notes.json write (for record), but only delivers the final HTML to users. - Provides user-friendly guidance message upon completion, with options for regeneration or returning to mock questions.
元数据
Slug exam-rescue-html
版本 1.0.0
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 1
常见问题

exam-rescue-html 是什么?

读取 knowledge_map.json,生成三分区考前抢救清单 HTML: 核心公式速记 / 高频考点清单 / 高频错点清单,以卡片形式呈现,支持打印。 全程零等待,自动完成内容生成、模板填充、文件写入。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 104 次。

如何安装 exam-rescue-html?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install exam-rescue-html」即可一键安装,无需额外配置。

exam-rescue-html 是免费的吗?

是的,exam-rescue-html 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

exam-rescue-html 支持哪些平台?

exam-rescue-html 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 exam-rescue-html?

由 zhoucha833-lang(@zhoucha833-lang)开发并维护,当前版本 v1.0.0。

💬 留言讨论