Community연구 & 데이터 분석github.com

FeixueCode/concept-forge

범용 AI Agent Skill: '이 개념이 뭐야?', 'X와 Y의 차이점은?' 같은 질문을 받아, 짧은 설명 + Quarkdown 지식 원고 + 인터랙티브 HTML + Slidev 발표 자료로 변환하고 재사용 가능한 개인 지식 베이스에 저장합니다. Codex / Claude Code / Miaoclaw 등 SKILL.md를 지원하는 어시스턴트와 호환되며, 독립적인 CLI 도구로도 사용 가능합니다.

concept-forge란 무엇인가요?

Concept Forge는 사용자의 산발적인 질문을 내구성 있는 개념 자산으로 변환하는 AI Agent 스킬입니다. 핵심은 단순한 일회성 답변이 아니라, 개념을 더 쉽게 기억하고 시간이 지남에 따라 재사용 가능한 로컬 지식/HTML 라이브러리를 성장시키는 것입니다. 이 스킬은 질문 정규화, 기존 항목 조회, 연구 깊이 계획, 개념 레코드 단조, 다양한 아티팩트(JSON, Quarkdown, Markdown, HTML, Slidev 소스) 렌더링 및 저장 등 10단계의 핵심 루프를 따릅니다. Codex, Claude Code, Miaoclaw 등 SKILL.md를 지원하는 모든 에이전트와 호환되며, 명령줄에서 독립적으로 실행할 수도 있습니다. 사용자에게는 먼저 짧은 직관적인 답변을 제공하고, 이어서 상호 작용형 HTML 페이지 링크를 제공합니다. 이 스킬은 질문 의도에 따라 일반 개념, 공식 독서(Quarkdown), 공식 발표(Slidev)의 세 가지 출력 모드를 지원하며, 동적 깊이 제어(빠름/표준/깊음)를 통해 연구 및 아티팩트 생성 수준을 조절합니다.

지원 대상✓Claude Code✓Codex CLI~Cursor
npx skills add FeixueCode/concept-forge

Installed? Explore more 연구 & 데이터 분석 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Concept Forge

Concept Forge는 사용자의 산발적인 질문을 내구성 있는 개념 자산으로 변환합니다: 간결한 답변, 구조화된 지식 카드, Quarkdown 읽기 초안, Slidev 발표 초안, 그리고 독립형 인터랙티브 HTML 설명기까지 제공합니다.

목표는 일회성 답변을 생성하는 것이 아닙니다. 목표는 개념을 더 쉽게 기억하고, 시간이 지남에 따라 재사용 가능한 로컬 지식/HTML 라이브러리를 구축하는 것입니다.

핵심 루프

항상 다음 순서를 따르세요:

  1. 질문 정규화: 핵심 개념, 별칭, 비교 대상, 사용자 의도를 식별합니다.
  2. 먼저 기존 항목 조회: scripts/concept_forge.py lookup으로 확인합니다.
  3. 깊이 계획: scripts/concept_forge.py plan 또는 Research Method를 사용하여 빠름(Quick), 표준(Standard), 깊음(Deep) 중 선택합니다.
  4. 재사용 우선: 강력한 일치 항목이 있으면 기존 답변과 HTML 경로를 반환합니다. 사용자가 요청하거나, 항목이 오래되었거나, 개념이 시간에 민감한 경우에만 새로 고칩니다.
  5. 선택한 깊이로 연구: 사용 가능한 항목이 없으면, 아래 Concept Lens를 사용하고, 주제가 변경되었을 수 있거나 정확한 출처가 중요할 때는 웹 검색을 수행합니다.
  6. 개념 레코드 단조: references/concept-schema.md를 사용하여 구조화된 JSON을 생성합니다.
  7. 렌더링 및 저장: scripts/concept_forge.py upsert를 실행합니다. JSON, Quarkdown, Markdown, HTML, Slidev 소스 아티팩트를 생성해야 합니다.
  8. 배포 브랜치 확인: 사용자가 공식 읽기, PDF, 슬라이드, 발표, 미리보기, 빌드, 내보내기를 요청한 경우 scripts/concept_forge.py bootstrap "<원본 요청>"을 실행합니다.
  9. 검증: scripts/concept_forge.py validate로 저장된 항목과 생성된 아티팩트를 검증합니다.
  10. 결과 보고: 항상 답변을 먼저 제시하고, 로컬 HTML 경로를 제공합니다. 구현 세부 사항은 묻지 않는 한 언급하지 마십시오.

사용자 대상 응답 형식

모든 완료된 요청은 다음 두 가지를 순서대로 반환해야 합니다:

  1. 직접 답변: 사용자의 질문에 즉시 답하는 1-3개의 짧은 한국어 문장입니다. 기억에 도움이 될 때는 생생한 비유를 선호합니다. HTML을 열 시간이 없는 사용자를 위해 독립적으로 읽을 수 있어야 합니다.
  2. 인터랙티브 HTML: 생성되거나 재사용된 HTML 설명기에 대한 로컬 경로 또는 링크입니다.

다음과 같은 간결한 형태를 사용하세요:

한 문장으로 말하면, Skill은 AI를 위해 준비된 작은 매뉴얼과 같습니다. Prompt는 이번에 어떻게 할지를 알려주는 것이고, Skill은 앞으로 같은 유형의 작업을 만나면 항상 이 방식대로 처리하도록 하는 것입니다.

인터랙티브 페이지: <path/to/html>

기본 답변을 얻기 위해 사용자가 HTML을 열도록 강요하지 마십시오.

작업 공간

기본 작업 공간:

<current working directory>/concept-forge-workspace

사용자가 다른 저장 위치를 지정하면 그 위치를 사용하세요. 처음 사용하기 전에 초기화하십시오:

python <skill>/scripts/concept_forge.py init --workspace <workspace>

작업 공간에는 다음이 포함됩니다:

knowledge/index.json
knowledge/concepts/<slug>/concept.json
knowledge/concepts/<slug>/concept.qd
knowledge/concepts/<slug>/concept.md
knowledge/concepts/<slug>/sources.json
html/<slug>.html
slidev/<slug>/slides.md
slidev/<slug>/package.json
quarkdown/
assets/
config.json

Concept Lens

hv-analysis의 정신을 차용하되 가볍고 개념 크기로 유지하십시오.

모든 새 개념 또는 새로 고친 개념에 대해 다음 레이어에 답하세요:

  • 한 줄 기억: 가장 짧고 유용한 정의.
  • 직접 답변: 대화에 바로 사용할 수 있는 설명, 보통 한 단락, 선택적으로 비유 포함.
  • 그것이 무엇인가: 평이한 언어로 설명.
  • 그것이 왜 존재하는가: 어떤 문제, 혼란, 워크플로우, 역사적 변화가 그것을 필요로 만들었는가.
  • 그것이 어떻게 작동하는가: 그것을 이해하는 데 필요한 최소한의 메커니즘.
  • 그것이 무엇이 아닌가: 일반적인 오해와 경계선.
  • 수평 비교: 종종 혼동되는 인접 개념, 도구, 프롬프트, 워크플로우, 용어.
  • 관련 지도: 상위 개념, 하위 개념, 자식 개념, 선행 조건, 다음 질문.
  • 예시: 하나의 구체적인 일상 시나리오.
  • 기억 갈고리: 그것을 오래 기억하게 만드는 은유, 구절, 시각적 앵커.
  • 미니 퀴즈: 기억을 강화하는 2-3개의 간단한 질문.

사실이 현재, 틈새, 논란의 여지가 있거나, 제품별로 다르거나, 출처가 민감한 경우 웹 연구를 사용하십시오. 공식 문서와 1차 출처를 선호합니다. 검색하지 않은 경우, 레코드에 "모델 유추 / 사용자 제공 / 로컬 컨텍스트"로 정직하게 표시하십시오.

출력 모드

브랜치 선택

세 가지 제품 브랜치가 있습니다. 이를 정확히 구분하십시오.

  1. 일반 개념 브랜치: 사용자가 "X가 뭐야", "X와 Y의 차이점은?", "이 개념을 이해/기억/정리하는 걸 도와줘"라고 묻거나 키워드를 제공합니다. 직접 답변, Quarkdown 소스, Slidev 소스, HTML 및 인덱스를 생성합니다. Quarkdown 또는 Slidev 설치를 묻지 마십시오.
  2. 공식 읽기 브랜치: 사용자가 "공식 읽기", "긴 문서", "보고서", "PDF", "문서", "인쇄", "컴파일", "내보내기", "전달"을 요청하거나 명시적으로 Quarkdown을 언급합니다. 컴파일 전에 bootstrap을 실행하십시오. Quarkdown이 없으면 컴파일/내보내기 전에 중단하고 설치 안내를 표시합니다.
  3. 공식 발표 브랜치: 사용자가 "발표", "공개 강의", "교안", "슬라이드", "PPT", "slides", "deck", "presentation", "미리보기", "빌드", "내보내기"를 요청하거나 명시적으로 Slidev를 언급합니다. 미리보기/빌드/내보내기 전에 bootstrap을 실행하십시오. Node/npm 또는 Slidev 프로젝트 종속성이 없으면 미리보기/빌드/내보내기 전에 중단하고 설정 안내를 표시합니다.

사용자가 읽기와 발표를 모두 요청하는 경우, Quarkdown을 모체 초안으로 사용하고 Slidev를 파생된 발표 초안으로 사용한 후, 두 브랜치를 모두 확인하십시오.

브랜치 도우미 명령어:

python <skill>/scripts/concept_forge.py --workspace <workspace> plan "<original request>"
python <skill>/scripts/concept_forge.py --workspace <workspace> bootstrap "<original request>"
python <skill>/scripts/concept_forge.py --workspace <workspace> bootstrap --intent quarkdown
python <skill>/scripts/concept_forge.py --workspace <workspace> bootstrap --intent slidev
python <skill>/scripts/concept_forge.py --workspace <workspace> bootstrap --intent all

기존 항목

조회 결과 강력한 기존 항목이 발견된 경우:

  • 이미 존재한다고 말합니다.
  • direct_answer가 있으면 짧은 답변을 제공하고, 없으면 summary와 memory_hook을 사용합니다.
  • 로컬 HTML 페이지를 링크합니다.
  • 유용한 경우에만 새로 고칠 수 있는 항목을 제안하고, 기본적으로 다시 빌드하지 않습니다.

새 항목

새 개념의 경우:

  1. references/concept-schema.md를 따라 JSON 레코드를 생성합니다.
  2. 최소한 다음을 포함합니다: 제목(title), 별칭(aliases), 깊이(depth), 직접 답변(direct_answer), 요약(summary), 설명(what), 이유(why), 오해(not), 비교(comparisons), 관련(related), 기억 갈고리(memory_hook), 퀴즈(quiz), 출처(sources).
  3. 실행:
python <skill>/scripts/concept_forge.py upsert --workspace <workspace> --input <concept.json>
python <skill>/scripts/concept_forge.py validate --workspace <workspace> --slug <slug>
  1. 직접 답변을 먼저 반환하고, 생성된 HTML 경로를 반환합니다. Quarkdown 또는 Slidev 경로는 사용자가 파일, 읽기 초안, 발표, 내보내기, 디버깅을 요청할 때만 언급합니다.

새로 고침

다음 경우에만 새로 고칩니다:

  • 사용자가 업데이트/재실행/확장을 요청한 경우;
  • 항목 기간이 refresh_policy.days를 초과한 경우;
  • 주제가 현재 진행 중이거나 빠르게 변화하는 경우;
  • 출처가 부족하거나 없는 경우;
  • 사용자가 개념 경계를 변경하는 더 구체적인 후속 질문을 하는 경우.

새로 고칠 때는 명백히 잘못되지 않은 한 기존 별칭과 관련 링크를 유지하십시오.

HTML 요구 사항

정확한 제품 모양은 references/html-explainer.md를 참조하세요.

생성된 페이지는 독립적이어야 하며 다음을 포함해야 합니다:

  • 히어로 정의;
  • "무엇 / 왜 / 무엇이 아닌가" 섹션;
  • 비교 카드;
  • 관련 개념 맵;
  • 유용한 경우 타임라인 또는 기원 스트립;
  • 인터랙티브 공개 카드;
  • 미니 퀴즈;
  • "기억해야 할 세 가지";
  • 출처/업데이트 바닥글.

페이지는 채팅 기록 없이도 이해할 수 있어야 합니다.

일급 Quarkdown 및 Slidev

Quarkdown과 Slidev는 제품 모양의 일부입니다.

  • 항상 concept.qd를 Quarkdown 모체 초안으로 생성하십시오. 이것이 지식 베이스의 정식 읽기 문서입니다.
  • 항상 slidev/<slug>/slides.md를 발표 초안으로 생성하십시오. 이것은 개념 레코드와 모체 초안에서 추출됩니다.
  • 항상 html/<slug>.html을 빠른 인터랙티브 메모리 표면으로 생성하십시오.
  • 동적 깊이를 사용하여 연구, 출처 조사, 세부 수준을 결정하십시오:
    • 빠름(Quick): 안정적인 소규모 개념; 모든 소스 아티팩트를 생성하고, 일반적으로 컴파일/내보내기는 건너뜁니다.
    • 표준(Standard): 도구, 방법, 비교 및 "X가 무엇인가"에 대한 기본값; 모든 아티팩트를 생성하고 구조를 확인합니다.
    • 깊음(Deep): 사용자가 연구를 요청하거나 주제가 현재/복잡한 경우; 출처, 역사, 수평 비교 및 발표 구조를 강화합니다.
  • Quarkdown 컴파일 또는 Slidev 빌드/내보내기는 요청이 공식 브랜치에 진입한 경우에만 수행합니다. 소스 생성은 CLI가 설치되어 있지 않아도 진행할 수 있어야 합니다.
  • 첫 사용 시 일반 환경 확인을 위해 scripts/concept_forge.py doctor를 사용하십시오.
  • 공식 컴파일/내보내기 전에 scripts/concept_forge.py bootstrap "<원본 요청>"을 사용하여 설치 안내 여부를 결정하십시오.
  • Quarkdown 공식 읽기를 위해서는 quarkdown이 필요합니다. Windows에서 없는 경우: irm https://raw.githubusercontent.com/quarkdown-labs/get-quarkdown/refs/heads/main/install.ps1 | iex를 표시한 후 quarkdown doctor get install-dir로 확인하십시오.
  • Quarkdown 컴파일 시 quarkdown을 사용할 수 있으면 quarkdown c <concept.qd> --strict --out <verify-dir>를 실행하십시오.
  • Slidev 공식 발표를 위해서는 Node와 npm(pnpm)이 필요합니다. slidev/<slug>에서 npm install 또는 pnpm install을 실행한 후, 필요에 따라 npm run dev, npm run build, 또는 npm run export를 실행하십시오.
  • Slidev PDF/PPTX 내보내기를 위해서는 생성된 슬라이드 프로젝트에 먼저 playwright-chromium을 설치하십시오: npm i -D playwright-chromium.

품질 게이트

완료를 보고하기 전에 다음을 확인하십시오:

  • 생성 전에 조회가 시도되었는지;
  • 최종 응답에 직접 답변과 HTML 경로가 모두 포함되었는지;
  • 개념에 명확한 한 줄 기억이 있는지;
  • 인접 개념과 오해가 다루어졌는지;
  • HTML이 존재하고 비어 있지 않은지;
  • Quarkdown 모체 초안이 존재하는지;
  • Slidev 소스가 존재하는지;
  • 공식 브랜치가 컴파일/내보내기 전에 bootstrap을 실행했는지;
  • 누락된 공식 도구가 컴파일/내보내기 시도 전에 보고되었는지;
  • validate가 통과하는지;
  • 인덱스에 제목(title), 별칭(aliases), 슬러그(slug), 직접 답변(direct_answer), 요약(summary), Quarkdown 경로, Slidev 경로, HTML 경로가 포함되었는지;
  • 최종 답변이 짧고 사용자 대상인지.

참조

  • references/concept-schema.md: JSON 및 Markdown 레코드 모양.
  • references/research-method.md: 경량 hv-analysis 적응.
  • references/html-explainer.md: 인터랙티브 HTML 제품 사양.

관련 스킬