用途
wrap-up 是一个会话结束(end-of-session)技能,用于把本次会话的工作持久化到 Obsidian:按项目生成一篇会话笔记(session note),并写入每日笔记(daily note)。它适用于关闭一个工作会话并记录工作内容的场景。
该技能为单触发(single-trigger):每次调用都会运行完整工作流,不区分模式。触发方式为会话结束命令 /wrap-up,触发后即运行下述工作流。
工作流
整体流程为:mapping → handoff:Load → notes(撰写)→ handoff:Cleanup → archive offer。
技能提供了一份可复制的清单,包含六个步骤:
- 步骤 1:解析项目条目(Resolve the project entry)
- 步骤 2:加载交接文件(Load the handoff)
- 步骤 3:撰写会话笔记与每日笔记(Write the session note and the daily note)
- 步骤 4:清除交接(Clear the handoff)
- 步骤 5:收集往月每日笔记(Collect past-month daily notes)
- 步骤 6:报告(Report)
各步骤说明
步骤 1:解析项目。 加载 mapping.md,解析项目条目与基础标签(base tags)。当注册表或条目缺失时,按 mapping 的指示加载 bootstrap.md。后续每一步都依赖此输出。完成条件:已知条目的 name、obsidian.path 与 tags。
步骤 2:加载交接。 加载 handoff.md 并运行其 Load 阶段——位于 .artifacts/HANDOFF.md 的合并交接文件(若存在)为笔记内容提供输入。它作为待核实的声明(claim)进入,而非权威来源:如果当前对话或仓库与某条声明矛盾,应报告该矛盾,而不是把它复制进持久笔记。完成条件:交接字段已进入工作上下文,或已知交接不存在。
步骤 3:撰写笔记。 加载 notes.md,撰写 Obsidian 会话笔记与每日笔记。如果草稿未通过 notes.md 中的检查,则重写并再次检查,通过后再写入。完成条件:每个已配置的写入返回成功,或返回需要报告的失败。
步骤 4:清除交接。 运行 handoff.md 的 Cleanup 阶段——在每一个已配置的笔记写入都成功后清除交接。完成条件:交接已清空,或因某次写入失败而保留。
步骤 5:收集往月。 按 notes.md 的规定提议归档往月——仍位于 Daily/ 根目录的往月每日笔记会在报告中列出,仅在用户确认(yes)后才移入对应的月度文件夹。完成条件:列表已收集,或不存在此类笔记。
步骤 6:报告。 以一份报告结束:写入会话笔记时给出其路径,以及每日笔记路径;用一到三句话说明笔记记录了什么(更新时说明改了什么);以及所有未决事项——被矛盾的交接声明、失败的写入、等待归档答复的往月每日笔记(按目标文件夹分组)。绝不粘贴任何一篇笔记。完成条件:报告包含笔记路径、摘要与每一项未决事项,或说明不存在未决事项。
使用方式与交互约定
六个步骤在一次运行中完成。初次调用即授权前四步:它们之间绝不暂停等待确认,绝不在聊天中预览笔记内容,只在最后报告。有两个例外:步骤 1 中首次运行的 bootstrap 问题,以及步骤 5 中的归档问题——该问题在报告时一并询问一次。
适用场景
- 结束一次工作会话,需要把本次工作记录到 Obsidian。
- 需要按项目维护会话笔记,并同步更新每日笔记。
- 需要在会话结束时清理交接文件,并处理往月每日笔记的归档。
限制与依赖
- 依赖 mapping.md、handoff.md、notes.md、bootstrap.md 等配置文件,以及 .artifacts/HANDOFF.md 交接文件(若存在)。
- 交接内容仅作为待核实的声明,与当前对话或仓库矛盾时需报告而非直接采用。
- 笔记写入失败时交接会被保留,不会清除。
- 往月每日笔记的归档需用户明确确认后才会执行。
- 关于收费、价格、支持平台等具体信息,资料中暂未提供。