墨记

解决什么问题

日常工作经验往往散落在聊天记录、浏览器标签页、git commit 和口头沟通里，过几天就难以完整复现。想复盘时只能翻 git log，但缺少业务上下文；想给同事讲实现时，又容易从头解释。这个技能要解决的是“经验碎片化、难检索、难传递、难复用”的问题：把工作过程中的变更和决策沉淀为可回看、可分享的文本资料。

技能如何工作

它本质上是一个轻量级的个人经验采集器，围绕本地工作目录运行。核心能力包括：

• 文件变更监控：扫描指定工作目录，通过文件哈希识别新增、修改和删除，而不是只记录提交信息。
• Git 变更记录：收集最近 24 小时的提交与未提交变更，把代码动作纳入笔记上下文。
• Shell 历史收集：记录最近执行的命令，补全手动操作和临时调试痕迹。
• 学习记录收集：自动整理 self-improving-agent 格式的经验，让可复用知识有固定结构。
• 结构化输出：按日期生成 Markdown 笔记，并分类存储，方便后续检索和导出。

关键步骤是先把项目目录加入监控范围，运行一次建立基线，再设置定时任务持续采集。输出通常是按天组织的 Markdown 文件，可以直接配合 Obsidian 作为 Vault 浏览，也可以导出给同事或团队参考。

适用边界与注意点

它适合个人经验沉淀、项目复盘和团队知识传递，但不等于完整的项目管理系统。它依赖本地目录权限和 Shell 历史记录，敏感路径、私有凭据或生产配置不应直接纳入采集范围。生成的笔记更像工作底稿，分享前仍需要补充业务背景、取舍原因和结论，避免把命令日志直接当成完整设计文档。