claude-mem 工作原理说明
解释 claude-mem 如何捕获会话观察、注入记忆及数据存储位置。
技能文档清晰披露了数据流向:数据本地存储于~/.claude-mem,除配置的AI提供商(Claude/OpenRouter/Gemini)外不会离开机器,卸载时可清理。SECURITY.md提供了隐私控制(私人标签)、权限说明(本地绑定、端口校验、无提权)和已知的安全审计历史。但作为插件市场第三方技能,发布者身份未经核实,安装过程涉及执行安装脚本和依赖自动下载,缺少用户明确同意步骤;技能本身也未提及权限最小化或回滚机制。综合扣分:数据流透明但确认与恢复机制不完整。
技能文档是说明性的,未包含可执行指令或脚本,故无法验证其行为。但仓库有相对完善的CI流程(包括类型检查、构建、单元测试、e2e测试)和多个测试文件,涵盖集成适配、路径解析等关键路径。不过技能本身没有明确测试覆盖,其依赖的服务端组件并未在所给文件中直接验证。因静态审查,无法复现关键路径,且未见技能级错误处理说明,故扣分。
技能目标用户明确(使用Claude Code等工具的用户),触发场景清晰('how does claude-mem work?'等)。提供了中文模式(code--zh)和国内网络可达性考虑,但核心功能依赖外部AI服务(Anthropic API等),而国内网络可能无法直接访问,需额外配置代理或替代方案。技能边界未明确说明,如不支持的功能或冲突场景。因此得分中等,扣分因边界与触发条件证据不足及网络可达性风险。
技能文档架构良好:包含说明、触发条件、数据位置,且有分层文档链接。有明确的许可证(Apache-2.0)、版本号(13.13.1)、作者信息和安全政策。但技能本身缺少版本化说明、更新日志和已知限制的披露(文档未提及局限)。发布者身份未验证,维护责任虽名义上清晰,但社区维护的持续性未知。综合扣分因版本与变更管理不完整。
技能目的明确,解释工作原理可帮助用户理解,但作为技能,它不直接执行复杂任务,价值在于信息提供。文档提供了清晰的架构描述和操作说明,但未提供验证效果的测试或用户反馈证据。静态审查无法确认实际完成任务的效率。扣分因缺乏直接可验证的产出或比较效益证据。
仓库包含大量测试文件和CI配置,提供了自动化验证的证据。但技能本身没有针对其内容的独立测试,文档中的声明未通过实际运行验证。作为静态审查,无法复现或独立验证。存在多个证据类型(文档、测试、CI),但覆盖不完整。扣分因覆盖度有限及未执行验证。
- 核心功能依赖外部AI服务(如Anthropic API),中国大陆网络环境需配置代理或替代方案才能正常使用。
- 安装会执行脚本并自动下载依赖(Bun、Chroma等),请确保网络与安全策略允许。
- 虽然文档宣称数据本地存储,但压缩和摘要会发送至第三方AI提供商,处理敏感代码或数据前请谨慎。
- 发布者身份未经验证,存在供应链风险,安装前请审查代码。
- 技能说明性较强,但缺少针对该技能自身的测试和已知限制披露,使用前建议查阅完整文档。
这个 Skill 能做什么，适合哪些场景？
这个技能用于向用户解释 claude-mem 的工作机制。它详细说明了每次读取、编辑和 Bash 操作如何被压缩为观察记录，会话结束时如何生成摘要，以及相关记忆如何自动注入到未来的提示中。它还介绍了记忆注入的时间（项目第二个会话开始）以及所有数据存储在本地 ~/.claude-mem 目录。该技能帮助用户理解系统的数据流和隐私边界。
读取用户的提问（如“claude-mem 如何工作？”），并基于 SKILL.md 中的内容生成解释。它不会执行任何实际的内存捕获或注入操作，仅提供说明性回答。
- 开发者首次使用 claude-mem，想了解其工作原理时。
- 用户想知道记忆注入何时触发（第二个会话）以及如何手动预加载代码库。
- 用户关心数据存储位置和隐私，需要确认数据是否仅保存在本地。
- 用户遇到记忆不起作用的问题，想理解系统行为以排查。
这个 Skill 有哪些优点和局限？
- 清晰解释系统核心机制，帮助用户快速上手。
- 包含具体细节（如数据路径 ~/.claude-mem），增加透明度。
- 作为插件的一部分，安装简单。
- 仅提供说明，不包含实际操作或调试功能。
- 依赖 README 中的共享信息，但未提供独立版本信息。
- 未提及测试或维护状态，可能缺乏长期支持保证。
如何安装这个 Skill？
此技能作为 claude-mem 插件的一部分安装。通过 npx claude-mem install 或 /plugin marketplace add thedotmack/claude-mem 及 /plugin install claude-mem 安装后，技能会自动可用。
如何使用这个 Skill？
在 Claude Code 会话中，直接询问“claude-mem 是如何工作的？”或“它在做什么？”，技能将提供说明。无需额外步骤。