mcpField
A
aiogram-framework

aiogram-framework

github.com/narumiruna开发1395 次安装6 周前更新
代码仓库

关于 aiogram-framework

用于在代码库中设计或修改 aiogram 机器人的 skill，针对 aiogram v3 模式，并结合本地文档与示例指导开发流程。

主要功能

  1. 01规划 polling 或 webhook 更新方式
  2. 02组织 dispatcher、router 与 handler
  3. 03配置过滤器、中间件和依赖注入
  4. 04为多步骤交互添加 FSM
  5. 05参考本地文档与示例

适用场景

  1. 01在代码库中搭建 aiogram v3 机器人
  2. 02修改 handler、过滤器或中间件
  3. 03实现需要用户状态的多步流程

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/narumiruna/telegram-bot --skill aiogram-framework

安装后在 Claude Code 中输入/aiogram-framework确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
fsm.md
handlers-filters.md
middleware-di-errors.md
quickstart.md
updates.md
utils.md

详细介绍

Aiogram 框架

概览

使用此技能，根据 v3 模式和本地文档/示例，在此仓库中设计或修改基于 aiogram 的机器人。

工作流

  1. 选择更新的接收方式（轮询或 webhook），并记录任何扩展或多机器人需求。参见 references/updates.md。
  2. 定义调度器/路由器布局和处理程序注册方式。参见 references/quickstart.md 和 references/handlers-filters.md。
  3. 根据需要添加过滤器和上下文注入（包括自定义过滤器）。参见 references/handlers-filters.md 和 references/middleware-di-errors.md。
  4. 添加中间件和错误处理，以处理横切关注点。参见 references/middleware-di-errors.md。
  5. 如果流程包含多个步骤或需要用户状态，则添加 FSM。参见 references/fsm.md。
  6. 在能够减少样板代码的场景中使用工具（键盘、格式化、i18n）。参见 references/utils.md。
  7. 完成前，对照 examples/ 下的本地示例进行检查。

参考索引

  • 快速入门和项目结构：references/quickstart.md
  • 更新接收方式详情：references/updates.md
  • 路由器/处理程序/过滤器：references/handlers-filters.md
  • 中间件、DI、错误：references/middleware-di-errors.md
  • FSM 和存储：references/fsm.md
  • 工具（键盘/格式化/i18n）：references/utils.md

评论

支持 Markdown