AgentSkillsCN

tg-live-chatter

在 tg_bot 任务执行期间，可随时发布简短的人类化进度更新（无需回复）；始终在同一 Telegram 话题中发布消息（chat_id + message_thread_id）；欢迎使用幽默风趣的表达方式（包括黑色幽默），但须严格限流，避免造成垃圾信息。可通过“用人类的方式写作”、“边做边写”、“实时消息”、“闲聊”、“简短更新”等指令触发。

SKILL.md
--- frontmatter
name: tg-live-chatter
description: Short human progress updates (no reply required) during tg_bot tasks; always post in the same Telegram topic (chat_id + message_thread_id); humor is welcome (incl. dark), strict throttling to avoid spam. Triggered by "пиши по-человечески", "пиши в процессе", "живые сообщения", "chatter", "короткие апдейты".

tg-live-chatter (draft)

Use this skill when the user wants “живое” общение в процессе работы: короткие сообщения о ходе выполнения, без требований ответа.

Scope / куда писать (обязательно)

  • •Всегда пиши в тот же scope, где выполняется задача: (chat_id, message_thread_id) текущего топика.
  • •Никогда не отправляй “в другой топик” или “просто в личку без thread_id” — это ломает UX топиков.
  • •Если пишешь через MCP Telegram: используй mcp__telegram-send__send_message и передавай и chat_id, и message_thread_id.

Когда писать (триггеры)

  • •Есть новое полезное состояние: нашёл причину, подготовил фикс, начал/закончил тесты, упёрся в неожиданный баг/конфликт, готовлю коммит/пуш.
  • •Есть заметный риск/развилка: “нужно выбрать A/B” (но сам вопрос — это уже tg-user-in-the-loop, не chatter).

Что писать (контент)

  • •1–2 предложения: что сделал/нашёл → что делаю дальше.
  • •Одна полезная деталь (без простыней): “падает из-за Y”, “надо переписать X”.
  • •Юмор допустим и приветствуется (см. ниже).

Что НЕ писать

  • •Не спамь “я читаю файл/думаю” каждую минуту.
  • •Не пиши секреты (токены, приватные URL, доступы) и лишние внутренние детали.
  • •Не задавай блокирующие вопросы в формате chatter: если без ответа нельзя — используй tg-user-in-the-loop.

Тон / юмор

  • •Юмор — всегда (можно чёрный/едкий), но без оскорблений пользователя/групп людей и без хейта.
  • •Больше смайликов и сарказма, но не превращай это в спам: 1–2 коротких предложения.
  • •Лучший безопасный юмор: самоирония и шутки про код/инфру (“оно опять упало, но уже по плану”).

Throttling policy

  • •Не чаще 1 сообщения в ~2 минуты.
  • •Без жёсткого лимита “per run”: регулируй частоту здравым смыслом (если параллельно 2+ задач — лучше реже).
  • •Никогда не смешивай chatter с таймингом пингов для blocking‑вопросов (у них отдельный сценарий).

References (repo)

  • •Live chat protocol: notes/technical/2026-01-10-tg-bot-live-chat-protocol.md