galdr は何をしますか？
エージェントスキルの記録＆リプレイ — セッションのツール呼び出しをキャプチャし、再現可能なスキルに凝縮します。ローカルファースト。
概要
Arakiss/galdr は、AIエージェントのセッション中に実行されたツール呼び出しを記録し、後で同じエージェントが再現できるスタンドアロンスキルとしてエクスポートするツールです。
主な機能
- セッションキャプチャ: エージェントが呼び出したすべてのツールを傍受して記録します。
- スキル生成: キャプチャしたツール呼び出しを、エージェントが解釈可能なスキル定義に変換します。
- リプレイ: 生成されたスキルを使用して、エージェントが記録された手順を再実行できるようにします。
使用方法
galdr コマンドは、サブコマンドベースのインターフェースを提供します。
galdr record <session-id> # 新しいセッションの記録を開始
galdr stop <session-id> # 記録を停止し、スキルを生成
galdr replay <skill-file> # 既存のスキルをリプレイ
galdr list # 記録されたセッションを一覧表示
galdr export <session-id> # セッションを外部ファイルにエクスポート
記録モード
記録を開始すると、galdr はエージェントのツール呼び出しを監視します。すべての呼び出しは、タイムスタンプ、ツール名、引数とともにローカルに保存されます。
$ galdr record my-session
Recording session 'my-session'... (Ctrl+C で停止)
スキルの生成
記録を停止すると、galdr はキャプチャしたデータを解析し、次のようなスキル定義を生成します。
name: my-session
steps:
- tool: read_file
args:
path: "/path/to/file.txt"
- tool: edit_file
args:
path: "/path/to/file.txt"
content: "更新されたコンテンツ"
リプレイ
生成されたスキルは、エージェントが入力として受け取り、手順を再現できます。
galdr replay my-session.skill.yaml
インストール
# pip を使用（推奨）
pip install galdr
# ソースから
pip install git+https://github.com/Arakiss/galdr.git
設定
galdr は、以下の環境変数または設定ファイルで設定できます。
| 変数 | デフォルト | 説明 |
|---|---|---|
GALDR_DATA_DIR | ~/.galdr/ | セッションデータを保存するディレクトリ |
GALDR_FORMAT | yaml | エクスポート形式（yaml または json） |
アーキテクチャ
galdr は3つの層で構成されています。
- インターセプター: ツール呼び出しを監視する軽量ミドルウェア。
- ストレージ: セッションデータをローカルに管理するデータベース。
- コンバーター: 生のログを構造化されたスキル定義に変換します。
貢献
バグ報告やプルリクエストは、GitHub リポジトリ へお寄せください。
ライセンス
MIT