my-reflection

my_reflection

把一次学习、调试、探索的经历，或一个项目，整理成一份可长期保存、日后复习的 Markdown 笔记。

解决的具体问题：会话结束后，那些"刚才到底发生了什么、为什么、怎么解决的"往往只留在聊天记录里，过几天就找不到、也想不起来。这个 skill 把这段经历沉淀成笔记，落进你自己的笔记目录。

三种重量，按提法自动选

用户说"讲透"就展开，说"简单说说"就压缩；看完速记说"展开第 3 点"，会在同一份骨架上扩写，不会重头另起。

两条路径

• 路径 A：学习心得 —— 重点是学习、理解、反思：一个报错、一个概念、一段经历、一本书或一篇论文。核心要求是技术原理讲到机制层——哪个函数、哪个配置项、哪一层缓存、哪条调用链，方案切断了因果链的哪一环，不做这个改动为什么会复现。只写"后来改好了"不算合格。
• 路径 B：项目档案 —— 重点是把一个项目本身讲清楚：是什么、为什么存在、怎么做的、产出了什么、局限在哪。面向简历、面试、作品集、博客或长期留档，要求把事实 / 判断 / 待确认分开标注，宁可写"当前没有量化指标"也不编数字。

两条路的判据是意图，不是主题——有没有代码、是不是技术话题都不决定归属。实在分不清时会只问你一句，不会来回打听。

安装

把本目录放到任一 skill 发现位置（目录名要与 frontmatter 里的 name 一致）：

~/.agents/skills/my_reflection/          用户级，所有项目可用
<项目>/.agents/skills/my_reflection/     项目级
~/.zcode/skills/my_reflection/           用户级（ZCode 优先扫描 .zcode）

配置笔记存到哪

默认存到当前工作区的 notes/（没有就新建）。想固定成自己的笔记目录（比如 Obsidian 库里的某个文件夹），复制模板并填写：

cp references/paths.md.example references/paths.md

paths.md 存的是你自己的绝对路径，已在 .gitignore 里排除，不要提交。它存在时，保存规则完全以它为准——这也是本仓库既能通用分发、又能长期自用的原因：正文只有一份，个人配置单独放。

输出结构

<笔记根>/
├── YYYY-MM-DD-主题.md      速记（升级成完整心得后移入 learning-notes/）
├── learning-notes/         学习心得
└── project-archives/       项目档案

每份笔记带三行 frontmatter（date / type / tags），便于按类型和主题检索；文件名以日期开头，主题取事情的关键词。同一个问题第二次记录时，会先找已有笔记扩写而不是新建——同一件事只有一个文件，避免散成一堆。

它刻意不做的事

• 不编造：材料里没有的细节不补，推断标"推断 / 待验证"。
• 不做纯知识问答、不代做只要求执行的任务——那些不需要留下笔记。
• 不写依赖会话现场的指代（"刚才""上面那段代码"）。笔记是写给几周后已经忘了细节的自己看的。

License

MIT