SuperAPI AI 工具集

goodvibes-memory

通用与其它

查看项目

更新于 10-16 00:29

技能介绍

用途:为智能体提供跨会话的持久记忆,让它在开始任何任务前先读取历史记录,完成后写回新经验,从而避免重复已知失败、复用已验证模式、遵守既有架构决策与项目偏好。

主要能力:在项目根目录的 .goodvibes/ 下维护两类文件。memory/ 存放机器可读的 JSON:decisions.json(架构决策)、patterns.json(已验证做法)、failures.json(历史错误与解决)、preferences.json(项目约定),index.json 可选。logs/ 存放人类可读的 Markdown:activity.md(已完成工作)、decisions.md(决策及背景)、errors.md(错误及解决)。

使用方式:读取阶段用 precision_read 依次查看 failures.json、patterns.json、decisions.json、preferences.json,按关键词(如 auth、config、build)和 scope 匹配相关条目,命中后应用其中的 prevention 或 pattern。写入阶段在任务通过评审后记入 activity.md,必要时追加 patterns.json 或 decisions.json;错误解决后记入 errors.md 与 failures.json;做出决策后记入 decisions.md 与 decisions.json。ID 采用时间戳格式,如 dec_YYYYMMDD_HHMMSS、pat_、fail_、pref_。首次写入前先检查文件是否存在,JSON 不存在则以 [] 创建,Markdown 不存在则先写标题。可用脚本校验:bash plugins/goodvibes/skills/protocol/goodvibes-memory/scripts/validate-memory-usage.sh session-transcript.jsonl .goodvibes/memory/,退出码 0 表示合规,1 表示存在违规。

适用场景:需要跨会话保持一致性的编码与智能体工作流,尤其是涉及架构决策、反复出现的构建或依赖错误、可复用实现模式的长期项目。

限制:资料未提供该技能的安装方式、收费、支持平台与性能数据。协议要求同时写入 JSON 与 Markdown,且不应为琐碎改动记录;时间戳 ID 在极端并发下存在极小碰撞风险。