用 AI 创建 Telegram 机器人:先写需求,再写验收条件
用个人待办机器人案例,把自然语言想法整理成命令、数据归属、异常处理和验收条件,帮助无需编程的用户创建可检查的 Telegram 机器人。
“帮我做一个待办机器人”可以启动对话,却不足以判断成品是否正确。它没有说明任务属于谁、怎样完成任务、输入错误时如何回应,也没有定义什么叫“完成”。用 AI 开发机器人时,最有用的准备是一份短需求和一组能亲自验证的结果。
下面用个人待办工具示范。命令、文案和测试数据都是本文设计的示例,供你调整需求;它们不是现成模板,也不是对每次生成结果的保证。
把一个想法写成六个可以回答的问题
开始时先回答以下问题,不必使用技术术语:
- 为谁服务? 个人用户、群成员还是管理员?第一版在哪种聊天里工作?
- 怎样触发? 用户输入命令、点击按钮,还是发送普通文字?
- 成功后看到什么? 说明应显示的内容、编号和下一步。
- 保存什么? 哪些记录需要跨消息保留,哪些只是当前输入?
- 谁能查看或修改? 写清数据归属,别只说“每人有一个账号”。
- 失败时怎么办? 空输入、不存在的编号、重复操作和暂时错误都需要可理解的回应。
例如,先把范围限定为“私聊里的个人任务清单”,就能暂缓群组管理、自动提醒、共享任务和外部服务集成。每增加一种触发方式,通常也会增加需要验收的分支。
一份可以直接修改的需求示例
可以把下面内容粘贴到需求对话中,再替换你自己的规则:
请创建一个只在 Telegram 私聊中使用的个人待办机器人。支持
/start、/help、/add 任务内容、/list和/done 任务编号。任务保存后要返回稳定编号和原始内容,列表只显示当前用户未完成的任务。每个用户只能查看和完成自己的任务。空任务、无效编号和不存在的任务都返回简短说明,不改变已有记录。再次完成同一任务时提示它已完成,不新建任务。不识别的命令显示帮助;照片、贴纸等非文本输入给出使用提示,不保存为任务。任务需持久化,后续重新打开聊天仍可查看。第一版不需要定时提醒、共享任务、外部 API 或运行时 AI 问答。生成前请总结需求,并列出需要我确认的问题。
这份示例刻意区分了四件事:用户输入、存储记录、访问边界和返回结果。如果你的需求是读书会投票,也可以保留这个结构,把“任务”替换为书目和投票规则;先确定是否允许改票、何时结束以及谁能查看结果,再选择交互方式。
将需求变成可以观察的验收条件
不要只检查“机器人有回复”。按真实操作顺序记录输入、预期结果和实际结果。这里是一组最小验收条件:
- 用户 A 添加“买猫粮”,获得任务编号;查看列表时能找到这条任务。
- 用户 B 查看列表,看不到 A 的任务;尝试完成 A 的编号也不能改变它。
- A 完成任务后,未完成列表不再显示它;重复操作不会新增记录。
- 发送空的
/add、非数字编号和不存在的编号,不改变任务数量。 - 发送照片、贴纸或未知命令,得到约定的帮助提示。
- 重新打开聊天并再次查看,之前未完成的任务仍存在。
最后一项只能检查你定义的使用场景,不能凭一次测试证明所有故障下都不会丢数据。用少量虚构记录完成验证,保留截图或操作笔记,便于说明后续修改造成的差异。
需求确认、生成检查和真实验收分别解决什么问题
BotFatherV2 的 AI 开发文档说明:需求聊天不会自动生成或部署代码,需要先确认需求卡再生成版本;类型、模块和隔离消息模拟独立于编码 Agent 执行。检查通过以后,仍需在 Telegram 验证真实命令、权限和持久化。以上产品信息核验于 2026 年 10 月 9 日。
因此,需求卡用于检查“是否理解了你的意思”;校验报告用于发现一部分代码问题;真实操作用于确认“用户能否完成任务”。三个结果应分别记录。
在 BotFatherV2 中,你可以通过 AI 对话创建和修改 Telegram 机器人,再按快速开始文档连接和发布。它是与 Telegram 官方 BotFather 不同的独立产品。当前公开内测的 AI 辅助开发也不意味着生成的机器人自动拥有自主 AI Agent 能力;首版不新增依赖付费 AI 的机器人运行能力,固定 SDK 范围不支持任意 npm 模块或 Node/Bun API。
修改时写清要改变的行为
下一轮需求最好是“改变哪一条行为,哪些结果需要继续成立”。例如:“给 /list 增加已完成任务入口,但继续按用户隔离,原来的任务编号不要变化。”随后重跑与列表、编号和隔离相关的验收条件。
每轮集中处理一个明确问题,通常比一次加入提醒、搜索、共享和智能总结更容易检查。保留需求版本和真实测试结果,能让“我觉得它应该这样工作”变成双方都能确认的依据。
来源与核验日期
- BitBear Studio,BotFatherV2 《使用 AI 开发》,中文产品文档,页面未标注发布日期;2026 年 10 月 9 日核验。
- BitBear Studio,BotFatherV2 《创建第一个机器人》,中文产品文档,页面未标注发布日期;2026 年 10 月 9 日核验。