Conversation Recap to Obsidian
This skill turns raw conversation or existing Obsidian markdown into review-ready notes, not generic summaries. Treat the whole daily/weekly note as input content regardless of who wrote each part.
The default goal is to help the user answer:
- - What were the main things done?
- What problems did those things solve?
- What were the key points?
- What conclusions or outputs matter later?
- Which notes/documents should be linked for follow-up?
Use this skill for
- - writing a structured recap of the current conversation into Obsidian
- appending a single session entry into a daily note
- regenerating a daily summary by reading the full daily note first
- creating a weekly report from multiple daily notes
- merging a multi-day thread into one weekly module
- replacing stale generated summary blocks while preserving all non-target content
- producing Obsidian wikilinks for relevant artifacts
- consolidating notes that may contain mixed content from humans, this assistant, and other AI/tools
Core design
Split the work in three layers:
- 1. Entry layer = raw work-item capture
- append a single session recap into the daily note
- preserve concrete issue / solution / conclusion / key point details
- act as the source material for later daily and weekly synthesis
- 2. Daily summary layer = same-day aggregation
- read the full daily note
- merge duplicate work threads
- compress the day into a small number of reusable conclusions
- 3. Weekly layer = cross-day synthesis
- merge same-topic work across multiple days
- rank larger / more complex items first
- avoid day-by-day流水账
Use scripts when they improve reliability. Do not avoid them just to stay “pure prompt only.”
Daily note target
Default path:
- -
daily/YYYY/MM/YYYY-MM-DD.md (organized by year and month) - Users may override the base directory through local config
Mode 1: Session recap mode
Use this when the user has just finished one conversation or one work block and wants to record a new entry instead of refreshing the whole day.
Session recap principle
Create a new item in the daily note as source material for later summaries.
Default entry structure
CODEBLOCK0
Session recap guidance
- - Prefer one concrete work item per entry.
- If the conversation truly covered multiple unrelated things, either split into 2 entries or name the entry at a higher level.
- Keep each field tight and useful.
- The title should describe the work item, not just say “对话总结”.
- Use tags sparingly; 1-3 strong tags are enough.
- Preserve document hierarchy: session entries belong in the raw entry section of the daily note, and the generated
## 今日总结 block should stay as a higher-level summary section near the end of the note. - When appending an entry to a daily note that already contains
## 今日总结, insert the new entry before the generated summary block, then refresh the summary if needed.
Mode 2: Daily summary mode
A daily summary is regenerable. It is not an append-only log.
When asked to refresh the daily summary:
- 1. Read the full daily note.
- Treat the whole note as usable source material regardless of whether parts were written by a person or another AI/tool.
- Ignore only the previous generated summary block for this skill to avoid recursive self-copying.
- Extract the day’s main work items from the note content.
- Compress them into a concise review section.
- Replace only the generated summary block.
Default daily output shape
CODEBLOCK1
Daily writing guidance
- - Prefer outcomes over chronology.
- Merge duplicate points.
- If multiple sessions worked on the same thing, describe it once more strongly.
- If there are multiple unrelated threads, mention the top 2-3, not every small action.
- Keep links limited to durable notes or outputs.
- Treat the entire note as evidence; do not downgrade a section just because it was written by another AI/tool.
- Ignore only the current skill's previous generated summary block when refreshing, so the summary does not recursively paraphrase itself.
- Keep the summary compact and high-density rather than long and chatty.
Mode 3: Weekly summary mode
Default path:
- -
weekly/YYYY/MM/YYYY-MM-DD.md (organized by year and month)
The date is the Sunday of that reporting week.
Weekly summary principle
A weekly report should be organized by work item, not by day.
The correct unit is not “Tuesday” or “Wednesday.”
The correct unit is “the import pipeline fix,” “the skill redesign,” “the database migration,” etc.
If one work item spans 3 days, merge those 3 daily notes into one weekly module.
Weekly frontmatter and module structure
Weekly notes should include frontmatter like:
CODEBLOCK2
Then the body uses modules like:
CODEBLOCK3
Weekly ranking rule
Sort weekly items by importance using these signals:
- 1. number of involved days
- amount of structured content / subpoints
- visible complexity or decision weight
Larger, longer-running, more complex items should appear earlier.
Weekly writing guidance
- - Merge same-topic work across days.
- Avoid day-by-day流水账.
- Avoid vague weekly overviews.
- Name each item in a way the user can recognize later.
- Prefer 2-5 strong modules over 12 weak fragments.
- If a single work item appears in several daily notes, produce one merged module instead of repeating it by date.
- When source material is sparse or uneven, still try to infer the strongest few work modules from headings, bullets, and existing summary sections.
- Keep each module concise; the default should read like a crisp weekly review, not a transcript.
Tagging guidance
Tags are optional but useful.
Principles
- - Prefer existing tags already present in the note.
- Add tags only when they improve retrieval or weekly grouping.
- Keep tags lightweight.
- Good tag sources:
- project or product name
- work type (
#summary-skill,
#线上排障)
- technical topic (
#jwt,
#auth,
#obsidian)
Avoid
- - over-tagging
- generic tags with no retrieval value
- tags that merely restate the obvious
Safe rewrite rule
Generated sections should be wrapped with markers so they can be replaced safely:
CODEBLOCK4
Preserve all non-target content outside the markers.
Bundled script
Use the bundled script for stable maintenance tasks:
The script is publishable because it supports shared defaults plus local overrides.
Resolve configuration in this order:
- 1. CLI arguments
- INLINECODE10 next to the skill
- built-in defaults
Commands
Append a session entry:
CODEBLOCK5
Refresh a daily summary:
CODEBLOCK6
Generate a weekly report:
CODEBLOCK7
Important constraints
- - Do not invent documents or wikilinks.
- Prefer documents explicitly connected to the current work item; do not sweep unrelated paths from the whole note into “相关文档”.
- Do not blindly append a second stale summary if the user asked for refresh/regeneration.
- Do not reduce weekly review into a chronological diary.
- If source notes are weak, still try to infer stable work modules from headings and structured bullets.
Success bar
A good result lets the user quickly review:
- - what the major work items were
- what each item actually solved
- why it mattered
- what durable outputs or notes exist
- which tags or themes recur across the day or week
对话回顾转Obsidian笔记
此技能将原始对话或现有的Obsidian Markdown转化为可直接用于回顾的笔记,而非泛泛的摘要。无论每部分由谁撰写,都将整个日/周笔记视为输入内容。
默认目标是帮助用户回答:
- - 完成了哪些主要事项?
- 这些事项解决了什么问题?
- 关键点是什么?
- 哪些结论或产出后续重要?
- 应链接哪些笔记/文档以便跟进?
适用场景
- - 将当前对话的结构化回顾写入Obsidian
- 将单次会话记录追加到日笔记中
- 先读取完整日笔记,再重新生成日摘要
- 从多条日笔记创建周报
- 将跨多天的线程合并为一个周模块
- 替换过时的生成摘要块,同时保留所有非目标内容
- 为相关产物生成Obsidian Wiki链接
- 整合可能包含人类、本助手及其他AI/工具混合内容的笔记
核心设计
将工作分为三个层次:
- 1. 条目层 = 原始工作项记录
- 将单次会话回顾追加到日笔记中
- 保留具体问题/方案/结论/关键点细节
- 作为后续日和周综合的原始素材
- 2. 日摘要层 = 当日聚合
- 读取完整日笔记
- 合并重复的工作线程
- 将一天压缩为少量可复用的结论
- 3. 周层 = 跨日综合
- 合并跨多天的同主题工作
- 优先排列更大/更复杂的项目
- 避免逐日记流水账
在能提高可靠性时使用脚本。不要为了保持纯提示词而回避它们。
日笔记目标路径
默认路径:
- - daily/YYYY/MM/YYYY-MM-DD.md(按年月组织)
- 用户可通过本地配置覆盖基础目录
模式1:会话回顾模式
当用户刚完成一次对话或一个工作块,希望记录新条目而非刷新全天内容时使用。
会话回顾原则
在日笔记中创建新条目,作为后续摘要的原始素材。
默认条目结构
markdown
事项标题 — HH:mm
- - 问题: ...
- 方案: ...
- 结论: ...
- 关键点: ...
- 关联: [[...]] · [[...]]
- 标签: #tag-a #tag-b
会话回顾指南
- - 每个条目优先记录一个具体工作项。
- 如果对话确实涉及多个不相关事项,要么拆分为2个条目,要么以更高层级命名条目。
- 保持每个字段简洁有用。
- 标题应描述工作项,而非仅写对话总结。
- 标签要克制使用,1-3个强相关标签即可。
- 保留文档层级:会话条目属于日笔记的原始条目部分,生成的## 今日总结块应作为靠近笔记末尾的高级摘要部分。
- 当向已包含## 今日总结的日笔记追加条目时,将新条目插入到生成的摘要块之前,然后根据需要刷新摘要。
模式2:日摘要模式
日摘要是可重新生成的。它不是仅追加的日志。
当要求刷新日摘要时:
- 1. 读取完整日笔记。
- 将整个笔记视为可用素材,无论部分内容是由人还是其他AI/工具编写。
- 仅忽略本技能之前生成的摘要块,以避免递归自复制。
- 从笔记内容中提取当天的主要工作项。
- 将其压缩为简洁的回顾部分。
- 仅替换生成的摘要块。
默认日输出格式
markdown
今日总结
- - 今日主要事项:...
- 核心解决的问题:...
- 关键点:...
- 结论/产出:...
- 相关文档:[[...]] · [[...]]
- 标签:#tag-a #tag-b
日撰写指南
- - 优先结果而非时间顺序。
- 合并重复要点。
- 如果多个会话处理同一事项,用更强的方式描述一次。
- 如果有多个不相关线程,提及前2-3个,而非每个小动作。
- 链接仅限于持久性笔记或产出。
- 将整个笔记视为证据;不要因为某部分由其他AI/工具编写就降低其重要性。
- 刷新时仅忽略本技能之前生成的摘要块,使摘要不会递归地自我转述。
- 保持摘要紧凑高密度,而非冗长啰嗦。
模式3:周摘要模式
默认路径:
- - weekly/YYYY/MM/YYYY-MM-DD.md(按年月组织)
日期为该报告周的周日。
周摘要原则
周报应按工作项组织,而非按天。
正确的单位不是周二或周三。
正确的单位是导入管道修复、技能重新设计、数据库迁移等。
如果一个工作项跨越3天,将这3条日笔记合并为一个周模块。
周前置元数据和模块结构
周笔记应包含如下前置元数据:
markdown
word_count: 1234
type: weekly-summary
week_start: 2026-03-23
week_end: 2026-03-29
然后正文使用如下模块:
markdown
1. 事项名
- - 涉及日期:2026-03-17、2026-03-18、2026-03-19
- 核心解决的问题:...
- 关键点:...
- 结论/产出:...
- 相关文档:[[...]] · [[...]]
- 标签:#tag-a #tag-b
周排序规则
按重要性对周项排序,使用以下信号:
- 1. 涉及的天数
- 结构化内容/子要点数量
- 可见的复杂性或决策权重
更大、运行时间更长、更复杂的项目应排在前面。
周撰写指南
- - 合并跨天的同主题工作。
- 避免逐日记流水账。
- 避免模糊的周概览。
- 以用户后续能识别的方式命名每个项。
- 优先2-5个强模块,而非12个弱碎片。
- 如果一个工作项出现在多条日笔记中,生成一个合并模块,而非按日期重复。
- 当素材稀疏或不均匀时,仍尝试从标题、项目符号和现有摘要部分推断出最强的几个工作模块。
- 保持每个模块简洁;默认应读起来像清晰的周回顾,而非转录稿。
标签指南
标签是可选的,但很有用。
原则
- - 优先使用笔记中已有的标签。
- 仅在能改善检索或周分组时添加标签。
- 保持标签轻量。
- 好的标签来源:
- 项目或产品名称
- 工作类型(#summary-skill、#线上排障)
- 技术主题(#jwt、#auth、#obsidian)
避免
- - 过度标签
- 无检索价值的通用标签
- 仅重复显而易见内容的标签
安全重写规则
生成的段落应包裹标记,以便安全替换:
markdown
...
保留标记外的所有非目标内容。
捆绑脚本
使用捆绑脚本进行稳定的维护任务:
- - scripts/recap_manager.py
该脚本可发布,因为它支持共享默认值加本地覆盖。
按以下顺序解析配置:
- 1. CLI参数
- 技能旁的config.json
- 内置默认值
命令
追加会话条目:
bash
python scripts/recap_manager.py append-entry \
--title JWT验签修复与线上排障 \
--problem 登录后 401,被踢回 \
--solution 补 JWKS 公钥验签并修正 issuer \
--conclusion 测试和正式环境恢复正常 \
--key-points 先确认 token claims,再加严格校验 \
--links app/core/auth/jwt_auth.py,deploy/config.k8s.yaml \
--tags jwt,auth,线上排障
刷新日摘要:
bash
python scripts/recap_manager.py refresh-daily-auto --date 2026-03-25
生成周报:
bash
python scripts/recap_manager.py generate-weekly-auto --mode last-week
重要约束
- - 不要虚构文档或Wiki链接。
- 优先选择与当前工作项明确相关的文档;不要从整个笔记中扫入不相关的路径到相关文档。
- 如果用户要求刷新/重新生成,不要盲目追加第二个过时摘要。
- 不要将周回顾简化为按时间顺序的日记。
- 如果源笔记较弱,仍尝试从标题和结构化项目符号推断稳定的工作模块。
成功标准
好的结果能让用户快速回顾:
- - 主要工作项是什么
- 每个项实际解决了什么
- 为什么重要
- 存在哪些持久性产出或笔记
- 哪些标签或主题在当天或当周重复出现