mem-file-scan

用途

Mem File Scan 是 AI 个人记忆系统中的一个文件扫描回顾技能，用于扫描 Obsidian 仓库中本周修改的文件，帮助用户补充记录到 L1 情境层。它针对的是 AI 记忆系统只能记录 Claude 对话内容、无法捕获用户在 Obsidian 中其他活动的问题。

主要能力

按本周时间范围筛选 Obsidian 仓库中修改的文件。
排除记忆系统本身和系统相关目录，聚焦用户实际活动。
分类展示找到的文件，供用户选择分析范围。
读取并分析文件，识别潜在的重要事件和决策。
生成候选记录列表，交由用户确认后记录到 L1。

触发时机

用户主动请求：「文件扫描」「查看本周文件」「扫描文件变化」。
周复盘流程开始时（可在周复盘前自动调用）。
用户想回顾本周在 Obsidian 中的活动。

使用方式

第一步：确定本周时间范围

计算本周的日期范围：

如果是周日或周日之后：本周一（00:00）至现在。
如果是周日之前：上周一（00:00）至上周日（23:59）。

示例：

# 获取本周日期范围
今天是：2025-12-27（周五）
本周范围：2025-12-22（周一）至 2025-12-27（今天）

第二步：扫描修改的文件

使用 Bash 工具查找本周修改的文件：

# 查找本周修改的.md文件
# 排除AI_MEMORY目录（因为那是记忆系统本身）
# 排除.obsidian、.trash等系统目录

find . -name "*.md" -type f -newermt "2025-12-22" ! -newermt "2025-12-28" \
  ! -path "./AI_MEMORY/*" \
  ! -path "./.obsidian/*" \
  ! -path "./.trash/*" \
  ! -path "./.claude/*"

注意事项：

! -path "./AI_MEMORY/*" 排除记忆系统本身。
根据实际日期调整 -newermt 参数。
使用 find 命令的 -newermt 选项查找修改时间。

第三步：展示文件列表并询问

将找到的文件分类展示给用户，例如按 Daily 日记类、项目文档类、学习笔记类、其他等分组，然后询问用户希望从哪些文件开始，或直接告知哪些文件包含重要事件/决策/偏好。

第四步：读取并分析文件

根据用户选择，逐个读取文件并分析，识别重点包括：

重要决策：技术选型、工具选择、方向调整。
情绪记录：明显的情绪表达（兴奋、焦虑、成就感等）。
新项目/新习惯：开始新项目、建立新习惯。
重复行为：3 次以上的相似活动。
偏好表达：明确的喜欢/不喜欢表述。
待办事项：重要但未完成的事项。
有意义的资料收集：与当前项目/系统强相关的学习资料、反映新兴趣方向的资料收集、可能暗示潜在改进意图的资料。

忽略内容：

偶然保存的无关文章（与当前兴趣/项目无关）。
纯粹的临时笔记（无后续行动）。
代码片段（除非是重要学习成果）。
已记录到 L1 的内容。

第五步：生成候选记录列表

对每个文件生成候选记录，标注类型（如重要决策、日常事件），包含内容、用户考虑、情绪等，并询问是否记录到 L1（是/否/修改后记录）。

第六步：等待用户确认并记录到 L1

根据用户确认，使用 mem-record skill 记录到 L1：

如果用户选择「是」：调用 mem-record skill，传入提取的内容。
如果用户选择「修改后记录」：询问用户如何修改，根据反馈调整内容，调用 mem-record skill。
如果用户选择「否」：跳过，继续下一个。

第七步：汇总记录结果

所有文件处理完成后输出汇总，包括扫描文件数、识别候选数、成功记录到 L1 数，以及记录详情和建议。

注意事项

文件排除规则

始终排除以下目录和文件：

AI_MEMORY/：记忆系统本身。
.obsidian/：Obsidian 配置。
.trash/：已删除文件。
.claude/：Claude Code 配置。
任何隐藏文件/目录（以 . 开头）。

智能识别优先级

决策 > 日常事件。
情绪 > 纯事实。
新项目/新习惯 > 常规活动。
重复行为 > 偶发事件。

记录密度控制

不要过度记录：琐碎的日常琐事无需记录。
聚焦重要事件：决策、情绪、偏好、模式。
尊重用户选择：由用户决定哪些值得记录。

与其他 skills 的协作

与 mem-record 协作

本 skill 识别出需要记录的内容后，调用 mem-record skill 进行实际记录：

[mem-file-scan] 识别候选 → [用户确认] → [mem-record] 执行记录

与 mem-weekly 协作

在周复盘流程中，可以在分析 L1 记录之前调用本 skill：

[周复盘开始]
  ↓
[mem-file-scan] 扫描本周文件，补充L1
  ↓
[mem-weekly] 分析L1，识别行为模式

错误处理

没有找到修改的文件

本周未发现修改的文件（排除 AI_MEMORY 目录）。

可能原因：

本周主要在 Claude 中对话，较少直接编辑 Obsidian。
文件修改时间未在本周范围内。

建议：

继续使用 mem-record 记录日常对话。
下周再尝试文件扫描。

文件过大或格式异常

提示：⚠️ 文件 {filename} 过大或格式异常，跳过分析。

用户可：

手动告诉我这个文件里的重要内容。
继续处理其他文件。

示例对话

用户主动触发

用户：文件扫描

Claude：调用 mem-file-scan，展示本周文件扫描结果，发现修改的文件，进入后续流程。

周复盘时自动调用

用户：周复盘

Claude：先调用 mem-file-scan，在开始周复盘前扫描本周修改的文件，补充记录完成后调用 mem-weekly 开始周复盘分析。