🦞Клешня для разрабов

Пробовали OpenClaw (она же Клешня)?
Я нет. Хз зачем. Для кодинга говорят избыточно.
И контроля мало над ним. Черт в коробке.

Но есть аналог, который реально заточен под разработку.
Хайпа на него почему-то не было. Но инструмент достойный.

Долго не доходили руки, но вот сегодня наконец-то поставил.

Takopi:

- https://takopi.dev/
- https://github.com/banteg/takopi

По сути тот же туннель Телега — модель на компе/сервере.
Но сделано для разработчиков, не для барберов.
И это другое дело.

Плюсы:

1. Кодим прямо из Телеги: пришла идея — закинули в чат — работа пошла
2. Больше контроля: топик=проект, работа с Гитом из коробки
3. Заточен под разработку: понимает с полуслова, выполняет нужные команды
4. Любые модели можно подключить. Я для пробы повесил бесплатную https://opencode.ai/ru
5. При желании и прямых руках можно превратить в аналог OpenClaw
6. Из коробки: скиллы, правила, MCP и все вайбкодерские штуки

Я до этого не знал про https://opencode.ai
Тоже открытием оказалось.
Безлимитная бесплатная модель заточенная под разработку.
Она говорят поглупее, но с простыми скриптами справляется. Проверил.

Долго разбирался с установкой, были нюансы. Или я тупил — не ясно.
Но в итоге развернул документацию Takopi с помощью Takopi (привет Xzibit) отдельным проектом. Теперь могу уточнять дальнейшие детали в режиме чата.

Пошаговая инструкция: Takopi + топики + чат-помощник по Takopi (выжимка из доки, ссылка в начале поста)
🔽

Шаг 1: Python и uv

curl -LsSf https://astral.sh/uv/install.sh | sh
uv python install 3.14

Шаг 2: Установка Takopi

uv tool install -U takopi

Шаг 3: Создание бота

1. @BotFather → /newbot
2. Имя (например, "takopi")
3. Username (должен на bot заканчиваться, например my_takopi_bot)
4. Забрать токен

Шаг 4: Онбординг

takopi --onboard

Вводишь токен, выбираешь workspace, создаёшь группу с топиками, добавляешь бота админом с правами "Manage Topics", выбираешь движок.

Шаг 5: Клонирование репы Takopi (чтоб сразу был чат с документацией)

cd ~
git clone https://github.com/banteg/takopi

Шаг 6: Регистрация проекта

cd ~/takopi
takopi init takopi-helper

Шаг 7: Привязка топика Создаёшь топик, пишешь:

/topic takopi-helper

Всё. У вас есть топик takopi-helper, который можете мучать расспросами о том, что делать дальше.

Я впечатлен. Технолоджия. 😐
Считай, личный агент-кодер в Телеге теперь есть.

Кстати, инструкция выше написана чатом с докой Takopi. Я проверил — всё верно. Можно использовать не только для разработки, но и для чего угодно.

Возможно, установка немного замороченнее, чем у OpenClaw. Но легкий путей не ищем.

🔤🔤 ОФЛАЙН-ИИ НА СТАРОМ SAMSUNG

Попробовал апку Google AI Edge Gallery на Samsung Galaxy, 2022 года — на железе, которое делали еще до нынешнего бума моделей.

С помощью этого приложения можно запускать ИИ модели на телефоне.

Тестил Gemma 4 E2B: новая легкая модель опен сурс модель от Google. На мой телефон зашла нормально.
По описанию модель поддерживает skills, но это я пока не пробовал.

Что проверил по факту:

1. Попросил написать простой код — ответ валидный.
2. Скинул фото с турецким текстом и попросил перевод — перевела.

И вот это реально вау: всё офлайн. Без сети. На телефоне 2022 года.

Как поставить:

1. Ставьте из Google Play: https://play.google.com/store/apps/details?id=com.google.ai.edge.gallery
2. Обязательно проверьте, что это официальное приложение — я сначала по ошибке поставил клон.
3. Оф-приложение у меня на скрине.

Пока не придумал утилитарные сценарии использования.
Можно наверное апки пилить, которые будут использовать локальную модель.

☯️Пишите идеи в комменты, заколлабимся.)

🇷🇴Как получить API_ID и API_HASH для ТГ приложения на российский номер.

Проблема специфическая, но решил зафиксировать решение.
Вдруг кому то пригодиться.

TG API_ID и API_HASH обычно нужны, что бы с АПИ телеги взаимодействовать.
Например, чтоб удобно парсить/снайпить ТГ каналы.

Но оказалось, что есть проблема с их получением. Чтоб их получить надо:

1) зайти на my.telegram.org

2) Авторизовать по номеру

3) Создать приложение

Чтоб зайти на my.telegram.org нужно сменить IP, потому что с российского не зайти.

Но когда создаешь приложение - срабатывает телеграмовский антифрод (походу):
он видит что номер российский, а ипшник не российский и выдает ошибку.

См. скрин.

Вот такой вот замкнутый круг.

Причем по ошибке еще фиг поймешь, что ему надо. Про гипотезу с IP узнал из статьи с Хабра.

Как решается:
в файл hosts добавляете запись 149.154.167.220 my.telegram.org.

И всё. На my.telegram.org можно зайти без смены IP. И он спокойно позволит создать приложение.

Подписаться

⏰ Завтра пост на эту тему.

😢 Хватит ТАК разрабатывать с ИИ.

Я всё чаще замечаю, что меня как будто кто‑то подменил что некоторые разработчики до сих пор используют ИИ в разработке неправильно.

Просто открыли IDEшку и начинают наяривать в чат агенту.

Довольно часто при таком подходе переписка с агентом из попытки написать рабочий код скатывается в эмоциональное описание того, что ИИ ещё весьма глуп и написал какую‑то х@йню.

Я тоже когда‑то был таким.

Но в итоге мой путь привёл к здравой мысли, что для эффективной разработки с ИИ нужно сперва выстроить систему работы вокруг него.
И тогда даже слабые модели будут давать качественный, легко читаемый и легко поддерживаемый код.

Ещё и документацию с тестами напишут.

Да, на настройку нужно потратить некоторое время и внимание.
Первый раз будет долгим. Жаль, что в жизни не так.😕
Но это окупится сторицей.

Небольшая метафора:

Агент — это таксист.
Но он без навигатора. Максимум — у него есть какие‑то старые карты.
Ты к нему сел, дал адрес дома и сказал: «Поехали».

Если ты ему не объяснил как проехать, не показал дорогу, то тебя ждёт увлекательное путешествие по всем подворотням города.
Иногда даже по рекам и каналам.

Возможно, тебе повезёт, и ты просто сделаешь небольшой крюк перед тем, как попадёшь домой.

Но, скорее всего, оказавшись на грунтовке в лесу, ты будешь умолять его вернуться на трассу.

"Да ты прав, прости, что огорчил тебя. Сейчас откачусь назад и поедем правильно."

Тебя даже могут в итоге пересадить на общественный транспорт.
А если совсем не повезёт, то окажешься в другом городе.

Ещё и заплатишь за это временем и деньгами.

Собственно, ниже кратко и тезисно расскажу свой текущий флоу разработки с ИИ, который помогает избежать подобных проблем.

Вы сможете адаптировать его под себя. Все ссылки будут указаны.

Дисклеймер:
Подробно раскрывать как работает каждый пункт - не буду.
Можете догуглить или спросить в комментах.
Либо можете скормить пост своему агенту и попросить его всё сделать.

1) Пишем AGENTS.md.

Это файл, который агент читает перед тем, как сделать вообще хоть что‑то.
В нём пишем общие рамки проекта:
- как работать с кодом, какой стек и пр.;
- где какие файлы лежат и как организовывать код;
- различные ограничения, наподобие «не пушь без моего согласия», «не правь файлы окружения».

У меня, например, также прописаны там принципы Карпатого:
1. Сначала подумай, потом пиши код.
2. Пиши просто, не плоди лишнюю архитектуру.
3. Меняй только то, что касается задачи.
4. В конце сделай проверки.

Ссылки:
- AGENTS.md в Codex docs: https://developers.openai.com/codex/guides/agents-md
- Codex customization: https://developers.openai.com/codex/concepts/customization
- Karpathy‑inspired skill: https://github.com/forrestchang/andrej-karpathy-skills

2) Дай агенту Context7.

Context7 — это MCP, то есть способ дать агенту внешний инструмент для получения актуальной документации.
Не надеяться на память модели, а попросить её сходить в свежую доку по конкретной библиотеке.

Это особенно важно для активно развивающихся фреймворков и API.

Чтобы агент точно использовал MCP, можно просто задать правило в AGENTS.md:

Если задача зависит от версии библиотеки, API или фреймворка,
сначала проверь актуальную документацию через Context7 MCP или official docs.
Не пиши код по памяти, если API мог измениться.

Для большей надежности можно использовать скил: https://github.com/affaan-m/ECC/blob/main/skills/documentation-lookup/SKILL.md.
Он прям описывает: сначала resolve‑library‑id, потом query‑docs, потом ответ на основе найденной документации.

Ссылки:
- Context7: https://github.com/upstash/context7
- Context7 docs: https://context7.com/docs
- Documentation‑lookup skill: https://github.com/affaan-m/ECC/blob/main/skills/documentation-lookup/SKILL.md

3) Покажи агенту свой флоу.🎤

Надо объяснить, как действовать при разработке.
По какой схеме или методологии.
Чтобы агент при выполнении каждой задачи следовал единому флоу.

Я использую 2 варианта (или их вариации):

Первый: Ponytail. Это агент‑обвязка, которая минимизирует мусорный код.

Агент сначала проверяет, можно ли вообще не писать новый код.
Может, это кто то уже написал.
Может, уже есть нативный способ решения в фреймворке.
Может, достаточно одной строки.

Т.е. заточено под максимально простые решения.

Ссылка: https://github.com/DietrichGebert/ponytail

Второй: Superpowers. Для более тяжелых проектов.

Тут уже полноценная дисциплина разработки:
- агент сначала вытаскивает из тебя требовани
- потом прорабатывает архитектуру
- строит пошаговый план выполнения
- реализует по плану используя TDD
- в конце ревью петли

Ссылка: https://github.com/obra/superpowers

4) //Документируй и комментируй код.

Документация позволяет и человеку, и ИИ разобраться в проекте и понять, «что у вас здесь происходит»🤨.
Её лучше писать сразу вместе с изменениями кода.

В AGENTS.md можно добавить простое правило (взято из доки кодекса):

Если изменение меняет публичное поведение, команды, конфиг, API или пользовательский флоу, проверь README/docs/changelog и обнови минимально нужную часть. Не переписывай всю документацию без причины.

А сверху можно добавлять заточенные под это скилы.

Вот ссылки на примеры таких скилов:
- Documentation and ADRs https://github.com/addyosmani/agent-skills/blob/main/skills/documentation-and-adrs/SKILL.md
- Shipping and Launch https://github.com/addyosmani/agent-skills/blob/main/skills/shipping-and-launch/SKILL.md
- Changelog Generator https://github.com/ComposioHQ/awesome-codex-skills/blob/master/changelog-generator/SKILL.md
- README Polish https://github.com/proflead/codex-skills-library/blob/master/skills/docs/readme-polish/SKILL.md
- Function Docstrings https://github.com/proflead/codex-skills-library/blob/master/skills/docs/function-docstrings/SKILL.md

5) Собирай команду скилов под проект.

У вас есть стек. Есть требования.
Установите под каждую деталь свой скил.

Условный пример:
- для Django — отдельные скилы по migrations, permissions, ORM patterns;
- для React — component patterns, state, performance;
- для review — описать типовые дефекты именно вашего проекта.

Банки скиллов, где можно поискать полезное:
- OpenAI skills: https://github.com/openai/skills
- Awesome Codex Skills: https://github.com/composiohq/awesome-codex-skills
- Matt Pocock skills: https://github.com/mattpocock/skills
- ECC: https://github.com/affaan-m/ECC
- Addy Osmani agent‑skills: https://github.com/addyosmani/agent-skills
- Browserbase skills: https://github.com/browserbase/skills
- Proflead Codex Skills Library: https://github.com/proflead/codex-skills-library
- Oh My Codex: https://github.com/Yeachan-Heo/oh-my-codex
- Agency Agents: https://github.com/joyfrai/agency-agents

Также никто не мешает писать свои. Переводить свой опыт в скилы.

Итог:

AI‑разработка — это не запустил агента и забыл. Это настройка рабочего контура:
- AGENTS.md
- актуальная документация через MCP
- качественный флоу разработки
- проектные скилы
- генерация документации

Каждый пункт можно и нужно адаптировать под себя.

Выделите вечерок. Налейте чайку. Соберите себе систему.
Сделав один раз, вы можете её переиспользовать дальше.

Не будьте вайбкодерами. Становитесь инженерами.🤝

Подписаться