principles は何をしますか？
進化的エージェントフレームワーク。失敗を痛みのシグナルとして捉え、再利用可能な原則に蒸留し、学んだ知恵を適用して同じ過ちを繰り返さないようにします — OpenClawプラグインとして構築されています
ソース: https://github.com/csuzngjh/principles
直近24時間以内にプッシュされたGitHubリポジトリから発見されました。エージェントスキル、Claude/Codex/Geminiワークフロー、MCPツール、および関連するAIエージェント自動化を対象としています。
概要
csuzngjh/principles は、AIエージェントの振る舞いを進化させるためのフレームワークです。各失敗を「痛みのシグナル」として記録し、そこから汎用的な「原則」を抽出して、将来の意思決定に役立てます。
仕組み
- 痛みの記録: エージェントが失敗した際、その詳細（コンテキスト、原因、結果）を
pain signalsとして記録します。 - 蒸留: 機械学習やルールベースの分析を用いて、痛みのシグナルから再利用可能な
principlesを生成します。 - 適用: 生成された原則をエージェントの行動ルールセットに組み込み、将来の同様の状況で適切な判断を下せるようにします。
- 進化: 時間とともに原則のネットワークが成長し、エージェントはより賢く、効率的になります。
特徴
- OpenClawプラグイン: 既存のOpenClaw環境にシームレスに統合可能。
- 汎用性: Claude、Codex、Geminiなど、さまざまなAIエージェントで動作。
- 自己改善: 各失敗から学習し、継続的にパフォーマンスを向上。
- 透明性: 生成された原則は人間が読み取り可能で、必要に応じて編集・削除可能。
クイックスタート
- OpenClaw環境にプラグインをインストールします。
- エージェントの設定で
csuzngjh/principlesを有効にします。 - エージェントがタスクを実行するたびに、失敗が自動的に記録され、原則が生成されます。
- 生成された原則は
./principles/ディレクトリに保存され、次回以降の実行で参照されます。
設定
| 環境変数 | 説明 | デフォルト値 |
|---|---|---|
PRINCIPLES_DIR | 原則の保存先ディレクトリ | ./principles/ |
PAIN_THRESHOLD | 痛みのシグナルとして記録する最小失敗重要度 | 0.5 |
MAX_PRINCIPLES | 保持する原則の最大数 | 1000 |
例
痛みのシグナルの例:
{
"timestamp": "2025-03-20T10:30:00Z",
"agent": "codex-v1",
"task": "ファイル書き込み",
"error": "権限不足",
"context": "読み取り専用ディレクトリに書き込みを試行",
"severity": 0.8
}
生成される原則の例:
## 原則: 書き込み前に権限を確認する
- コンテキスト: ファイル書き込みタスク
- 条件: ターゲットディレクトリが読み取り専用の場合
- アクション: 書き込み前に`os.access()`で権限を確認し、必要に応じてsudoまたはディレクトリ変更を提案する
- 有効期限: 無期限
貢献
バグ報告や機能リクエストは、GitHub Issues までお願いします。
ライセンス
MIT