TWBG_Materials/文档润色流和知识库构建流/claude-scholar-upstream/commands/update-memory.md

description

description
Check and update CLAUDE.md memory based on changes to skills, commands, agents, and hooks.

Update Memory

检查并更新 CLAUDE.md 全局记忆文件，确保其内容与 skills、commands、agents、hooks 的源文件保持同步。

功能概述

CLAUDE.md 是一个汇总记忆文件，包含：

• 技能目录结构（来自 skills/）
• 命令列表（来自 commands/）
• 代理配置（来自 agents/）
• 钩子定义（来自 hooks/）

当这些源文件发生变化时，CLAUDE.md 需要同步更新。

检测逻辑

1. 扫描源文件修改时间

   • ~/.claude/skills/**/skill.md
   • ~/.claude/commands/**/*.md
   • ~/.claude/agents/**/*.md
   • ~/.claude/hooks/**/*.{js,json}

2. 对比 CLAUDE.md 最后修改时间

   • 如果任意源文件比 CLAUDE.md 新 → 需要更新
   • 记录上次同步时间戳（~/.claude/.last-memory-sync）

3. 生成报告

   • 列出所有变更的源文件
   • 显示需要更新的 CLAUDE.md 章节

更新流程

1. 扫描阶段

扫描 Skills: X 个
扫描 Commands: Y 个
扫描 Agents: Z 个
扫描 Hooks: W 个

2. 对比阶段

需要更新的章节:
- [ ] 技能目录结构 (3 个技能变更)
- [ ] 命令列表 (1 个命令新增)
- [ ] 代理配置 (无变更)
- [ ] 钩子定义 (2 个钩子修改)

3. 确认更新

询问用户是否执行更新：

是否更新 CLAUDE.md? (yes/no/diff)
- yes: 执行更新
- no: 取消
- diff: 显示详细差异

4. 执行更新

• 保留用户手动编辑的内容（如"用户背景"、"技术栈偏好"）
• 仅更新 AUTO-GENERATED 标记的章节
• 更新时间戳

使用方式

/update-memory          # 检查并提示更新
/update-memory --check  # 仅检查，不更新
/update-memory --force  # 强制更新，不询问
/update-memory --diff   # 显示差异对比

输出示例

检查结果

📋 CLAUDE.md 记忆状态检查

源文件状态:
✅ Skills: 24 个 (最近修改: ml-paper-writing)
✅ Commands: 14 个 (最近修改: update-readme)
✅ Agents: 7 个 (无变更)
✅ Hooks: 5 个 (最近修改: session-summary)

时间对比:
- CLAUDE.md 最后更新: 2024-01-15 10:30
- 源文件最后修改: 2024-01-16 14:22

⚠️ 检测到变更，建议更新 CLAUDE.md

变更详情:
1. skills/ml-paper-writing/skill.md (修改于 14:22)
2. commands/update-readme.md (修改于 13:15)
3. hooks/session-summary.js (修改于 11:45)

是否执行更新? (yes/no/diff)

更新完成

✅ CLAUDE.md 已更新

更新内容:
- 技能目录: 同步 24 个技能
- 命令列表: 同步 14 个命令
- 代理配置: 无变更
- 钩子定义: 同步 5 个钩子

下次同步时间戳已更新。

集成建议

• 在 session-summary.js 中集成检查提醒
• 在 PostToolUse 钩子中实时检测
• 建议定期执行（如每次会话结束时）