SuperAPI AI 工具集

journal-reflection

办公与效率

查看项目

更新于 10-15 14:29

技能介绍

用途

Journal Reflection 是一个结构化反思引导技能,帮助用户在特定时间点或事件后进行有重点的反思,避免常见的日记式冗长。它适用于一天结束、一周结束、做出某个决策之后,或接触新学习材料之后。当用户要求反思、回顾或记录学习时触发;不用于晨间简报(那应交给 daily-brief)。

主要能力

该技能提供多种反思模式,用户需先选择一种模式再运行:

  • 日终反思(5 分钟):围绕 3 个问题回顾当天。
  • 周终反思(15 分钟):围绕 5 个问题回顾本周,并进行模式扫描。
  • 决策复盘:针对过去的一个决策提出 4 个问题。
  • 学习日志:围绕一个新框架或概念展开,并与用户已知内容建立联系。
  • 交付后记录(2 分钟):完成一项交付物后,用 4 行“我学到了什么”追加到持续日志中。它比学习日志更轻量(不做框架深挖),由交付物触发而非概念触发。会话结束时 /wrap-up 会提供此模式,用户也可随时直接触发。

各模式的具体问题如下:

日终反思(逐个提问,等待回答):

  1. 今天完成了什么重要的事?(不是任务清单,而是真正推进了什么)
  2. 什么阻碍了你,代价是什么?
  3. 明天需要你做什么,而今天没有做到的?

结尾:为明天写一个承诺,一句话,以动词开头。

周终反思(逐个提问):

  1. 对照本周既定目标,诚实的进展如何?(不使用百分比语言)
  2. 本周出现了哪些上周也出现过的模式?
  3. 关于工作,或关于做这项工作的自己,你学到了什么?
  4. 下周你会改变什么?具体、小、可测试。
  5. 有什么值得被命名为胜利,而你还没有命名的?

结尾:下周要留意的一个模式。

决策复盘:

  1. 这个决策是什么,你何时做出的?
  2. 当时你知道什么,又在猜测什么?
  3. 此后数天或数周发生了什么?
  4. 如果这个决策今天才到来,你会怎么做?

结尾:一条要带向未来的规则,写成 if-then 形式。

学习日志:

  1. 这个概念或框架是什么?如果有作者和年份请引用。
  2. 它解决了哪些旧框架解决不了的问题?
  3. 它如何与用户已经在用的东西联系起来?
  4. 用户会首先在哪里应用它?

交付后记录(逐个提问,每个答案保持一行):

  1. 这项交付物让你对工作有了什么认识?
  2. 下次你会怎么做?
  3. 一件要带向未来的事。
  4. 什么做得好、你想重复?(成功提取)

如果第 4 个答案指出了一种可重复的系统行为(提示模式、工作流、专家或模型选择),可提议将其同时存为反馈记忆,附上 Why: 和 How to apply: 两行——只需一次是/否确认,不施压。这为 /improve-system 提供已确认的成功案例以供趋势分析,而不仅是纠正。

如果用户为交付物提供了名称或 slug,则使用它;否则询问一个 2–4 词的标签。此模式追加到单一持续日志(见文件放置),而不是每次创建单独文件。

使用方式

  • 触发后,先用一个提示询问用户适用哪种模式。如果用户只说“journal”而未指定,默认使用日终反思。
  • 逐个提问,等待每个回答后再继续。
  • 输出为 Obsidian 兼容的 markdown,带 YAML frontmatter:
---
date: YYYY-MM-DD
type: [daily | weekly | decision-review | learning-log]
tags: [journal, ...domain tags]
dg-publish: false
---
  • 对人物、概念、框架和项目使用 [[wiki-links]]。dg-publish 默认为 false;如果用户说笔记可发布,则设为 true 并询问 permalink stub。
  • 正文结构:每个问题一个 H2,答案以纯散文形式写在下面,除非内容是列表,否则不用项目符号。

文件放置:库根目录为 OBSIDIAN_VAULT_ROOT(C:/Users/AGasser/OneDrive/Ane Obsidian Vault,参见 ~/.claude/CLAUDE.md 中的路径常量表)。如果库路径可达,直接用 Write 工具写入:

  • 日终:5 JURNAL/5a Daily Notes/YYYY-MM-DD.md
  • 周终:5 JURNAL/5b Weekly Notes/YYYY-Www.md
  • 决策复盘:5 JURNAL/Decisions/YYYY-MM-DD-<slug>.md
  • 学习日志:5 JURNAL/Learning/<slug>.md
  • 交付后记录:追加到 5 JURNAL/Learning/deliverable-learning-log.md(单一持续日志)。如果文件不存在,则创建它并带上 YAML frontmatter(type: learning-log)和一个 H1,然后添加第一条记录。如果已存在,则追加一个新的 ## YYYY-MM-DD — <deliverable label> 小节,将四个答案作为项目符号,并逐字节保留所有先前记录(编辑保留)。

如果库路径不可达(网页会话、其他设备),则在回复中返回 markdown 并指明目标路径,以便用户手动保存。

写作规则:遵循 CLAUDE.md 的房屋风格。一个例外:在日记答案中,当用户的回答本身是反思性的时,被动和反思性措辞是可以接受的。不要将她的措辞改写为主动语态——原样保留她的声音。

适用场景

  • 一天结束时快速回顾当天。
  • 一周结束时回顾进展并识别重复模式。
  • 对过去某个决策进行复盘。
  • 学习新框架或概念后建立联系并规划应用。
  • 完成一项交付物后进行轻量快速记录。

限制

  • 不编造反思。不自动回答提示。提示发给用户并等待。
  • 如果用户跳过某个提示,将该小节标记为 (skipped) 并继续。
  • 不说教。
  • 编辑保留协议:如果用户按路径引用现有输出并要求改进、迭代或扩展,该协议激活。先读取文件,通过 Edit 工具进行范围受限的编辑,逐字节保留范围外内容,并返回 EDIT-PRESERVATION DELIVERY 摘要。当目标文件存在时,应用 mel_wiki/wiki/concepts/edit-preservation-protocol.md。