介绍
# Telegram Bot Skill (Advanced)
## 目的 为通过 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 错误，并避免消息突发。
## 安全说明 - 切勿记录令牌。 - 尽可能使用带有密钥令牌标头的 Webhook。