{"id":"5cbb58b6-6f74-4480-be3b-f9233d78ba86","slug":"my-reflection","kind":"skill","name":"my-reflection","summary":"Turn a debugging, study, or build session into a long-term Markdown note — quick note, learning note, or project archive.","owner":"IShenH","repoUrl":"https://github.com/IShenH/my_reflection","license":"MIT","licenseTier":"permissive","trust":"community","stars":0,"match":null,"fewStars":true,"format":"skill","createdAt":"2026-09-16T16:57:57.000Z","addedAt":"2026-10-21T11:38:03.738Z","logoUrl":"https://avatars.githubusercontent.com/u/132966143?u=51b120d300efc7023b505f2584cc811dd962109f&v=4","linkOnly":false,"collection":null,"skillPath":null,"categories":["productivity","files-documents","memory-knowledge"],"tags":["ai-agent-skill","debrief","knowledge-management","markdown","note-taking","obsidian","zcode"],"runtime":"binary","local":true,"cloudCapable":false,"cloudCapability":"unknown","cloudReadyOnPlatform":false,"needsApiKey":false,"reviewed":false,"syncedAt":"2026-10-23T05:40:04.171Z","sample":false,"url":"https://conduits.dev/tools/my-reflection","language":"","transports":["stdio"],"install":{},"requirements":{"env":[],"upstreamMayCharge":false},"tools":null,"readme":"# my_reflection\n\n把一次学习、调试、探索的经历，或一个项目，整理成一份可长期保存、日后复习的 Markdown 笔记。\n\n解决的具体问题：会话结束后，那些\"刚才到底发生了什么、为什么、怎么解决的\"往往只留在聊天记录里，过几天就找不到、也想不起来。这个 skill 把这段经历沉淀成笔记，落进你自己的笔记目录。\n\n## 三种重量，按提法自动选\n\n| 重量 | 触发提法 | 产出 |\n|---|---|---|\n| 速记 | 快速复盘 / 简单说说 / 记录一下 / 先记个大概 / 不用太详细 | 一屏以内（≤20 行）的短讲解，五六行要点 |\n| 完整 | 帮我复盘一下 / 把这次的收获记下来 / 整理成学习笔记 | 完整文档，分下面两条路径 |\n| 深度 | 讲透 / 深入一点 / 详细讲讲原理 / 我想彻底搞懂 | 在完整文档上加机制深挖、方案对比、最小复现、适用边界 |\n\n用户说\"讲透\"就展开，说\"简单说说\"就压缩；看完速记说\"展开第 3 点\"，会在同一份骨架上扩写，不会重头另起。\n\n## 两条路径\n\n- **路径 A：学习心得** —— 重点是学习、理解、反思：一个报错、一个概念、一段经历、一本书或一篇论文。核心要求是**技术原理讲到机制层**——哪个函数、哪个配置项、哪一层缓存、哪条调用链，方案切断了因果链的哪一环，不做这个改动为什么会复现。只写\"后来改好了\"不算合格。\n- **路径 B：项目档案** —— 重点是把一个项目本身讲清楚：是什么、为什么存在、怎么做的、产出了什么、局限在哪。面向简历、面试、作品集、博客或长期留档，要求把**事实 / 判断 / 待确认**分开标注，宁可写\"当前没有量化指标\"也不编数字。\n\n两条路的判据是**意图，不是主题**——有没有代码、是不是技术话题都不决定归属。实在分不清时会只问你一句，不会来回打听。\n\n## 安装\n\n把本目录放到任一 skill 发现位置（目录名要与 frontmatter 里的 `name` 一致）：\n\n```\n~/.agents/skills/my_reflection/          用户级，所有项目可用\n<项目>/.agents/skills/my_reflection/     项目级\n~/.zcode/skills/my_reflection/           用户级（ZCode 优先扫描 .zcode）\n```\n\n## 配置笔记存到哪\n\n默认存到当前工作区的 `notes/`（没有就新建）。想固定成自己的笔记目录（比如 Obsidian 库里的某个文件夹），复制模板并填写：\n\n```bash\ncp references/paths.md.example references/paths.md\n```\n\n`paths.md` 存的是你自己的绝对路径，已在 `.gitignore` 里排除，不要提交。它存在时，保存规则完全以它为准——这也是本仓库既能通用分发、又能长期自用的原因：**正文只有一份，个人配置单独放。**\n\n## 输出结构\n\n```\n<笔记根>/\n├── YYYY-MM-DD-主题.md      速记（升级成完整心得后移入 learning-notes/）\n├── learning-notes/         学习心得\n└── project-archives/       项目档案\n```\n\n每份笔记带三行 frontmatter（`date` / `type` / `tags`），便于按类型和主题检索；文件名以日期开头，主题取事情的关键词。同一个问题第二次记录时，会先找已有笔记扩写而不是新建——同一件事只有一个文件，避免散成一堆。\n\n## 它刻意不做的事\n\n- 不编造：材料里没有的细节不补，推断标\"推断 / 待验证\"。\n- 不做纯知识问答、不代做只要求执行的任务——那些不需要留下笔记。\n- 不写依赖会话现场的指代（\"刚才\"\"上面那段代码\"）。笔记是写给几周后已经忘了细节的自己看的。\n\n## License\n\nMIT\n"}