Telegram 机器人技能（进阶）

目的

提供一个简洁、面向生产的指南，用于通过 Bot API 构建 Telegram 机器人工作流，重点关注命令用户体验、更新处理以及使用纯 HTTPS 的安全操作。

最佳适用场景

• 您想要一个以命令为先、行为专业的机器人。
• 您需要一个可靠的更新流程（Webhook 或轮询）。
• 您更倾向于直接进行 HTTP 调用，而非使用库。

不适用场景

• 您需要一个完整的 SDK 或框架集成。
• 您需要在进程内进行复杂的媒体上传和流式传输。

快速入门

• 请阅读references/telegram-bot-api.md以了解端点、更新类型和请求模式。
• 请阅读references/telegram-commands-playbook.md以了解命令用户体验和消息风格。
• 请阅读references/telegram-update-routing.md以了解更新规范化和路由规则。
• 请阅读references/telegram-request-templates.md以获取 HTTP 负载模板。
• 保持此SKILL.md简洁，并使用引用获取详细信息。

所需输入

• Bot令牌和基础API URL。
• 更新策略：Webhook或长轮询。
• 命令列表和对话语气。
• 允许的更新类型和速率限制策略。

预期输出

• 清晰的命令设计、更新流程计划和操作检查清单。

操作说明

• 首选严格的命令路由：/start、/help、/settings、/status。
• 始终验证传入的更新载荷和聊天上下文。
• 使用退避策略处理429错误，并避免消息突发。

安全须知

• 切勿记录令牌。
• 尽可能使用带有密钥令牌头的Webhooks。