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	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	린트 → 자체 포함 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를 읽으세요. 사용자 자료 > 공식/1차 출처 > 참고 문헌 순서입니다. 모든 숫자, 날짜, 공식, 조문 또는 기술적 정의는 확인됩니다. 접근 가능한 출처가 없으면 <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 <saida> --json     # [--pb]

계속 진행하기 전에 린트의 모든 오류와 레이아웃 경고(넘침, 오버플로, 불균형 컬럼, 8pt 미만 글꼴)를 수정하세요. Python/브라우저가 없으면 HTML을 전달하세요(Ctrl+P → A4, 여백 없음, 배경 그래픽 포함).

6. 검증 (자료를 작성하지 않은 3명의 리뷰어)

하위 에이전트 사용 시: 세 명을 병렬로 실행하세요. 각각 자신의 agentes/*.md + HTML 및 PNG 경로 + 사용된 출처를 제공합니다. 하위 에이전트가 없으면: 세 번의 패스를 순차적으로 실행하며, 처음부터 다시 읽습니다. 차단 및 중요 항목을 수정하고, 다시 조립 및 렌더링하세요(최대 2회).

7. 전달

HTML + PDF. 2-4줄로: 생성된 내용, 사용된 스타일, 남은 [확인 필요], 주요 출처, 그림 출처. 다음 경고 줄로 마무리: AI로 생성된 학습 보조 자료입니다. 교과서, 강의, 공식 출처를 대체하지 않으므로 확인하세요.

불가침 규칙

1. 정확성 > 미학. 확인 없이 기억에 의존하지 마세요. 의심되면 [확인 필요].
2. 저작권. 타인의 텍스트, 도해, 문제를 복사하지 마세요. 타인의 이미지는 오픈 라이선스(CC0, 퍼블릭 도메인, CC BY, CC BY-SA)가 있고 출처를 표시하는 경우에만 사용하세요. 공식 법령은 문자 그대로 인용할 수 있습니다(브라질 저작권법 9.610/98, 제8조 IV항).
3. 실제 인물의 초상 금지 (텍스트에서 저자 이름을 언급하세요).
4. 흑백에서도 읽기 가능. 색상만으로 의미를 전달하지 마세요: 아이콘 + 레이블. 그림의 범례는 각 색상의 의미를 설명해야 합니다.
5. 종합 자료 밀도. 직접적인 문장, "이 요약에서 우리는" 같은 표현 금지; 강조 없이 6줄 초과 블록 = 다시 쓰기.
6. 모든 페이지에 AI 경고. 바닥글은 CSS를 통해 "AI 생성: 출처 확인"을 이미 인쇄합니다(lang으로 번역됨). 제거하지 마세요. 이 자료는 학습을 보조하며 교과서, 강의, 지도책, 공식 법령 또는 전문가의 조언을 대체하지 않습니다.