Communityコーディング&開発github.com

onewaymyway/mini_agent

Python で実装された Claude Code の簡易版。複数の LLM プロバイダ、スキル機構、同時サブエージェントオーケストレーション、完全なツール呼び出しシステムをサポートします。

mini_agent とは?

mini_agent は、Claude Code のような高度な AI エージェントを Python で簡易的に再現したスキルです。複数の LLM プロバイダ(OpenAI、Anthropic など)をサポートし、ユーザー定義のスキルを動的に読み込む機構、サブエージェントを並行実行するオーケストレーション、そしてファイル操作やコマンド実行などの完全なツール呼び出しシステムを備えています。このスキルは、ターミナルベースの AI アシスタントや自律的なコード生成ワークフローを構築する開発者に最適です。Claude Code、Cursor、Codex などのプラットフォーム上で動作し、ユーザーは設定ファイルで LLM プロバイダを切り替えたり、カスタムスキルを追加してエージェントの動作を拡張できます。内部では、各スキルとツールが非同期で実行され、効率的な並列処理を実現しています。

対応✓Claude Code~Codex CLI~Cursor
npx skills add onewaymyway/mini_agent

Installed? Explore more コーディング&開発 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

mini_agent は何をしますか?

Python で実装された Claude Code の簡易版。複数の LLM プロバイダ、スキル機構、同時サブエージェントオーケストレーション、完全なツール呼び出しシステムをサポートします。

特徴

  • マルチ LLM プロバイダ: OpenAI、Anthropic、その他 OpenAI 互換 API を設定可能
  • スキル機構: ユーザー定義スキルを動的に読み込み、エージェントの能力を拡張
  • サブエージェントオーケストレーション: 複数のサブエージェントを同時実行し、大規模タスクを効率的に処理
  • ツール呼び出しシステム: ファイル読み書き、コマンド実行、Web 検索などの完全なツールセット
  • インタラクティブモード: ターミナル上で対話的にエージェントとやり取り可能
  • 設定ファイル: 簡単な YAML 設定でプロバイダや動作をカスタマイズ

セットアップ

git clone https://github.com/onewaymyway/mini_agent.git
cd mini_agent
pip install -r requirements.txt
cp config.yaml.example config.yaml

config.yaml を編集し、使用する LLM プロバイダと API キーを設定してください。

使用方法

インタラクティブモード

python main.py

単一クエリモード

python main.py --query "タスクを説明してください"

スキルの指定

python main.py --skill skill_name

設定

config.yaml の例:

llm:
  provider: openai
  model: gpt-4
  api_key: YOUR_API_KEY

skills:
  - code_review
  - web_search

tools:
  enabled:
    - read_file
    - write_file
    - run_command

スキルの作成

ユーザー定義スキルは skills/ ディレクトリに配置します。各スキルは execute(context) 関数をエクスポートする Python ファイルです。

# skills/example_skill.py
def execute(context):
    return {"result": "スキルが実行されました"}

ツール

  • read_file: ファイルの内容を読み取る
  • write_file: ファイルに書き込む
  • run_command: シェルコマンドを実行する
  • web_search: Web 検索を実行する
  • list_directory: ディレクトリの内容を一覧表示する

貢献

プルリクエストを歓迎します。大きな変更を加える場合は、最初に issue を開いて議論してください。

ライセンス

MIT

関連スキル