skrepka 📎

ИИ-соавтор в Google Документах. Агент работает из вашего терминала прямо в документе: читает комментарии, отвечает на них и правит текст на месте.

In English · Приватность · Безопасность

Зачем

Работа над текстом с ИИ обычно идёт в двух окнах: документ и чат с агентом. Скопировать абзац в чат, вставить ответ обратно, руками починить оформление. Пока текст ходит туда-сюда, теряются правки и комментарии.

skrepka убирает это копирование. Вы оставляете по тексту обычные комментарии: про структуру, логику, формулировки. Потом зовёте агента в документ, он читает треды, отвечает и правит текст на месте. Заказчик приходит, комментирует там же, работа продолжается тем же способом. Комментарии при этом не рвутся: даже когда прокомментированный абзац переписан целиком, тред остаётся и переезжает на новый текст. Где сделать это безопасно нельзя, skrepka отказывает по одной операции, называет причину и правит остальной документ — что именно она не делает. Закрывает треды только человек.

Для кого

Редакторам, копирайтерам и контент-менеджерам, которые ведут и согласовывают тексты в Google Docs, а к работе подключают ИИ-агента: Claude Code, Codex или другого. Быть разработчиком не нужно, доступ к Google настраивает мастер skrepka init.

Что умеет

Главный сценарий — разобрать комментарии. Вы говорите агенту «отработай комментарии», он читает треды, отвечает по делу и вносит правки в текст.

Кроме этого skrepka дописывает блок с оформлением в конец документа (append), выгружает документ в markdown и заливает правки обратно, создаёт документы из markdown и разбирает предложенные правки. Полный список сценариев — в docs/PLUGIN.md.

Как это выглядит

Работу ведёт агент, но команды видны, и вот весь цикл:

skrepka comments DOC --output comments.json     # прочитать треды
skrepka patch DOC ops.json --dry-run            # примерить правки
skrepka patch DOC ops.json                      # применить
skrepka reply DOC --file replies.json           # ответить в треды

Третья строка — единственная, которая меняет документ. Вторая говорит по каждой правке, что с ней будет, и не пишет ничего: примерить дёшево, поэтому пробовать можно без риска. Треды при этом остаются живыми, а закрывает их человек.

Как начать

Нужен macOS или Linux: защиты файлового ввода-вывода опираются на механизмы Unix, Windows не поддержан.

1. Поставьте skrepka: pipx install skrepka.
2. Настройте доступ к Google: skrepka init. Первая настройка занимает 15–30 минут, инструкция со снимками экрана — в docs/QUICKSTART.md.
3. Подключите навыки к агенту: docs/PLUGIN.md.

Дальше попросите агента отработать комментарии в тестовом документе.

Вы заводите собственный проект Google Cloud и работаете от своего имени. У skrepka нет сервера и телеметрии: автор skrepka ваших документов и токенов не видит. Подробности в PRIVACY.md.

Документация

Лицензия

MIT