Figma에서 컴포넌트 문서 이관

Figma 문서 레이어의 내용과 이미지를 근거로 SEED Design 컴포넌트 가이드 MDX를 작성하거나 갱신한다.

입력과 범위

• Figma 노드 URL은 필요하다. 제공되지 않았고 다른 도구·문맥에서 확인할 수 없으면 이 값만 사용자에게 요청한다.
• 파일명은 사용자가 준 이름, 대상 MDX 경로, 기존 컴포넌트 ID에서 확정할 수 있으면 추론한다. 여전히 모호할 때만 요청한다.
• 대상 파일은 docs/content/components/{file-name}.mdx다. 기존 파일의 국소 수정이면 대상 섹션과 필요한 Figma 노드만 읽고, 전체 문서를 다시 추출하지 않는다.

1. Figma 내용 추출

제공된 각 노드 URL에 get_node_info를 사용한다. URL을 직접 받는 도구이므로 별도 fileKey·nodeIds가 필요한 get_nodes_info는 사용하지 않는다.

여러 URL이 서로 독립적이고 결과를 합치는 작업이 충분할 때만 병렬로 추출한다. 그렇지 않으면 순서대로 추출해 heading, 본문, 표, Do/Don't, 이미지 위치를 구조화한다.

2. MDX 작성

새 문서·새 섹션에는 references/patterns.md에서 사용할 MDX 컴포넌트 규칙만 읽는다. 기존 문서의 국소 수정에는 해당 컴포넌트와 인접한 기존 패턴만 따른다.