document-import

name	document-import
description	Извлечь текст и изображения из PDF / DOCX / PPTX / напканного скетча. Чтобы скармливать прототипу или деку.
when_to_use	Пользователь приложил PRD в PDF, бриф в DOCX, референс-дек в PPTX, или фото скетча.

Document import

Все документы — это zip-архивы с XML или текстом. Открыть и извлечь можно без специальных SDK.

DOCX

.docx = zip. Текст лежит в word/document.xml. Картинки в word/media/.

unzip -o file.docx -d docx-out
# Текст: docx-out/word/document.xml — выдерни <w:t> элементы
# Картинки: docx-out/word/media/*.{png,jpg}

Извлечь текст:

import fs from 'node:fs/promises';
import { XMLParser } from 'fast-xml-parser';
const xml = await fs.readFile('docx-out/word/document.xml', 'utf8');
const j = new XMLParser({ ignoreAttributes: false }).parse(xml);
function collect(n, out = []) {
  if (!n) return out;
  if (typeof n === 'string') { out.push(n); return out; }
  for (const k of Object.keys(n)) {
    if (k === 'w:t') {
      const v = n[k];
      if (typeof v === 'string') out.push(v);
      else if (Array.isArray(v)) v.forEach(x => out.push(x['#text'] || x));
      else out.push(v['#text'] || '');
    } else if (typeof n[k] === 'object') {
      Array.isArray(n[k]) ? n[k].forEach(c => collect(c, out)) : collect(n[k], out);
    }
  }
  return out;
}
console.log(collect(j).join(' '));

PPTX

.pptx = zip. Каждый слайд — ppt/slides/slide1.xml, slide2.xml, … Текст — в <a:t> тегах. Картинки в ppt/media/.

unzip -o file.pptx -d pptx-out
ls pptx-out/ppt/slides/   # slide1.xml slide2.xml ...
ls pptx-out/ppt/media/    # image1.png image2.jpeg ...

Тот же подход что для docx, только другой XML-namespace.

PDF

Без бинарных тулов сложно. Варианты:

1. pdf-parse (Node, чистый JS) — текст:

   npm i pdf-parse
   

   import fs from 'node:fs/promises';
   import pdf from 'pdf-parse';
   const buf = await fs.readFile('brief.pdf');
   const data = await pdf(buf);
   console.log(data.text);
   

2. pdftotext (poppler-utils, через CLI) — лучше качество:

   pdftotext -layout brief.pdf brief.txt
   

3. pdfimages — извлечь картинки:

   pdfimages -all brief.pdf out/img
   

Скетч / фото доски / .napkin

Если пользователь кинул фото маркерной доски или скетч от руки — это просто картинка. Не пытайся «распознать» руками. Действия:

1. Открой картинку, прочитай глазами (через свой visual capability).
2. Опиши вслух: «вижу 3 экрана, на первом форма входа, на втором лента, на третьем настройки».
3. Спроси у пользователя, всё ли правильно понял.
4. Дальше — обычный flow.

Если файл .napkin — это рисовалка с JSON-данными внутри. Картинка-превью обычно лежит рядом — её и читай.

Что использовать после импорта

• Тексты PRD/брифа → как контент слайдов или основу копирайта прототипа.
• Картинки из PPTX → если это диаграммы / скрины из старого дека, можно повторно использовать как ассеты.
• Картинки из PDF → обычно low-res, годятся как референс, не как финальные ассеты.
• Скетч-фото → референс структуры экранов, не финальная разметка.

Команды-обёртки

templates/extract-doc.sh:

#!/usr/bin/env bash
set -e
file="$1"; out="${2:-extracted}"
mkdir -p "$out"
case "${file##*.}" in
  docx|DOCX) unzip -qo "$file" -d "$out/docx";;
  pptx|PPTX) unzip -qo "$file" -d "$out/pptx";;
  pdf|PDF)
    command -v pdftotext >/dev/null && pdftotext -layout "$file" "$out/text.txt"
    command -v pdfimages >/dev/null && pdfimages -all "$file" "$out/img" || true
    ;;
  *) echo "Не понимаю расширение: $file"; exit 1;;
esac
echo "✓ См. $out/"

Legacy reference

Прежняя расширенная версия скилла (дерево @2026-04-30) сохранена целиком в references/legacy-document-import.md. Секции там: PDF, DOCX, PPTX, Sketch (legacy), Структурирование вывода, Извлечение по типам, Качество текста, Изображения из документов, Антипаттерны.