tetra-scar は何をしますか？
AIエージェント用のスカーメモリと反射弓。失敗から恒久的に学習します。繰り返しのミスを即座にブロック — LLM呼び出しは不要。
概要
tetra-scarは、AIエージェントが過去の失敗を記憶し、同じ失敗を繰り返さないようにするためのスキルです。エージェントが遭遇したエラーや問題を「スカー（傷跡）」として記録し、同じ状況が発生したときに自動的に反射（reflex）を発動して防止します。
特徴
- 永続的記憶: 失敗をファイルベースで保存し、セッションを超えて保持
- 即時反射: 同じパターンの問題が発生した場合、LLM呼び出しなしで即座に防止ルールを適用
- 軽量設計: 最小限のリソースで動作し、既存のワークフローに簡単に統合可能
- マルチプラットフォーム: Claude Code、Cursor、Codex、Cline、XTWTなどに対応
インストール
# スキルをクローン
$ git clone https://github.com/aibenyclaude-coder/tetra-scar.git
# セットアップ
$ cd tetra-scar
$ pip install -r requirements.txt
使用方法
スカーの記録
エージェントが失敗した際に、以下のコマンドでスカーを記録します。
$ scar record --error "ビルドエラー: モジュールXが見つかりません" --context "YAML設定ファイルの解析中"
反射の確認
現在の反射ルールを一覧表示します。
$ reflex list
反射の手動トリガー
必要に応じて反射を手動でトリガーできます。
$ reflex trigger --pattern "モジュールXが見つかりません"
設定
環境変数または設定ファイルで動作をカスタマイズできます。
| 変数名 | 説明 | デフォルト値 |
|---|---|---|
TETRA_SCAR_DIR | スカーデータの保存ディレクトリ | ~/.tetra-scar/ |
TETRA_REFLEX_ENABLED | 反射機能の有効/無効 | true |
TETRA_MAX_SCARS | 保存する最大スカー数 | 1000 |
統合
Claude Code
claude_desktop_config.json に以下を追加：
{
"skills": ["aibenyclaude-coder/tetra-scar"]
}
Cursor
.cursorrules ファイルにスキル設定を追加。
ライセンス
MIT