aiogram-framework について
リポジトリ内でaiogramボットを設計・変更するためのスキルです。aiogram v3のパターンとローカルのドキュメント、サンプルに基づいて開発を進めます。
主な機能
- 01pollingまたはwebhook方式の選択
- 02dispatcher・router・handlerの構成
- 03フィルター・ミドルウェア・依存性注入の設定
- 04複数ステップの処理にFSMを追加
- 05ローカルのドキュメントとサンプルを参照
活用シーン
- 01リポジトリでaiogram v3ボットを構築
- 02handler・フィルター・ミドルウェアを変更
- 03ユーザー状態が必要な複数ステップ処理を実装
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ narumiruna/ telegram-bot --skill aiogram-frameworkインストール後、Claude Code で/aiogram-frameworkを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/fsm.mdhandlers-filters.mdmiddleware-di-errors.mdquickstart.mdupdates.mdutils.md詳細
Aiogram Framework
概要
このスキルは、このリポジトリで aiogram ベースのボットを v3 のパターンとローカルのドキュメント/サンプルを使って設計または変更する際に使用します。
ワークフロー
- 更新の配信方法(ポーリングか Webhook)を選び、スケーリングや複数ボットの必要性を確認します。
references/updates.mdを参照してください。 - ディスパッチャー/ルーターの構成とハンドラーの登録方法を定義します。
references/quickstart.mdとreferences/handlers-filters.mdを参照してください。 - 必要に応じてフィルターとコンテキスト注入(カスタムフィルターを含む)を追加します。
references/handlers-filters.mdとreferences/middleware-di-errors.mdを参照してください。 - 横断的な関心事に対応するミドルウェアとエラー処理を追加します。
references/middleware-di-errors.mdを参照してください。 - 複数のステップがあるフローやユーザーの状態が必要な場合は、FSM を追加します。
references/fsm.mdを参照してください。 - ボイラープレートを減らせる場合は、ユーティリティ(キーボード、書式設定、i18n)を使用します。
references/utils.mdを参照してください。 - 仕上げる前に、
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 対応