engram-plugin-thin について
Engram のプラグインフック、スクリプト、アダプターの実装境界と互換性確認を定める開発スキルです。メモリ記録やエージェント設定を拡張する開発者向けで、複雑な処理を Go コアに置く方針を示します。
主な機能
- 01プラグインアダプターの簡素化
- 02複雑な処理を Go コアに配置
- 03スクリプトの実行時依存追加を回避
- 04エージェント間で共通契約を再利用
- 05Pi の保存確認復旧の境界を規定
活用シーン
- 01プラグインフック、スクリプト、アダプターの編集
- 02受動・能動的なメモリ記録の追加
- 03エージェント固有のセットアップ動作の配線
- 04Pi の保存確認が曖昧な場合の処理
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/engram-plugin-thinを入力して読み込まれたか確認します。
詳細
使用する場面
次のような場合に、このスキルを使用します。
- プラグインのフック／スクリプト／アダプターを編集するとき
- 受動的／能動的なメモリー取得の統合を追加するとき
- エージェント固有のセットアップ動作を組み込むとき
境界ルール
- アダプターは薄く保ちます。入力を解析し、API／ツールを呼び出して、結果を返します。
- 複雑なロジックは Go コア（
store/server/mcp）に配置します。 - プラグインスクリプトに余分なランタイム依存関係を追加しないでください。
- サポート対象のすべてのエージェントで、共通のコントラクトを再利用します。
限定的な Pi の例外：観測保存の確認応答の復旧
plugin/pi のネイティブ mem_save は、Go サーバーからはクライアントが確認応答を受け取れなかったことを検知できないため、確認応答の状態が曖昧な場合に限り、それを解決してよいものとします。
永続台帳、正規フィンガープリント、検証、競合、トゥームストーン、保持、および変更の反映については、引き続き Go のみが唯一の権限を持ちます。
- 初回のディスパッチ前に操作 UUID を 1 つ生成し、サニタイズ済みの正確なペイロードと両方の宛先を固定します。
- 状態が曖昧な場合は、権威ある
GET /observations/save-resultのみを照会します。コードがobservation_save_result_not_foundの型付き404の場合は、キャンセル可能な 250 ms のバックオフ後に、完全に同一のリクエストを 1 回だけ再送信できます。再送信で肯定的な確認応答があれば直ちに成功とし、最終 GET を 1 回行うのは、409または410の再送信を含め、再送信の結果も曖昧な場合に限ります。 - 既存の全体期限と呼び出し元によるキャンセルの制限を維持します。照会で成功が確認されたとみなすのは、正の ID と
status: "committed"がある場合に限ります。初回 POST が成功した場合は、従来どおり正の{id}による確認応答も引き続き受け入れます。 - 初回に受信した HTTP エラーは型付きのまま扱い、再送信も自己修復も行いません。呼び出し元によるキャンセルは伝播させます。解決されていない書き込みの不確実性は不明のまま扱い、保存済みとはみなしません。
- この例外は、他のルートやツールに再試行の権限を与えるものではなく、汎用の再試行フレームワークを認めるものでもありません。ローカルでの業務台帳の判断や、テレメトリーの免除も認めません。タイミングのテレメトリーに操作 UUID を記録してはなりません。また、読み取り専用の照会に使用するために操作 UUID を表示する、既存のユーザー向け「結果不明」診断のログ記録を、より広く許可したり変更したりするものでもありません。
互換性チェックリスト
- Claude Code のフローが引き続き動作する
- OpenCode のフローが引き続き動作する
- Gemini／Codex の設定パスが引き続き有効である
- ドキュメントに実際の統合動作が反映されている
コメント
Markdown 対応