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	每個指令的模板骨架	步驟 4 開始時
assets/lucide/nomes.txt	2052 個 Lucide 圖示 (名稱: 標籤)	使用 grep，切勿完整讀取
scripts/figura.py	按領域篩選的典藏，搜尋/下載開放授權圖片 (Commons)，生成分子 (RDKit) 和圖表 (matplotlib)	步驟 4，若涉及插圖
assets/acervo.json	10 個領域中 61 個經確認的圖片（由 figura.py acervo 讀取）	不要完整讀取：使用腳本
scripts/verificar.py、montar.py、renderizar.py	Lint → 自成單一 HTML → PDF/PNG + 版面審查	步驟 5

指令

/<command> <subject_or_file> [--format f] [--style e] [--level n] [--exam_board b] [--pages N]
          [--material file] [--language 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...)、--format，或使用者明確用詞（「只要心智圖」、「快速複習」、「要有題目」）時，才算已定義。在自然語言中，「幫我做一份講義/摘要/關於 X 的教材」不代表定義了格式：請提問。當需要提問時，將風格問題放在同一則訊息中。當主題和格式都已確定時，不要再問其他問題：若未指定風格，則使用使用者在本次對話中已使用過的風格，否則使用沉穩（並在交付時用一行文字提示 --style colorido|pastel|pb）。像「再多點色彩」、「少點顏色」、「要印成黑白的」這類請求會改變風格。

語言： 使用使用者的語言（或 --language）來書寫材料與回覆。若非 pt-BR，請在撰寫 HTML 之前閱讀 references/idiomas.md。 創作自由：基於最佳教學效果選擇元件、順序和重點。

2. 收集內容 (正確性優先於美觀)

閱讀 references/fidelidade.md。使用者提供的材料 > 官方/主要來源 > 參考文獻。每個數字、日期、公式、條款或技術定義都需經過驗證；若無可取得的來源 → 使用 <span class="verificar">。請儲存附有 URL 的來源，供參考文獻使用。

3. 教學大綱 (大學程度)

每個子主題：精確定義 → 機制/原因 → 範例 → 常見錯誤。根據內容形式選擇元件 (references/design.md §3)，並為所有具有結構的內容製作插圖。連續文字僅用於概念，簡潔且有重點標記。

4. 從模板撰寫原始 HTML

將 assets/templates/<command>.html 複製為 <slug>-fonte.html，並取代所有 [[MARKER]]。

• <html lang="…" data-theme="sobrio|colorido|pastel|pb"> 根據語言和風格設定 (design.md §1.1)。每個主題使用固定顏色：在區塊/欄位上使用 class="cor-1" … cor-6。
• 僅使用設計系統中的類別 (references/componentes.md)；style="" 僅用於微調。
• 無頁數限制： 指令的大小是預設的，而非上限。若內容無法容納，則加到新的 .folha；除非使用者指定 --pages N，否則切勿為了塞入而刪減內容。
• 題目永遠使用單一欄位，並放在單獨的頁面上。附註解解答和參考文獻放在獨立的頁面，在題目之後（不要在同一頁爆雷）。
• 附連結的參考文獻：<a href="官方 URL">標題</a>。
• 圖示：Lucide (<svg class="ico"><use href="#l-NOME"/></svg>，使用 grep -i term 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     # [--embutir-fontes]
python3 <skill>/scripts/renderizar.py <slug>.html <output> --json     # [--pb]

修正 lint 中的所有 ERROR 以及所有版面警告（溢出、內容超出、欄位不平衡、字型 < 8 pt）後再繼續。若無 Python/瀏覽器：交付 HTML 檔案 (Ctrl+P → A4，無邊距，移除背景圖形)。

6. 驗證 (3 位未參與撰寫的審稿人)

使用子代理：同時執行三個審稿人，各自使用其 agentes/*.md 加上 HTML 和 PNG 的路徑以及所使用的來源。若無子代理：依序進行三次審查，每次從頭重新閱讀。修正 BLOCKING 和 IMPORTANT 的問題，重新組裝並渲染（最多 2 輪）。

7. 交付

HTML + PDF。用 2–4 行說明：生成的內容、使用的風格、剩餘的 [VERIFY] 標記、主要來源和圖片出處。最後以一行警告結尾：此為 AI 生成的輔助學習材料；不能取代書籍、課程或官方來源；請自行查證。

不可妥協的規則

1. 正確性 > 美觀。 未經查證的記憶一律不採用；有疑問時使用 [VERIFY]。
2. 著作權。 不得複製第三方的文字、圖示或考題。第三方圖片僅能在具有開放授權 (CC0、公有領域、CC BY、CC BY-SA) 並標註出處時使用。官方法條可逐字引用 (Lei 9.610/98, art. 8º, IV)。
3. 不得使用真人肖像 (在文字中引用作者姓名)。
4. 黑白列印須可讀。 顏色永遠不是唯一的意義載體：需要同時使用圖示 + 標籤。在圖中，圖例必須說明每種顏色的意義。
5. 講義式密度。 句子直接了當，避免「在本摘要中我們將看到」；若區塊超過 6 行而無重點標記，請改寫。
6. 每頁須有 AI 生成警告。 頁尾已印出「AI 生成：請查證來源」(透過 CSS，根據 lang 翻譯)；請勿移除。此材料為學習輔助用，不能取代書籍、課程、地圖集、官方法規或專業指導。