@modootoday/datalab-extension-mcp 1.7.0 → 1.8.0

package/skills/datalab-tutorial-post/SKILL.md

@@ -0,0 +1,61 @@
+---
+name: datalab-tutorial-post
+description: 초보자도 이해하기 쉬운 튜토리얼형 블로그 글 한 편을 문제-해법-실습 구조로 쓴다. "쉽게 설명하는 글", "입문자용 가이드", "비유로 설명해줘" 요청이나 어려운 개념을 친근한 톤으로 풀어야 하는 초안에 사용한다.
+license: Proprietary
+metadata:
+  tools: outline_suggest, write_draft, kin_question_demand, web_read, editor_insert_draft, editor_place_draft, editor_open_window
+---
+
+# 튜토리얼형 블로그 글쓰기
+
+개념 하나를 초보자가 따라올 수 있게 설명하는 블로그 글 **한 편**을 쓴다.
+
+## 언제 쓰나
+
+- "쉽게 설명하는 글 써줘", "입문자도 이해할 수 있게", "비유를 들어서 설명해줘"
+- 개념 하나를 다루는 블로그 글 1편. 여러 챕터로 나뉜 코스나 강의 자료 요청이면 아래
+  "여러 편으로 나눠야 할 때"를 먼저 본다.
+
+## 글자수 — 12,000자가 상한이다
+
+초안 한 번의 결과는 최대 약 12,000자다. 모델 응답 길이 상한이라 **재시도해도 늘어나지
+않는다.** 이 스킬은 그 안에서 문제→해법→실습을 완결시킨다. 단계별 배분은
+`references/structure-and-length.md`.
+
+짧게 나왔다고 "더 길게" 다시 쓰지 않는다. 12,000자에 못 미치면 그 자체로 완결된
+글이다 — 억지로 예시를 추가해 채우지 않는다. 길이가 모자라 보인다고 다시 쓰면 매번
+과금되고 결과는 늘지 않는다.
+
+## 절차
+
+1. **주제와 독자를 확인한다.** 무엇을 설명할지, 읽는 사람이 이 개념을 왜 어려워하는지
+   한 줄로 파악한다. 모르면 묻는다 — 지어내지 않는다.
+2. **아이스브레이커로 연다.** 톤과 여는 방식은 `references/tone-and-hooks.md`.
+3. **문제→해법→실습 구조로 쓴다.** 배분은 `references/structure-and-length.md`.
+4. **비유나 사례를 하나 쓴다.** 템플릿은 `references/analogy-and-case-templates.md`.
+   사례는 지어내지 않는다 — 확인 가능한 사실이거나 일반화된 상황("한 마케터가…")만 쓴다.
+5. **막히는 대목이 있으면** `kin_question_demand` 로 사람들이 실제로 뭘 묻는지,
+   `web_read` 로 사실을 확인한다. 짐작으로 채우지 않는다.
+6. **발행.** 열린 에디터가 있으면 `outline_suggest` 로 구조를 잡고 `write_draft` 로 초안을
+   쓴 뒤 `editor_insert_draft` 또는 `editor_place_draft` 로 넣는다. 열린 에디터가 없으면
+   초안 텍스트를 그대로 돌려준다 — 그게 실패가 아니라 기본 경로다.
+
+## 여러 편으로 나눠야 할 때
+
+주제가 원래 크면(예: "입문부터 실무까지 전부") 한 편에 욱여넣지 않는다. "1편: 개념과
+기본기, 2편: 실전 적용" 식으로 시리즈를 제안한다. 각 편은 이 절차를 그대로 다시 따르는
+독립된 글이다.
+
+## 하지 않는 것
+
+요청받아도 아래는 만들지 않는다. 왜 안 되는지 설명하고 대안을 제시한다.
+
+| 하지 않는 것                                   | 왜                                                                            |
+| ---------------------------------------------- | ----------------------------------------------------------------------------- |
+| 최소 글자수를 채우기 위한 재작성               | 12,000자 상한과 충돌하고, 다시 쓸 때마다 과금된다                             |
+| 여러 챕터로 이어지는 코스 구성                 | 회차를 넘나드는 진행 상태를 이 표면이 추적하지 않는다. 시리즈로 나눠 제안한다 |
+| 외부 문서도구 전용 서식(토글·콜아웃·DB 임포트) | 이 패널은 네이버 에디터에 쓴다                                                |
+| 배지·경험치·진행률 바·수료증                   | 추적할 상태가 없고, 완료자 수 같은 없는 숫자를 지어내게 된다                  |
+| 인물에게 귀속된 명언                           | 실제로 그 사람이 한 말인지 확인할 방법이 없다                                 |
+| 자가평가 점수("15-20점: 마스터 레벨")          | 셀 수 없는 걸 숫자로 포장하는 패턴                                            |
+| 다이어그램 문법                                | 네이버 에디터가 렌더링하는지 실측되지 않았다 — 텍스트 설명으로 대체한다       |

package/skills/datalab-tutorial-post/references/analogy-and-case-templates.md

@@ -0,0 +1,37 @@
+# 비유와 사례 템플릿
+
+세 가지 중 주제에 맞는 하나를 쓴다. 어느 쪽이든 지어낸 숫자나 인물은 넣지 않는다.
+
+## 1. 역할 비유
+
+구조: 설명하려는 개념(A) — 독자가 이미 아는 시스템(B) — 그 시스템 안에서 A가 하는 역할(C).
+
+예: "블로그 카테고리는 도서관의 분류 코드와 같다. 사서가 분류 코드를 보고 책이 있는
+서가로 바로 가듯, 카테고리는 검색엔진이 이 글의 주제를 바로 알아보게 해준다."
+
+## 2. 여정 비유
+
+구조: 출발점 — 도착점 — 이동 수단(설명하려는 개념) — 걸림돌 — 경유지.
+
+익숙한 이동 경로에 빗대어 학습 과정을 단계별로 표현한다. 걸림돌 자리에는 실제로 사람들이
+자주 걸리는 지점을 넣는다 — 지어내지 않고 알고 있는 실제 사례를 쓴다.
+
+## 3. 전환 비유
+
+구조: 이전 상태(문제) — 계기(설명하려는 개념) — 과정 — 이후 상태(해결).
+
+전후가 뚜렷한 개념에 쓴다. 계기가 무엇을 어떻게 바꾸는지 과정을 보여준다.
+
+## 사례 하나 쓰는 법
+
+실명·회사명은 확인된 것만 쓴다. 확인할 수 없으면 "한 마케터가", "어떤 소규모 쇼핑몰이"
+처럼 일반화한다.
+
+구성: 배경 → 부딪힌 문제 → 이 글에서 설명한 개념을 어떻게 적용했나 → 결과.
+
+결과를 쓸 때 수치를 모르면 "무엇이 달라졌는지"로 서술한다. 퍼센트를 지어내지 않는다.
+
+## 하지 않는 것
+
+- 결과를 퍼센트·금액·순위로 지어내지 않는다. 측정하지 않은 배수도 쓰지 않는다.
+- 매번 새 비유를 강제로 넣지 않는다. 한 편에 하나면 충분하다.

package/skills/datalab-tutorial-post/references/structure-and-length.md

@@ -0,0 +1,22 @@
+# 구조와 글자수
+
+## 한 편 = 문제 → 해법 → 실습
+
+이 구조를 **한 편**, 12,000자 이내에 완결시킨다. 챕터로 나눠 반복하지 않는다.
+
+| 단계    | 글자수 목표   | 내용                                                              |
+| ------- | ------------- | ----------------------------------------------------------------- |
+| 여는 훅 | 200~400자     | 아이스브레이커 하나                                               |
+| 문제    | 1,000~1,800자 | 독자가 실제로 겪는 어려움. 겉으로 보이는 문제 → 진짜 이유 순서    |
+| 해법    | 5,000~7,000자 | 핵심 개념 설명 + 비유 하나 + 사례나 일반화된 상황 하나            |
+| 실습    | 1,500~2,500자 | 바로 해볼 수 있는 작은 과제 하나. 난이도를 나누고 싶으면 둘까지만 |
+| 마무리  | 300~500자     | 오늘 다룬 것 한 줄 요약 + 다음에 궁금할 만한 것 한 가지           |
+
+합이 12,000자를 넘으면 해법 단계부터 줄인다 — 비유나 사례 중 하나만 남긴다.
+
+## 하지 않는 것
+
+- 부족하다고 예시를 늘려 다시 쓰지 않는다. 12,000자는 모델 응답 길이 상한이라 재시도해도
+  늘지 않는다.
+- "N자마다 쉬어가기" 같은 중간 휴지 장치를 넣지 않는다 — 한 편이 그 정도로
+  길지 않다.

package/skills/datalab-tutorial-post/references/tone-and-hooks.md

@@ -0,0 +1,26 @@
+# 톤과 여는 방식
+
+"따뜻한 선배" 톤 — 진입장벽을 낮추고, 작은 진전도 인정하고, 알면서 잘난 척하지 않는다.
+존댓말 해요체를 쓰되 딱딱하지 않게.
+
+## 여는 방식 세 가지
+
+매번 다르게 쓴다 — 매 글 같은 훅을 쓰면 정형화된 티가 난다.
+
+1. **공감형 고백** — 글쓴이도 처음엔 헷갈렸다는 걸 인정하며 연다.
+2. **공유 경험** — 독자가 실제로 겪었을 법한 장면을 구체적으로 그려서 공감을 끌어낸다.
+3. **의외의 사실** — "생각보다 어렵지 않다, 사실 매일 쓰고 있다"는 식으로 통념을 살짝
+   뒤집는다.
+
+## 무겁다 싶으면 톤을 낮춘다
+
+개념이 여러 단계로 이어지거나 새 용어가 한 번에 여러 개 나오면, 문장을 짧게 끊고 "지금
+어렵게 느껴지는 게 정상"이라고 짚어준 뒤 한 단계씩 간다. 가벼운 개념에는 굳이 이 문장을
+넣지 않는다 — 매 문단마다 격려하면 오히려 과장으로 읽힌다.
+
+## 하지 않는 것
+
+- **인물에게 귀속된 명언을 인용하지 않는다.** 실제로 그 사람이 한 말인지 확인할 방법이
+  없다.
+- **완료자 수·만족도 같은 사회적 증거를 지어내지 않는다.** 집계한 적이 없으면 쓰지 않는다.
+- **이모지를 소제목 대신 쓰지 않는다.** 소제목은 글자로 구분한다.

package/skills/datalab-video-script/SKILL.md

@@ -0,0 +1,84 @@
+---
+name: datalab-video-script
+description: 주제나 대본 아이디어를 장면별 스크립트로 기획해 열려 있는 영상 편집기 타임라인에 실제로 만들어 넣는다. 숏폼·릴스 스크립트, 장면 구성, 자막과 AI 내레이션 제작에 사용한다. 타임라인이 열려 있어야 하고 AI 이미지·목소리는 유료다.
+license: Proprietary
+metadata:
+  tools: video_timeline_get, video_sources_list, video_canvas_resize, video_scene_add, video_subtitle_set, video_scene_update, video_scene_reorder, video_text_add, video_background_set, photo_gallery_list, video_image_add_from_gallery, video_scene_image_set, generate_images, video_narration_generate, my_content_read, my_content_info
+---
+
+# 영상 스크립트 기획과 제작
+
+주제나 대본 아이디어를 장면별 스크립트로 기획하고, 열려 있는 영상 편집기 타임라인에 장면마다
+실제로 만들어 넣는다. 산출물은 다른 곳에 붙여넣을 텍스트가 아니라 완성된 타임라인이다.
+
+## 시작하기 전에 — 타임라인이 열려 있어야 한다
+
+`video_timeline_get` 으로 먼저 확인한다.
+
+- 열려 있으면 그 타임라인에 만든다. 기존 장면이 있으면 이어서 쓸지 새로 시작할지 묻는다.
+- 열려 있지 않으면 만들 수 없다. 영상 편집기를 먼저 열어 달라고 안내하고 멈춘다.
+  **타임라인을 대신 열어주는 도구는 없다.**
+
+## 무엇을 읽고 시작하나
+
+1. 사용자가 주제나 대본을 직접 줬으면 그것이 기준이다.
+2. "이 글을 영상으로" 처럼 이미 발행한 글을 가리키면 `my_content_read` 로 본문을 읽는다.
+   제목만 알고 있으면 `my_content_info` 로 먼저 찾는다.
+3. 둘 다 없으면 무슨 주제인지 묻고 멈춘다. **지어내지 않는다.**
+
+## 기획은 짧게 확인만 한다
+
+- **형식** — 세로 숏폼(9:16) 또는 가로(16:9)가 기본. 다르면 물어본다.
+- **장면 수** — 안 정했으면 대본 분량 기준으로 5~8장을 제안하고 확인만 받는다.
+- **어투** — 차분한 설명형이 기본값이다.
+
+장면 역할과 자막 길이는 `references/scene-structure.md`.
+
+## 만들기
+
+첫 장면 전에 `video_canvas_resize` 로 화면 비율을 맞춘다. 이미 장면이 여러 개 있는
+타임라인에서는 함부로 다시 부르지 않는다 — 모든 장면에 한꺼번에 적용돼 기존 배치가 틀어진다.
+
+장면마다:
+
+1. `video_scene_add` 로 장면을 추가하며 그 장면의 자막(내레이션 원고)을 함께 넣는다.
+   목소리로 읽힐 문장이니 귀로 읽히게 쓴다 — 기준은 `references/writing-for-the-ear.md`.
+2. `video_background_set` 으로 색 배경을 정하거나(기본값, 무료), 이미지가 필요하면
+   `video_sources_list` 로 이 영상에 이미 있는 이미지를 먼저 확인해 `video_scene_image_set`
+   으로 재사용한다. 확장 갤러리 사진은 `photo_gallery_list` 로 찾아
+   `video_image_add_from_gallery` 로 가져온다.
+3. 화면에 그려지는 강조 문구(제목·CTA)가 필요하면 `video_text_add`. 자막과는 별개다.
+4. 전환과 움직임은 `video_scene_update`.
+
+순서를 바꾸려면 `video_scene_reorder`. 자막을 고치려면 `video_subtitle_set` — 이미 목소리를
+만든 장면이면 자막을 고친 뒤 목소리를 다시 만들어야 한다.
+
+**장면이나 요소를 지우는 도구는 이 스킬에 없다.** 지워야 하면 사용자가 편집기에서 직접
+하도록 안내한다.
+
+## 이미지와 목소리 생성은 유료다
+
+- `generate_images` 는 과금된다. 장면마다 하나씩이면 N장이 N번이다. 기본은 색 배경 + 자막
+  시안을 제안하고, AI 이미지를 원하면 **몇 장을 생성할지 먼저 확인한다.**
+- `video_narration_generate` 도 과금된다. 새로 만들어야 하는 장면 수를 `video_timeline_get`
+  의 내레이션 상태로 미리 세어 **부르기 전에 몇 장인지 확인받는다.** 대상을 생략하면 전부
+  한 번에 청구된다.
+- 실제 단가는 알 수 없다 — 매수만 확인하고, 승인 없이 장면 수만큼 자동으로 돌리지 않는다.
+
+## 없는 것 (찾지 마라)
+
+- 영상 편집기를 대신 열어주는 도구는 없다.
+- **실제 카메라로 찍는 영상은 다루지 않는다.** 이 표면은 이미지·자막·AI 목소리로 이루어진
+  슬라이드형 편집기다. 샷 리스트, 카메라 앵글, 조명 장비, 촬영 장소 추천은 대응 도구가 없다.
+- **외부 영상 생성기를 부르는 도구는 없다.** 그런 생성기용 전용 문법의 프롬프트도 만들지
+  않는다 — 이 표면이 실행하는 도구가 아니다.
+- 목소리는 이 패널에 설정된 AI 음성 하나뿐이다. 특정 성우·음색을 지정하는 문법은 없다.
+- 조회수·완시청률·참여율·구독자 증가·클릭률을 예측하거나 등급을 매기지 않는다.
+- 업로드·썸네일 등록 도구는 없다. 제목·설명 문구는 복사용으로 제안할 수 있지만 등록은
+  사용자 몫이다.
+
+## 산출물
+
+- 완성된 타임라인 — 열려 있던 편집기에 장면이 채워진 상태.
+- 복사용 스크립트 요약 — 장면별 자막, 타임라인에 넣은 내용 그대로.
+- 원하면 제목·설명 문구 제안. 예상 수치는 붙이지 않는다.

package/skills/datalab-video-script/references/scene-structure.md

@@ -0,0 +1,41 @@
+# 장면 구조
+
+## 역할
+
+- **HOOK** — 첫 장면. 3초 안에 시선을 끄는 한 줄.
+- **BODY** — 정보 전달. 한 장면에 한 메시지.
+- **CTA** — 마지막 장면. 행동 유도 문구.
+
+장면이 3개뿐이면 HOOK + BODY + CTA로 충분하다. 5~8장이면 HOOK 1 + BODY 3~6 + CTA 1이 흔한
+배분이다. 장면 수가 늘어난다고 억지로 세 역할을 다 채우지 않는다.
+
+## 자막 — 넣기 전에 정할 것
+
+검증해 주는 도구는 없으니 상한을 넘겨도 오류는 나지 않는다. 한 장면 안에서 한 호흡에
+읽히게 스스로 지키는 기준으로 쓴다.
+
+| 구간 | 용도         | 대략 상한 | 비고                     |
+| ---- | ------------ | --------- | ------------------------ |
+| HOOK | 첫 문장      | 20자      | 짧고 강하게              |
+| BODY | 설명 한 단락 | 40자      | 장면당 메시지 하나       |
+| CTA  | 행동 유도    | 20자      | 계정·다음 영상 언급 가능 |
+
+장면 길이는 자막 길이로 자동 추정된다. 문장이 길면 장면을 나눈다.
+
+## 전환과 움직임
+
+- 전환은 영상 전체에서 한두 가지로 통일한다. fade 가 무난한 기본값이다.
+- 움직임은 장면마다 달라도 되지만 같은 방향을 연달아 쓰지 않는다 — pan-left 다음 pan-left 는
+  지루하고, zoom-in 다음 zoom-out 은 어지럽다.
+- HOOK·CTA 에는 강한 움직임이, BODY 에는 없거나 약한 움직임이 흔한 배분이다.
+
+## 화면 비율
+
+| 용도            | 크기(px)    |
+| --------------- | ----------- |
+| 세로 숏폼(9:16) | 1080 x 1920 |
+| 가로(16:9)      | 1920 x 1080 |
+| 정사각(1:1)     | 1080 x 1080 |
+
+가로·세로 모두 짝수 픽셀이어야 인코더가 받는다. 모르면 세로 숏폼을 기본값으로 쓰고, 바꿔야
+하면 **장면을 만들기 전에** 다시 비율을 맞춘다.

package/skills/datalab-video-script/references/writing-for-the-ear.md

@@ -0,0 +1,22 @@
+# 귀로 듣는 글쓰기
+
+자막은 목소리로 읽힌다. 만들기 전에 점검한다 — 다시 만들면 다시 청구된다.
+
+## 문장
+
+한 문장에 절 하나, 쉼표로 숨 쉴 지점을 표시한다. 괄호 부연("가격(2만원대)")은 문장 안에
+풀어 쓴다. "아래 참고"처럼 화면을 가리키는 말, "장점: 가격, 속도"처럼 명사만 나열한 목록도
+문장으로 다시 쓴다. 말·눈·배처럼 표기는 같고 소리로는 문맥이 전부인 단어는 앞뒤 문장으로
+뜻을 분명히 한다.
+
+## 숫자·단위·영어·약어
+
+"3~5개"는 "3개에서 5개"로 푼다. 단위는 읽는 말로("10km" → "10킬로미터"). 발음이 불확실한
+영어와 고유명사는 한글로 옮기고, 약어는 처음 한 번 풀어 쓴다.
+
+## 확인할 수 없는 것
+
+실제로 어떻게 끊어 읽을지는 듣기 전엔 모른다 — 사전 점검이지 보장이 아니다.
+
+감정이나 쉼을 지시하는 대괄호 태그는 이 표면에 **없다.** 자막에 넣으면 그 문자열이 그대로
+소리 내어 읽힌다.