Cenozoic-garterstitch153/AI-Agents

AI-Agents は何をしますか？

共有メモリ、MCPツール、スキル、明確なロールベースのワークフローを用いて、ソフトウェア開発のためのAIエージェントチームを構築し、オーケストレーションします。

はじめに

このプロジェクトは、複数のAIエージェントが連携してソフトウェア開発タスクを実行できる、構造化されたマルチエージェントシステムを提供します。エージェントは、ロールベースのアクセス権限、共有メモリ、MCP（Model Context Protocol）ツール、カスタムスキルを使用して、複雑なワークフローを処理します。

主な機能

• ロールベースのエージェントチーム: 各エージェントには「リードアーキテクト」「シニアエンジニア」「QAスペシャリスト」などの特定のロールが割り当てられます。
• 共有メモリシステム: コンテキストの継続性を維持するためのチームメモリ、プロジェクトメモリ、アーキテクチャメモリ。
• MCPツールの統合: エージェントは標準化されたMCPツールを使用して、ファイルシステム、データベース、APIなどと対話できます。
• スキルライブラリ: コードレビュー、テスト、展開などの一般的なタスクのための事前構築済みスキル。
• ワークフローオーケストレーション: エージェント間の調整とタスク委任を自動化する、構造化されたワークフロー。

対応プラットフォーム

• Claude Code (CLI)
• Cline (VS Code 拡張機能)
• Cursor (AI エディタ)
• その他の MCP 互換クライアント

使用方法

インストール

# リポジトリをクローン
git clone https://github.com/Cenozoic-garterstitch153/AI-Agents.git
cd AI-Agents

# 設定
cp .env.example .env
# `.env` ファイルを編集して API キーを設定

エージェントチームの開始

# デフォルトのエージェントチームを開始
./start-team.sh

# 特定のプロジェクトで開始
./start-team.sh --project ./my-project

設定

プロジェクトのルートにある agents.json でエージェントチームを設定します：

{
  "team": {
    "name": "dev-team",
    "memory": {
      "type": "shared",
      "path": "./memory"
    },
    "agents": [
      {
        "name": "architect",
        "role": "lead-architect",
        "model": "claude-3-5-sonnet-latest",
        "tools": ["filesystem", "github", "search"]
      },
      {
        "name": "engineer",
        "role": "senior-engineer",
        "model": "claude-3-5-sonnet-latest",
        "tools": ["filesystem", "github", "terminal"]
      },
      {
        "name": "qa",
        "role": "qa-specialist",
        "model": "claude-3-5-haiku-latest",
        "tools": ["filesystem", "testing"]
      }
    ]
  }
}

ワークフローの実行

# ワークフローの実行
./run-workflow.sh workflow-name

# 利用可能なワークフローの一覧
./list-workflows.sh

メモリシステム

メモリシステムは、複数のセッションにわたってエージェントチームのコンテキストを維持します。

• チームメモリ: チーム構成、ロール、および対話履歴を保存します。
• プロジェクトメモリ: プロジェクトの要件、仕様、および決定事項を保存します。
• アーキテクチャメモリ: アーキテクチャ図、コンポーネント関係、および設計パターンを保存します。

MCP ツール

エージェントは、ファイルシステム、GitHub、データベースなどの外部システムとの対話に MCP ツールを使用できます。ツールは agents.json 設定で定義されます。

スキル

スキルは、エージェントが使用できる再利用可能な機能です。スキルは skills/ ディレクトリに保存され、次のものを含みます：

• code-review.md: コードレビューの実行
• run-tests.md: テストの実行と結果の報告
• generate-docs.md: プロジェクトドキュメントの生成
• deploy.md: 本番環境への展開

貢献

プルリクエストは歓迎します。大きな変更については、まず issue を開いて変更内容を議論してください。

ライセンス

MIT