agent-memory

agent-memory 技能提供了一种稳健的持久化存储机制，旨在协助 AI 代理在漫长的开发周期中维持上下文。通过在 .claude/skills/agent-memory/memories/ 建立专用目录，此技能允许代理存储珍贵的研究结果、架构决策、复杂的调试过程以及进行中的开发任务。这能防止信息随对话结束而丢失，并作为结构化的知识库，让代理在开始新任务前能主动查询，确保技术一致性并减少重复调查的工作量。

• 持久化存储项目特定的见解，包括代码库中的潜在陷阱（gotchas）以及复杂的依赖关系解析模式。

• 支持使用文件夹与 YAML 前置数据进行分类管理，可追踪状态、标签与更新时间戳。

• 与 ripgrep (rg) 指令集成，可通过摘要、标签或全文关键字进行快速搜索与过滤。

• 提供「存储与恢复」工作流，允许代理记录任务的当前状态、已识别的阻碍问题以及未来的行动项目。

• 标准化记忆格式，确保所有条目皆可被机器读取，且易于由代理的文件系统操作功能进行遍历。

• 每当你在调试过程中发现不显眼的模式或解决方案时，请使用此技能，以避免「遗忘」关键逻辑。

• 请务必重视 YAML 前置数据中的 summary 字段，这将作为代理在搜索既有笔记时的核心判断依据。

• 请遵循 kebab-case 命名惯例来命名文件与目录，以保持记忆空间的整洁与可维护性。

• 定期整理或合并记忆内容，以避免碎片化，并确保代理仅能检索到高质量、相关的数据。

• 执行搜索操作时，务必对 ripgrep 使用 --no-ignore 与 --hidden 标志，以确保代理即使在全局 gitignore 设置下，仍能正确遍历记忆目录。