ttguy0707/CyberClaw

何を解決するか

CyberClaw は、エージェントワークフローをより観測可能で、安全かつ拡張可能にするために設計された汎用 AI エージェントフレームワークです。動的スキルに対して厳格な「help → run」プロトコルを導入することで、コマンド実行前に最新の指示にアクセスしていることを保証し、信頼性の低いツール実行の問題に対処します。

仕組み

LangGraph を基盤として構築されており、状態グラフ（START → agent → tools → agent）を実装しています。セッションの永続化には AsyncSqliteSaver を使用し、長期記憶には Markdown 形式のユーザープロファイルを採用しています。コンテキスト管理のため、40 ラウンドを超えるメッセージはトリミングされ、最新の 10 ラウンドを保持し、残りは LLM を使って要約されます。

主な技術的メカニズムは以下の通りです：

• 二段階スキル実行：スキルは直接呼び出されません。エージェントはまず help を要求して一時的な help_token を取得する必要があります。このトークンは run 段階で提供され、セッション、スキルID、コンテンツハッシュに対して検証された後に実行されます。
• サブエージェントの委任：メインエージェントは専門的なサブエージェント（例：code_reviewer や document_analyst）にタスクを委任できるほか、必要に応じて一時的な役割を即座に定義できます。これらのサブエージェントは制限されたツールアクセスを持つ隔離されたコンテキストで動作します。
• スケジュールされたタスク：ハートビートコルーチンが 10 秒ごとに tasks.json ファイルをチェックし、時刻に応じたアクションをトリガーします。
• 観測性：バウンデッドな非同期キューが、5 種類のイベント（LLM 入力、ツール呼び出し、結果、AI メッセージ、システムアクション）を JSONL ファイルにログ記録し、専用のモニタ CLI で確認可能です。

対象ユーザー

• 動的ツールやスキルを管理する構造的な方法が必要な自律エージェントを開発する開発者
• 長期記憶を持ち、専門的なサブエージェントに複雑なタスクを委任できる CLI ベースの AI アシスタントを望むユーザー
• ツール呼び出しにプロトコルベースのアプローチを強制することで信頼性を高めたい人

特徴

• プロトコルの強制：help 呼び出しによる有効で時間制限付きのトークンを要求することで、任意のツール実行を防止します。
• 階層的エージェンシー：事前に定義されたサブエージェントと動的に定義されたサブエージェントの両方をサポートし、コンテキストを隔離します。
• コンテキスト管理：自動的な LLM による要約とラウンドベースのトリミングにより、長時間の会話に対応します。
• 組み込みツールセット：ファイルシステム操作、シェル実行（許可リスト付き）、スケジューリング、プロファイル管理のための 13 個のコアツールを含みます。
• 構造化監査：JSONL ログを通じて、エージェントの意思決定とツールとの相互作用をリアルタイムでモニタリングできます。