asguth/grifo

Grifo-Skill

あらゆる科目について大学レベルの学習教材を、テーマまたはユーザーのファイルから生成します。2段組のA4シート、落ち着いた編集階層、図、表、オリジナルの練習問題を提供。すべての教材は、提供前に3人のレビュアー（内容、教育法、デザイン）による検証を経ます。

以下のパスは、この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	2,052個の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

コマンド

/<コマンド> <トピックまたはファイル> [--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、またはユーザーの明示的な言葉（「図解のみ」、「クイックレビュー」、「問題付き」）によって定義された場合のみ確定と見なします。自然言語で「教材/まとめ/資料を作って」はフォーマットを定義しません。質問してください。質問する際は、スタイルも同じメッセージで一緒に質問してください。トピックとフォーマットが確定したら、それ以上質問しないでください。スタイルが指定されていない場合 = この会話でユーザーが既に使用したスタイル、そうでなければ落ち着いた（納品時に --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 を <スラッグ>-fonte.html にコピーし、すべての [[MARKER]] を置き換える。

• <html lang="…" data-tema="sobrio|colorido|pastel|pb"> を言語とスタイルに従って設定（design.md §1.1）。トピックごとに固定色：ブロック/カラムに class="cor-1" … cor-6。
• デザインシステムのクラス（references/componentes.md）のみ。style="" は細かい調整のみ。
• 枚数制限なし: コマンドのサイズは標準であり、上限ではありません。収まらないコンテンツは新しい .folha に配置。ユーザーが --folhas N を指定した場合を除き、収めるためにコンテンツを削減しないでください。
• 問題は常に1カラムで、問題のみのシートに。解説付き解答例と参考文献は問題の後の別シート（同じシートにネタバレ禁止）。
• 参考文献へのリンク：<a href="公式URL">タイトル</a>。
• アイコン：Lucide（<svg class="ico"><use href="#l-NAME"/></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 <saida> --json     # [--pb]

lintのすべてのERRORとレイアウト警告（はみ出し、オーバーフロー、カラムの不均衡、フォントサイズ8pt未満）を修正してから次に進んでください。Python/ブラウザがない場合：HTMLをそのまま提供（Ctrl+P → A4、余白なし、背景グラフィック）。

6. 検証（教材を書いていない3人のレビュアー）

サブエージェントを使用：3人を並行して実行。各レビュアーは自身の agentes/*.md + HTMLとPNGのパス + 使用した情報源を使用。サブエージェントがない場合：3回のパスを順番に、ゼロから読み直して実行。BLOCKERとIMPORTANTを修正し、再組立て・レンダリング（最大2ラウンド）。

7. 納品

HTML + PDF。2～4行で：生成内容、使用したスタイル、残存する [VERIFICAR]、主要情報源、図版のクレジット。以下の注意書きで締めくくります：この教材はAIによって生成され、学習支援を目的としています。書籍、講義、公式情報源に代わるものではありません。内容を必ず確認してください。

譲れないルール

1. 正確さ > 見た目。 確認なしの記憶による記述は禁止。疑問がある場合は [VERIFICAR]。
2. 著作権。 第三者のテキスト、図、問題をコピーしない。第三者の画像はオープンライセンス（CC0、パブリックドメイン、CC BY、CC BY-SA）かつクレジットがある場合のみ使用可能。公的な法令は直接引用可能（著作権法第9条）。
3. 実在の人物の肖像は使用禁止（テキストで著者名を記載）。
4. 白黒でも判読可能。 色は唯一の意味伝達手段としない：アイコン + ラベル。図版では凡例で各色の意味を説明。
5. 教材の情報密度。 簡潔な文、「この要約では見ていきます」のような表現は避ける。6行以上で強調のないブロックは書き直す。
6. 全シートにAI生成の注意書き。 フッターに「AI生成：情報源で確認」と表示（CSS経由、langで翻訳）。削除しない。教材は学習を補助するものであり、書籍、講義、地図帳、公式法令、専門家の指導に代わるものではありません。