用途：将新的准则、最佳实践或架构决策持久化到仓库知识库，使其在未来的 AI 会话中可用。触发场景是用户要求“记住”某件事以供后续会话使用。
主要能力：接收一段自然语言输入（必填），提炼其中的核心原则或技术意图，并用精确的软件开发术语重述；判断该知识应写入哪个文件；扫描目标文件及另一层对应文件中的冲突内容；写入更新；发现并同步可能受影响的技能文件；最后报告所有改动。
目标文件选择：项目级约定或标准优先写入 AGENTS.md，回退到 CLAUDE.md；领域最佳实践（测试、组件、API 设计等）优先写入 rules/ 或 docs/conventions/，两者都存在时优先 rules/，都不存在时创建 rules/；自动化工作流或技能写入 .agents/skills/，回退 .claude/skills/；智能体行为准则写入 .agents/agents/，回退 .claude/agents/；Claude 专属配置（MCP、hooks、权限）写入 CLAUDE.md。
用法示例：/remember always use the --frozen-lockfile flag in CI；/remember the auth module was refactored to use middleware in PR #342；/remember integration tests must hit a real database, never use mocks。
冲突处理：若发现与新准则矛盾或使其过时的表述，立即停止执行，引用原文并请用户澄清，解决前不继续更新。
技能同步：扫描 .agents/skills//SKILL.md 和 .claude/skills//SKILL.md，读取时解析符号链接。受影响的本地技能直接编辑；共享技能先报告并询问是否添加仓库专属补充，确认后在本地层写入补充内容并让共享技能引用生效。
限制与准则：修改前必须先读取目标文件；优先追加到已有章节；条目保持简洁；输入含糊时先询问；不重复已有信息；创建技能文件时可创建子目录，但不要创建 .agents/ 或 .agents/skills/ 目录，仅在已存在时使用。