Оптимізація токенів у Claude Code через кастомний SQLite-скілл для збереження фідбеку
Інженер Джек Франклін розробив кастомний скілл на SQLite та Deno CLI для Claude Code, щоб керувати фідбеком. Заміна гігантського Markdown-файлу на 7000 рядків базою даних радикально зменшила перевитрату токенів контексту.
Вплив: Середній
Чому це важливо
Ви можете значно скоротити витрати токенів у роботі з агентами, перейшовши від текстових логів до локальних структурованих запитів у БД за допомогою простого CLI.
TL;DR
- 01Великі текстові логи у форматі Markdown швидко з'їдають ліміти контекстного вікна.
- 02Реляційні бази (SQLite) дозволяють агентам запитувати лише необхідне, зменшуючи витрати токенів.
- 03Впровадження правила «спершу список, потім деталі» є критично важливим для оптимізації витрат на роботу агентів.
Ключові факти
- Початковий розмір Markdown
- 7,000 рядків
- Технологія бази даних
- SQLite + Deno CLI
- Місце збереження
- Локальний файл (доданий в .gitignore)
Проблема: роздування контексту в Markdown
Управління фідбеком та багами в текстових файлах рано чи пізно впирається в обмеження масштабування. Коли Markdown-файл розрісся до 3000 рядків активних завдань і 4000 рядків виконаних, Claude Code змушений перечитувати тисячі рядків для кожної простої операції. Це призводить до колосальної перевитрати токенів і сповільнює роботу агента.
Рішення: обгортка на SQLite + Deno CLI
Скілл на базі SQLite замінює читання сирого тексту структурованими SQL-запитами. CLI на Deno дозволяє Claude логувати, шукати та редагувати записи через термінальні команди. Схема БД відстежує поля title, detail, priority, status, category, project та булевий прапорець done. Виконані завдання ховаються з дефолтного виводу для економії токенів.
Ключові паттерни економії токенів
1. Спершу список, потім деталі: Скілл зобов'язує Claude запитувати полегшені списки (лише назви та ID), уникаючи завантаження повного тексту описів завдань. 2. Контекстне визначення проекту: Claude автоматично визначає поточний проект із робочого простору, зменшуючи потребу у додаткових запитаннях до користувача. 3. Попередження дублів: Перед записом нового багу Claude виконує пошук, щоб виявити дублікати, які можуть бути описані іншими словами.
Спробуй за 2 хвилини
# Example CLI command Claude uses to add structured feedback
./feedback-cli add --project "ontrack" --title "Train delay bar bug" --detail "Journey bar clobbers schedule state when delayed" --priority "high" --category "UI"bash
✓ Коли використовувати
- Використовуйте під час розробки чи налагодження проектів за допомогою Claude Code, коли потрібно вести беклог, списки завдань чи логів без роздування контексту.
✕ Коли НЕ варто
- Не потрібно для коротких сесій, де витрати ліміту контексту мінімальні і немає потреби у збереженні історії завдань.
Що зробити сьогодні
- Проведіть аудит робочих логів вашого агента та перенесіть великі текстові файли історії до локальних баз SQLite.
- Оберніть роботу з базою даних у зрозумілий CLI та навчіть Claude Code користуватися ним як кастомним скіллом.
Джерела