remember

remember skill 概览

remember 的作用

remember skill 是一个聚焦于 Knowledge Capture 的技能，用来把事实、约定、决策和容易踩坑的经验明确保存到 Claude auto-memory 中，适用于那些重要到不能只依赖自动捕获的信息。它特别适合这类场景：“我们终于定位到了 CI 问题”“这个项目有一条没写进文档的约定”，或者“Claude 不应该忘记这个团队偏好”。

与其让助手“记住这一点”然后寄希望于它真的能保留下来，remember 为 agent 提供了一套可重复执行的流程：解析知识、检查重复项，并写入一条带时间戳、包含上下文的 memory entry。

最适合的用户和团队

如果你在维护长期项目，并且反复出现的上下文会影响工作质量，就适合使用 remember skill：例如工程团队、同时维护多个仓库的独立开发者、AI 辅助调试流程，或者希望随着时间逐步改进的 agent。它尤其适合那些重要知识已经出现在聊天记录里，但还没有进入 CLAUDE.md、文档、测试或代码注释的情况。

这个 skill 不是完整的知识库、笔记应用，也不是文档生成器。它的职责更窄：保存简洁、可执行，并且会影响未来 Claude 会话的记忆。

它和普通提示词有什么不同

像“记住这个”这样的普通提示词含义并不明确。remember skill 增加了操作层面的规范：它会要求明确应该记住什么、为什么重要，以及这条记忆是项目级还是全局级。它还包含重复检查步骤，避免 memory file 里堆满同一事实的多个重复版本。

因此，当遗忘成本很高时，remember 会很有价值：例如反复调试同一个问题、选择了错误工具、忽略编码约定，或者偏好逐渐漂移。

如何使用 remember skill

remember 安装与源码检查

使用你的 skill manager 从仓库安装这个 skill，例如：

npx skills add alirezarezvani/claude-skills --skill remember

然后查看源码位置：

engineering-team/self-improving-agent/skills/remember/SKILL.md

从仓库预览来看，这个 skill 很精简，没有单独的 scripts/、references/、rules/ 或 resources/ 目录，因此 SKILL.md 是主要需要阅读的文件。在把它用于生产级 agent 配置之前，重点查看使用示例、重复检查命令，以及 memory entry 的写入流程。

remember 的基础用法

调用 /si:remember，后面跟上你希望保存的准确知识：

/si:remember "This project's CI requires Node 20 LTS — v22 breaks the build"

好的输入应该具体、稳定、可执行。较弱的输入是：

/si:remember "CI is weird"

更好的输入是：

/si:remember "CI fails on Node 22 because the build image expects Node 20 LTS; use Node 20 for local reproduction and GitHub Actions parity"

更强的版本会告诉未来的 Claude：发生了什么、适用于哪里，以及应该采取什么行动。

提示词里应该包含什么

为了获得更好的效果，建议包含四类信息：

• Fact: Claude 应该保留的事实。
• Context: 适用位置，例如某个 repo、endpoint、test suite、tool 或 team。
• Reason: 为什么忘记它会导致错误输出。
• Scope: 它是项目级信息，还是通用偏好。

示例：

/si:remember "Project-specific: In this repo, API auth uses a custom JWT library instead of passport. Do not recommend passport middleware unless we are replacing the auth layer."

这样能给 skill 足够的信息来生成后续真正有用的 memory，而不是一条模糊备注。

Knowledge Capture 的实用工作流

在完成一次发现、决策或纠正之后，立即使用 remember。最佳时机是信息还很新鲜，并且对话还没有切换到其他主题之前。

一个实用流程：

1. 在调试、评审或规划过程中发现一个长期有效的事实。
2. 把它改写成一句包含上下文和后果的话。
3. 运行 /si:remember "<fact>"。
4. 让 skill 检查是否已有重复 memory。
5. 如果已经存在类似条目，优先更新或澄清，而不是制造噪音。
6. 带着新的 memory 继续工作，并让它在未来会话中可用。

这个工作流能让 memory 保持有用，而不是变成聊天逐字稿。

remember skill 常见问题

什么时候应该使用 remember？

当某条知识很可能影响未来工作，并且无法从代码库或文档中明显看出来时，就适合使用 remember。合适的候选内容包括构建要求、框架限制、架构决策、反复出现的测试问题、未写入文档的约定，以及稳定的用户或团队偏好。

不要用它保存临时任务状态，例如“我现在正在编辑文件 X”，除非这件事在会话结束后仍然重要。

remember 适合新手吗？

适合，因为命令很简单。但新手要注意，不要保存模糊或情绪化的备注。像“the database is annoying” 这样的 memory 没有帮助。像 “Local DB tests require Docker Compose service postgres-test to be running before npm test” 这样的 memory 才有用。

这个 skill 在用户能清楚描述操作层面的经验教训时效果最好。

remember 和 CLAUDE.md 有什么区别？

CLAUDE.md 更适合稳定、共享的项目说明，未来每个 agent 都应该把它作为 repo 的一部分来阅读。remember 更适合增量学习、来之不易的发现，以及那些暂时还不适合正式写入文档的上下文。

一个好的模式是先用 remember 捕获信息，然后把反复出现或团队范围适用的 memory 提升到 CLAUDE.md、README 文件、测试或架构文档中。

什么时候不应该使用 remember？

不要用 remember 保存 secrets、credentials、private tokens 或敏感个人信息。当某条知识应该对整个团队可见时，也不要把它当作受源码控制文档的替代品。此外，除非明确标注为不确定，否则应避免保存猜测、尚未解决的理论或一次性观察。

Memory 应该减少未来错误，而不是保存推测。

如何改进 remember skill 的使用效果

用更清晰的输入提升 remember 效果

影响质量最大的因素是输入句子。在调用 remember 之前，先把粗略发现改写成长期可用的指导。

粗略版本：

/si:remember "Jest hangs sometimes"

更好的版本：

/si:remember "Project-specific: Jest integration tests can hang after DB tests unless run with --forceExit; use this flag when reproducing CI test hangs locally."

这个版本明确了工具、条件、解决办法和适用范围。这样保存下来的 memory 更容易让 Claude 在未来正确使用。

避免重复和过期的 memory

上游工作流包含对项目 memory file 的重复检查。请保留并尊重这个步骤。重复 memory 会产生相互冲突的指导，尤其是在某条约定随着时间变化时。

如果发现旧条目，优先从概念上修订这条 memory：“This replaces the old Node 18 note; the project now standardizes on Node 20 LTS.” 明确说明替代关系，比不断堆积相互矛盾的事实更好。

把反复出现的 memory 转成文档

如果同一条 remembered fact 会影响多个贡献者，就应该把它从 memory 中提升出来。把它加入 CLAUDE.md、README.md、onboarding docs、test setup notes 或 architecture decision records。remember 很适合做捕获，但对于团队共享治理来说，受源码控制的文档更合适。

一个实用判断标准是：如果 Claude 已经需要这条 memory 超过两次，人类大概率也需要它。

常见失败模式

主要失败模式包括保存过多、范围不清，以及在没有证据的情况下保存结论。避免过于宽泛的条目，例如 “always use explicit error handling”，除非它确实是全局偏好。优先使用带范围的指导：“In this repo, avoid catch-all error handlers in API routes because errors are logged by middleware.”

好的 remember 用法会生成简洁、带上下文的 memory，在不让 agent 变得僵硬或嘈杂的前提下，提升未来协助质量。