关于 engram-plugin-thin
为 Engram 插件钩子、脚本和适配器提供实现边界与兼容性指引，面向扩展记忆捕获或 Agent 初始化行为的开发者。它要求适配器保持精简，并将复杂逻辑留在 Go 核心中。
主要功能
- 01保持插件适配器精简
- 02复杂逻辑放入 Go 核心
- 03避免脚本增加运行时依赖
- 04复用跨 Agent 共享契约
- 05列出 Pi 保存确认恢复边界
适用场景
- 01修改插件钩子、脚本或适配器
- 02接入被动或主动记忆捕获
- 03配置特定 Agent 的初始化行为
- 04处理 Pi 保存操作的确认歧义
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/engram-plugin-thin确认已加载。
详细介绍
使用场景
在以下情况下使用此技能：
- 编辑插件钩子／脚本／适配器
- 添加被动／主动记忆捕获集成
- 配置特定 Agent 的设置行为
边界规则
- 保持适配器精简：解析输入、调用 API／工具，然后返回。
- 将复杂逻辑放在 Go 核心（
store/server/mcp）中。 - 避免在插件脚本中引入额外的运行时依赖。
- 在所有受支持的 Agent 之间复用同一套契约。
Pi 的有限例外：观察保存确认恢复
plugin/pi 原生 mem_save 可能仅会处理确认结果不明确的情况，因为 Go 服务无法观察到客户端是否丢失了确认。持久化账本、规范指纹、验证、冲突、墓碑、保留策略和变更效果仍完全由 Go 掌控。
- 在初始分发前生成一个操作 UUID，并冻结确切的脱敏载荷及两个目标位置。
- 结果不明确时，仅查询权威接口
GET /observations/save-result。类型化的404错误，且代码为observation_save_result_not_found，允许在可取消的 250 ms 退避后进行一次完全相同的重放。若收到肯定的重放回执，则立即成功；只有结果仍不明确的重放（包括重放返回的409或410）才会触发最后一次 GET。 - 保持现有的总截止时间和调用方取消限制。只有查询结果包含肯定 ID 且
status: "committed"时，才能确认成功；成功的初始 POST 仍兼容旧版的肯定{id}确认方式。 - 初始请求收到的 HTTP 错误仍保持类型化，绝不重放或自行恢复。传播调用方取消；未解决的写入不确定性仍视为未知，绝不视为已保存。
- 此例外不授予其他路由或工具重试权限，不构成通用重试框架，不允许在本地决定业务账本，也不豁免遥测要求。时序遥测不得记录操作 UUID；此例外不授予更广泛的日志记录权限，也不改变现有面向用户的未知结果诊断信息（其中可能会为只读查询暴露该 UUID）。
兼容性检查清单
- Claude Code 流程仍可正常运行
- OpenCode 流程仍可正常运行
- Gemini／Codex 配置路径仍然有效
- 文档反映真实的集成行为
评论
支持 Markdown