asguth/grifo

Grifo-Skill

基于用户提供的主题或文件，生成大学级别的、关于任何学科的学习材料：双栏 A4 页面、庄重的编辑层级、图表、表格、插图以及原创习题。所有内容在交付前均需经过三位审稿人（内容、教学法、设计）的审核。

以下路径均相对于此 SKILL.md 所在的文件夹。

路径	说明	何时阅读
references/comandos.md	语法、标志位以及每个命令的详细说明	始终：只需阅读“语法”部分和对应命令部分
references/design.md	调色板、颜色风格、层级、组件选用、图标	编写 HTML 之前
references/ilustracoes.md	教学插图：开放资源、生成器、许可协议和版权声明	当主题涉及物理结构时
references/idiomas.md	其他语言的材料：标签、字体、其他国家考试	如果语言不是 pt-BR
references/componentes.md	每个组件的 HTML 代码	编写 HTML 之前
references/fidelidade.md	来源、引用和带链接的参考文献	开始调研之前
references/bancas.md	所属考委会的风格	仅当涉及特定考委会时
agentes/*.md	3 位审稿人的提示词	步骤 6
assets/templates/*.html	每个命令的 HTML 骨架	步骤 4 开始时
assets/lucide/nomes.txt	2052 个 Lucide 图标（名称: 标签）	使用 grep 查找，切勿完整读取
scripts/figura.py	按领域精选的图片库、搜索/下载开放许可图片（Commons）、生成分子结构（RDKit）和图表（matplotlib）	步骤 4，如需插图
assets/acervo.json	61 张经过核实的图片，涵盖 10 个领域（由 figura.py acervo 读取）	不要完整读取：使用脚本
scripts/verificar.py、montar.py、renderizar.py	静态检查 → 自包含 HTML → PDF/PNG + 布局审查	步骤 5

命令

/<命令> <主题或文件> [--formato f] [--estilo e] [--nivel n] [--banca b] [--folhas N]
          [--material arq] [--idioma xx]

/resumo、/esquema、/lei-seca、/comparar、/pegadinhas、/questoes、/flashcards、/mnemonico、/edital、/cronograma、/revisao、/apostila、/validar、/grifo（帮助）。/cmd、cmd: 以及自然语言 → 执行相同流程。遇到未知标志 → 提示并继续使用默认值。遇到不存在的命令 → 显示 /grifo 帮助。详情请参阅 references/comandos.md。

流程（请按顺序执行）

1. 理解请求 —— 缺失信息时提问

如果请求未提供主题/文件或格式，请一次性提问（在 Claude Code 中，如果有提问工具则使用它），提供以下选项：

1. 主题或文件： "你需要关于哪个主题的材料 —— 还是上传一个文件（PDF、幻灯片、笔记）？"
2. 格式：
   • 完整讲解 —— 教学摘要（默认 2–4 页，无上限）+ 习题 + 答案 (/resumo)；
   • 仅思维导图 —— 视觉大纲，默认 1 页 (/esquema)；
   • 快速复习 —— 考前速览，默认 1 页 (/revisao)；
   • 练习 —— 习题 + 带讲解的答案 (/questoes) 或闪卡；
   • 全部包含 —— 封面、目录、摘要、思维导图、闪卡、习题和答案 (/apostila)。
3. 视觉风格（每个人学习方式不同）：
   • 素雅 —— 海军蓝和灰色，仅在需要传达含义时使用颜色（默认）；
   • 彩色 —— 每个主题使用不同颜色，色块填充；
   • 淡彩 —— 各主题使用柔和色调，浅色背景；
   • 黑白 —— 灰色调，用于黑白打印。
4. 级别（仅在无法推断时提问）：高中、大学（默认）、公考（询问考委会）、认证。

当格式来自带斜杠的命令（/esquema、/revisao...）、--formato 或用户明确的措辞（"仅思维导图"、"快速复习"、"带有习题"）时，才视为已定义。对于自然语言，"帮我做一份讲义/摘要/关于 X 的材料"不定义格式：请提问。如需提问，请在同一消息中同时提问风格。当主题和格式都确定后，不要再问任何问题：未指定风格 = 会话中用户已使用的风格，否则为素雅（并在交付物中用一行注明 --estilo colorido|pastel|pb）。类似“颜色再多一点”、“颜色少一点”、“请用黑白打印”等请求会改变风格。

语言： 请使用用户的语言（或 --idioma 指定的语言）编写材料并进行回复。对于非 pt-BR 的语言，请在编写 HTML 前阅读 references/idiomas.md。 创作自由：选择最能帮助学习的组件、顺序和重点。

2. 搜集内容（准确性优先于美观性）

阅读 references/fidelidade.md。用户提供的材料 > 官方/一手来源 > 参考文献。每个数字、日期、公式、条款或技术定义都需核对；若无可靠来源 → 添加 <span class="verificar">。请保存带有 URL 的来源以便引用。

3. 教学设计路线（大学级别）

针对每个子主题：精确定义 → 机制/原理 → 示例 → 常见错误。根据内容形式选择组件（references/design.md 第 3 节），并为所有具有结构的内容配图。仅概念部分使用连续文本，务必简短并突出关键点。

4. 基于模板编写 HTML 源文件

将 assets/templates/<命令>.html 复制为 <slug>-fonte.html，并替换所有 [[占位符]]。

• <html lang="…" data-tema="sobrio|colorido|pastel|pb"> 根据语言和风格（design.md 第 1.1 节）。每个主题固定颜色：在块/列上使用 class="cor-1" … cor-6。
• 仅使用设计系统中的类（references/componentes.md）；仅对微调使用 style=""。
• 无页数上限： 命令的大小是默认值而非上限。内容放不下时，移至新的 .folha 页面；切勿为了塞下内容而裁剪，除非用户指定了 --folhas N。
• 习题始终单列显示，独占一页。带讲解的答案和参考文献放在习题之后单独一页（避免同一页出现答案剧透）。
• 参考文献带链接：<a href="官方 URL">标题</a>。
• 图标：Lucide（<svg class="ico"><use href="#l-名称"/></svg>，使用 grep -i 关键词 assets/lucide/nomes.txt 查找名称），仅当它们能传达块含义时使用。
• 具有物理结构的主题（解剖学、生理学、细胞、植物、分子、电路、实验室装置、地图）：图片是页面的核心，且必须来自开放资源（先 scripts/figura.py acervo，然后 buscar/baixar）或基于数据生成（figura.py molecula、figura.py grafico）。切勿凭记忆绘制学术结构：AI 会在无意识中画错解剖结构。必须注明版权。方法详见 references/ilustracoes.md。

5. 检查、组装和渲染

python3 <skill>/scripts/verificar.py <slug>-fonte.html
python3 <skill>/scripts/montar.py <slug>-fonte.html <slug>.html     # [--fontes-embutidas]
python3 <skill>/scripts/renderizar.py <slug>.html <输出> --json     # [--pb]

继续前，请修正 lint 报告中的所有错误以及所有布局警告（溢出、文本超出、列不平衡、字体 < 8 pt）。若没有 Python 或浏览器：直接交付 HTML 文件（Ctrl+P → A4，无边距，关闭背景图形）。

6. 验证（由 3 位未编写该材料的审稿人执行）

若有子代理：并行运行三位审稿人，每位使用各自的 agentes/*.md 以及 HTML 和 PNG 的路径、所用来源。若无子代理：串行执行三轮，从头重读。修正阻塞性和重要性问题，重新组装并渲染（最多 2 轮）。

7. 交付

提供 HTML + PDF。用 2–4 行说明：生成的内容、使用的风格、剩余的 [VERIFICAR] 标记、主要来源和图片版权。最后加一行警告：该材料由 AI 生成，用于辅助学习；不能替代书籍、课程或官方来源；请自行核实。

不可妥协的规则

1. 准确性 > 美观性。 未经核实的记忆内容一律拒绝；不确定之处标记为 [VERIFICAR]。
2. 版权。 不得复制第三方文本、大纲或习题。第三方图片仅限使用开放许可（CC0、公共领域、CC BY、CC BY-SA）并注明版权。官方法令可原文引用（巴西版权法 9.610/98，第 8 条第 IV 款）。
3. 不得使用真人肖像（在文本中引用作者姓名即可）。
4. 黑白打印可读。 颜色绝不能是传达含义的唯一手段：图标 + 标签应同时使用。图片中的图例需说明每种颜色的含义。
5. 讲义密度。 句子简洁，避免“在本摘要中我们将看到”等冗余表达；超过 6 行无重点标记的段落需重写。
6. 每页 AI 警告。 页脚已默认打印“由 AI 生成：请核对来源”（通过 CSS 实现，根据 lang 属性翻译）；请勿删除。该材料辅助学习，不能替代书籍、课程、专业图集、官方法律或专业指导。