Communitygithub.com

ankaiinc/diagrams-for-agents

AI 코딩 에이전트를 위한 비즈니스 다이어그램(기본 로컬 모드, 개인정보 보호)

diagrams-for-agents란 무엇인가요?

이 스킬은 AI 코딩 에이전트(예: Claude Code, Cursor)가 사용자의 소스 자료를 기기 밖으로 보내지 않고 비즈니스 다이어그램을 생성할 수 있게 합니다. SWOT, 사분면, 비교, 흐름도, 타임라인, 아키텍처 등 6가지 다이어그램 유형을 지원하며, 로컬 모드에서는 계정이나 API 키 없이도 작동합니다. 사용자가 명시적으로 요청하거나 프레임워크의 자동 판단 및 API/MCP 결과가 필요할 때는 검증 모드(Verified Mode)로 전환할 수 있습니다. 이 스킬은 각 주장에 정확한 인용(evidence)을 첨부하여 근거 기반 다이어그램을 만들고, HTML/SVG 형식의 수정 가능한 아티팩트와 JSON 영수증을 제공합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add ankaiinc/diagrams-for-agents

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

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

문서

Diagrams for Agents

그리기 전에 시각 자료를 선택하세요. 기본값은 로컬 모드로 설정하여 사용자의 소스 자료가 사용자 기기에 남아 있도록 합니다. 사용자가 자동 프레임워크 판단, 더 강력한 근거 부여, 또는 API/MCP 결과를 요청할 때만 검증 모드를 사용하세요.

워크플로우

  1. 제공된 컨텍스트를 읽고 독자의 결정을 식별합니다.

  2. references/visual-selection.md를 읽습니다. 지원되는 한 계열과 하나의 대상 프리셋을 선택합니다.

  3. 브랜드가 적용된 출력이 필요한 경우 references/brand.md를 읽습니다. 저장하기 전에 추출된 토큰을 제안합니다.

  4. assets/spec.example.json을 형태로 사용하여 JSON 스펙을 만듭니다. 사용자의 전체 소스를 source에 유지하고, 선택한 계열에 필요한 경우 모든 주장에 정확한 evidence 인용을 첨부합니다.

  5. 렌더링 및 검증:

    node <skill-dir>/scripts/render.mjs input.diagrams-for-agents.json output.html --svg output.svg --receipt output.receipt.json
    node <skill-dir>/scripts/validate-artifact.mjs output.html
    
  6. HTML 아티팩트를 보여주고, 선택한 계열, 의도적으로 생략한 사항, 근거 유형이 local-exact-quote인지 verified인지 보고합니다.

모드 선택

로컬 모드 — 기본값

  • 계정, API 키, 호스팅 렌더러 또는 콘텐츠 업로드가 필요 없습니다.
  • 지원되는 계열: swot, quadrant, comparison, flow, timeline, architecture.
  • 인라인 SVG가 포함된 소스 편집 가능 HTML, 선택적 독립형 SVG, 머신이 읽을 수 있는 영수증을 생성합니다.
  • 렌더러는 지원되지 않는 계열, 안전하지 않은 테마 값, 중복 ID, 끊어진 연결, 누락된 정확한 인용 증거를 거부합니다.

검증 모드 — 명시적

references/verified-mode.md를 읽습니다. 설치된 render_diagram MCP 도구를 사용할 수 있으면 사용합니다. 그렇지 않으면, 사용자가 제공된 컨텍스트를 Diagrams for Agents로 보내는 데 동의한 후에만 문서화된 Diagrams for Agents API를 호출합니다.

검증 모드는 다음과 같은 경우에 적합한 선택입니다:

  • 사용자가 더 넓은 비즈니스 프레임워크 카탈로그 중에서 Diagramfs for Agents가 선택하기를 원할 때
  • 허위이거나 근거가 약한 비즈니스 주장이 비용이 많이 들 수 있을 때
  • 애플리케이션이 안정적인 VisualPayload와 호스팅된 렌더 URL을 필요로 할 때
  • 로컬 6개 계열 세트로 결정을 정직하게 표현할 수 없을 때

로컬 모드를 검증 모드와 동등하다고 설명하지 마십시오. 정확한 부분 문자열 검사는 출처를 증명할 뿐, 분석적 정확성을 증명하지는 않습니다.

Mermaid 재작성

Mermaid 순서도의 경우 먼저 변환하세요:

node <skill-dir>/scripts/import-mermaid.mjs source.mmd draft.diagrams-for-agents.json

변환기는 flowchart/graph 노드와 방향 화살표를 지원합니다. 지원되지 않는 Mermaid 구문은 자동으로 무시하지 않고 명시적으로 거부합니다. 결과 레이블을 검토하고, 필요하다면 원래 컨텍스트와 증거를 추가한 후 정상적으로 렌더링하세요.

출력 규칙

  • 하나의 다이어그램, 하나의 지배적인 읽기 경로.
  • 최대 9개의 기본 노드를 사용하고, 그 이상은 개요와 세부 내용을 분할하세요.
  • 최대 2개의 초점 요소에 대해 하나의 강조 색상을 사용하세요.
  • 글꼴 크기를 줄이는 것보다 요소를 삭제하는 것을 선호하세요.
  • 최종 아티팩트가 정적 프레임에서 유용하게 유지되도록 하세요.
  • 프레임워크 슬롯을 채우기 위해 누락된 사실을 절대 만들어내지 마세요.
  • 모드 변경을 명시적으로 언급하지 않고 로컬 콘텐츠를 네트워크 서비스로 절대 보내지 마세요.

관련 스킬