plugin-development

plugin-development 技能為擴展 Memoria 的治理能力提供了完整的工具集。Memoria 允許使用者為 AI 代理的記憶操作定義自定義邏輯，透過沙盒腳本或遠端服務確保安全、合規性和決策完整性。此技能專為需要為代理互動創建自定義防護機制或在計劃/執行階段定義複雜驗證邏輯的工程師和安全架構師而設計。

• 插件結構構建：使用 CLI 快速生成插件 manifest 檔案與初始策略邏輯。

• 執行環境彈性：支援輕量級、記憶體受限的記憶體內 Rhai 腳本，以及需要外部整合的複雜邏輯之 gRPC 遠端服務。

• 簽署與安全：內建加密簽署工具 (ed25519)，確保治理插件在部署前的完整性與真實性。

• 完整生命週期管理：包含用於跨不同 Memoria 域和綁定進行插件列表、審計、審查和激活的命令。

• 測試工具：透過 GovernancePluginContractHarness 提供合約測試，在投入生產前驗證邏輯。

• 使用 manifest.json 定義權限、資源限制（記憶體/時間）及治理模組元數據。

• 使用內建的 decision() 和 evidence() 輔助函式編寫 policy.rhai 邏輯，從而影響代理的計劃與執行。

• 在生產環境激活前，務必使用 memoria plugin publish 簽署您的插件包。

• 確保插件功能（capabilities）包含商業規則所需的 governance.plan 或 governance.execute 旗標。

• 開發流程建議使用環境變數進行本地測試，隨後透過簽署與發佈命令進行安全部署。

• 請注意 Rhai 執行環境是沙盒化的，而 gRPC 則適用於需要聯網功能的複雜後端邏輯。