structurize

star 0

어떤 대상이든(글, 영상 스크립트, 인터뷰, 회의록, 논쟁, 강의, 보고서, 시스템 설명) 구조적으로 분해하고 계층화한 뒤 적합한 형식으로 렌더링하는 스킬. "구조화해줘", "XX를 구조화", "구조 잡아줘", "구조적으로 정리", "분해해서 정리", "계층적으로 만들어줘", "트리로 정리/써줘" 같은 요청에 트리거해라. 명시적으로 "구조화"라고 안 해도, 사례·주장·증상이 나열된 텍스트를 주며 "정리해줘", "본질 뽑아줘"라고 하면 트리거해라. 출력 형식(ASCII 트리/HTML/Mermaid/표/문서)은 구조와 매체에 따라 마지막에 선택한다. 단순 요약 요청에는 트리거하지 마라 — 이건 요약이 아니라 무손실 재구성이다.

2lab-ai By 2lab-ai schedule Updated 6/10/2026

name: structurize description: 어떤 대상이든(글, 영상 스크립트, 인터뷰, 회의록, 논쟁, 강의, 보고서, 시스템 설명) 구조적으로 분해하고 계층화한 뒤 적합한 형식으로 렌더링하는 스킬. "구조화해줘", "XX를 구조화", "구조 잡아줘", "구조적으로 정리", "분해해서 정리", "계층적으로 만들어줘", "트리로 정리/써줘" 같은 요청에 트리거해라. 명시적으로 "구조화"라고 안 해도, 사례·주장·증상이 나열된 텍스트를 주며 "정리해줘", "본질 뽑아줘"라고 하면 트리거해라. 출력 형식(ASCII 트리/HTML/Mermaid/표/문서)은 구조와 매체에 따라 마지막에 선택한다. 단순 요약 요청에는 트리거하지 마라 — 이건 요약이 아니라 무손실 재구성이다.

Structurize — 무손실 구조화

아키텍처: 구조화 엔진과 렌더러는 분리된 층이다. 실제 작업은 분해(decompose) → 관계(relate) → 계층화(hierarchize)이고, 트리는 그 결과를 표시하는 형식 중 하나일 뿐이다. 엔진의 산출물은 형식 독립적인 중첩 구조이며, 렌더링은 마지막 단계에서 구조와 매체에 맞춰 고른다. 렌더러를 먼저 정하고 구조를 거기 맞추는 역방향은 금지다.

핵심 제약: 요약은 버려서 줄이고, 이건 배치해서 줄인다. 원문의 구체 사례·숫자·인용은 버리지 않고 주소를 준다. 자리 없는 디테일은 구조가 틀렸다는 신호다.

이론 기반(한 줄씩): 분해·핵/위성·관계는 RST(Mann & Thompson, 1988 — EDU 분해, 삭제 테스트, 수사 관계 트리), 계층 조립은 Minto 피라미드(수직/수평 논리, MECE, 결론 우선), 논증 골격은 Toulmin(claim–grounds–warrant, warrant는 대개 암묵적). 표시층은 signaling principle(구조를 신호하면 기억·이해 향상, 인지부하 감소 — 메타분석 g+≈0.5)과 chunking에 근거한다. 완성된 계층을 제공하는 것이 독자가 스스로 구조를 만드는 것보다 학습 성과가 높다 — 이 스킬의 존재 이유.


엔진 — 7단계

0. 진단: 무엇을 구조화하는가

대상의 지배 구조를 먼저 판정하라. 구조가 방법을 결정하지, 템플릿이 결정하지 않는다.

대상 유형 지배 논리 골격
설명/해설 인과 원인 → 결과 가지 → 개입 → 경계
논증/주장 추론 claim → grounds → (암묵 warrant 명시화) → rebuttal → qualifier
비교/선택 기준 판단 기준이 줄기 → 선택지별 가지 → 갈리는 조건
과정/절차 시간·의존 단계 사슬 → 단계별 전제와 실패 모드
분류/체계 포함 상위 분류 → 하위 항목 (MECE 지향)

혼합형이면 지배적인 쪽이 줄기, 나머지는 서브트리. 단일 뿌리가 없는 대상에 단일 뿌리를 만들어내지 마라 — 긴장(A↔B)이 구조면 긴장 자체를 뿌리로, 진짜 병렬이면 다핵 병렬로 둬라.

1. 분해: 최소 의미 단위(EDU)로

원문을 하나의 명제/기능을 담는 절 단위 조각으로 쪼개라. 원문의 순서는 보존 대상이 아니다. 단위가 보존 대상이다. 말한 순서와 논리 구조는 별개다 — 특히 구어 스크립트·회의록에서.

2. 핵-위성 판정: 삭제 테스트

각 단위에 물어라: "이걸 지우면 전체가 무너지는가?" 무너지면 핵(중심 노드 후보), 안 무너지면 위성(보조 — 버리는 게 아니라 핵 아래에 매단다). 어느 쪽을 지워도 동급으로 무너지면 다핵 병렬이다.

3. 관계 부여

단위 쌍에 관계를 라벨링하라. 기본 어휘: 상술 / 근거 / 원인 / 결과 / 대조 / 조건 / 양보 / 수단 / 배경 / 재진술 / 평가. 어떤 관계로도 안 붙는 단위는 둘 중 하나다 — 진짜 노이즈이거나, 누락된 중간 노드의 신호.

4. 계층 조립 — Minto 규칙

  • 수직: 상위 노드는 하위 노드들의 요약이어야 한다. 요약이 안 되면 묶음이 틀렸다.
  • 수평: 형제 노드는 같은 종류여야 한다(모두 이유, 모두 단계, 모두 기준 — 섞지 마라). 겹침 없이(ME), 빠짐 없이(CE). 텍스트 구조화에서 CE는 "원문에 있는 것 전부"로 해석한다.
  • 크기: 형제 3개 안팎이 적정, 7개를 넘으면 중간층을 도입하라.
  • 정렬: 0단계 진단을 따른다 — 인과 / 시간 / 부분구조 / 중요도.
  • 묶음 기준: 표면의 겉모습이 아니라 기저의 작동 원리로 묶어라. 가지 수가 급격히 안 줄면 아직 표면으로 분류하는 중이다.

5. 암묵 구조 승격

가장 가치 있는 노드는 원문 표면에 없는 것들이다. 단위들 사이에 깔린 구조를 명시 노드로 끌어올려라. Toulmin의 warrant(근거→주장을 잇는 생략된 가정)가 원형 — 논증 텍스트는 warrant가 거의 항상 생략돼 있고, 그걸 명시화하는 게 분석의 본질이다. 자주 나오는 유형(닫힌 목록 아님):

  • ◆ 긴장/비대칭 — 모순처럼 보이지만 실은 핵심인 관계
  • ◆ 경계 조건 — 한쪽만 보면 틀리는 양면, 주장의 적용 한계
  • ※ 오해 차단 — 원문이 암묵적으로 교정하고 있는 통념
  • ✗ / ○ 실패-정답 대비 — 흔한 실패 경로와 정답 경로의 대조

승격 ≠ 창작. 원문에 근거 없는 노드는 빼라.

6. 무손실 검증

원문을 처음부터 재스캔하라. 모든 단위가 구조 안에 주소를 가졌는가? 미배치 단위가 있으면 (a) 진짜 노이즈라 버려도 되거나 (b) 구조가 누락된 것이다. 노이즈가 아닌데 자리가 없으면 구조를 고쳐라 — 0 또는 3단계로 돌아가라. 디테일을 버려서 구조를 지키지 마라.


렌더러 — 형식은 구조가 고른다

엔진 산출물(중첩 구조 + 관계 + 노드 유형)을 받아 형식을 선택한다:

구조 특성 매체 형식
무순환 계층 채팅·터미널 ASCII 트리 (기본, 아래 정의)
무순환 계층 문서·블로그·공유 HTML 접이식 트리 (references/renderers.md)
순서·분기·루프 존재 모두 Mermaid flowchart — 트리는 순환을 표현 못 한다
교차 참조·피드백 다수 모두 Mermaid graph(관계망) — 트리 강제는 왜곡
기준 × 선택지 비교 모두 — 정밀 비교는 표가 우월
글 자체를 재작성 문서 계층 제목 문서 — 신호 원리 적용

구조적 정직: 트리는 단일 뿌리·무순환 계층만 표현한다. 교차 관계나 루프가 본질이면 그래프/플로차트임을 인정하고 그렇게 그려라. 트리에 욱여넣지 마라.

신호 원리(모든 렌더러 공통):

  • 결론 한 줄을 최상단에 (지배 구조를 한 문장으로).
  • 노드 제목은 라벨이 아니라 내용 요약형으로 ("원인" ✗ → "전두엽 억제 기능 저하" ○).
  • 범례를 끝에 한 줄 (기호 의미 + 읽는 법).
  • 기호(◆ ※ ✗ ○)는 보조 — 남용하면 신호가 죽는다.

ASCII 트리 (기본 렌더러)

│ ├ └ 들여쓰기. 골격은 0단계 진단 결과를 따른다 — 고정 템플릿 없음. 유형별 골격 예:

설명형                              논증형
주제                                중심 주장
├─ [0] 뿌리 ─ 단일 원인             ├─ [1] 근거 ─ 축별 묶음 + 원문 증거
├─ [1] 가지 ─ 기능별 분기            │   └─ (암묵 warrant 명시 노드)
│   └─ ◆ 비대칭 / ※ 오해 차단       ├─ [2] 반론 ─ 가장 강한 버전으로 복원
├─ [2] 개입 ─ 메커니즘 + 반증        │   └─ 재반박 + ✗/○ 갈리는 지점
└─ [3] 경계 ─ 양쪽 절벽 + 판단 규칙  └─ [3] 적용 범위 ─ ◆ qualifier·경계

HTML 접이식 트리 · Mermaid · 표 렌더러의 상세 템플릿: references/renderers.md를 읽어라.


실패 모드 체크리스트

하나라도 걸리면 고쳐라.

  • 렌더러 역방향: 형식을 먼저 정하고 구조를 거기 맞췄나? 엔진이 먼저다.
  • 그래프를 트리에 욱여넣음: 교차 관계·루프가 본질인데 계층 트리로 그렸나?
  • 템플릿 강요: 특정 골격을 대상 유형과 무관하게 씌웠나? 0단계부터 다시.
  • 단일 뿌리 날조: 긴장·비교·병렬 구조에 억지 단일 원인을 세웠나?
  • 요약으로 흘렀나: 원문 디테일을 버렸으면 실패다. 무손실이 규칙이다.
  • 표면 묶음: 겉모습으로 묶어 가지 수가 안 줄었나? 기저 원리로 다시.
  • 수직 논리 붕괴: 상위 노드가 하위의 요약이 아닌가?
  • 수평 논리 붕괴: 형제에 이유·단계·예시가 섞여 있나?
  • 노드 창작: 원문에 근거 없는 노드를 지어냈나? 승격이 아니라 창작이다.
  • 기호 남용: ◆※가 절반 이상 노드에 붙어 있으면 신호가 죽은 것이다.
Install via CLI
npx skills add https://github.com/2lab-ai/soma-work --skill structurize
Repository Details
star Stars 0
call_split Forks 2
navigation Branch main
article Path SKILL.md
More from Creator