tldr

tldr-skill

在 Obsidian 库中管理对话摘要（tldr）。每份 tldr 都会记录决策、需要记住的要点和后续操作。

库根目录： 根据当前工作目录或项目的 CLAUDE.md 上下文确定。以下所有路径均相对于库根目录。读取或写入文件时，始终解析为绝对路径。

操作

命令	操作	说明
/tldr	创建	总结会话 → 提示选择项目 → 保存
/tldr read {project}	读取	显示项目的最新 tldr
/tldr update {project}	更新	补充或修改现有 tldr
/tldr delete {project}	删除	移除 tldr（需确认）

文件命名

01 - Projects/{project-name}/YYYY-MM-DD-HH-mm-{project-name}-tldr.md

示例：01 - Projects/vault-setup-skill/2026-03-19-12-03-vault-setup-skill-tldr.md

创建（默认操作）

不带参数调用 /tldr 时，主要执行此操作。

步骤 1 — 确认项目

询问用户：

这是哪个项目？

建议：{inferred project name from conversation context}

根据对话主题建议一个项目名称。用户确认或提供其他名称。将名称转换为 kebab-case，用于文件名。

步骤 2 — 总结

从对话中提取：

1. 完成的工作 — 已采取的具体操作、已更改的文件
2. 已做出的决策 — 设计选择、权衡、理由
3. 需要记住的要点 — 易忽略的问题、模式、不明显的细节
4. 后续操作 — 如有待完成事项

步骤 3 — 保存

使用当前时间，写入 01 - Projects/{project-name}/YYYY-MM-DD-HH-mm-{project-name}-tldr.md。

如果项目子文件夹不存在，则创建该文件夹。

模板：

---
created: YYYY-MM-DDTHH:mm
tags:
  - project/{project-name}
  - tldr
status: complete
---

# YYYY-MM-DD — {Project Name}

## What Was Done
[concrete actions, files changed]

## Decisions
[design choices with rationale]

## Key Things to Remember
[gotchas, patterns, non-obvious details]

## Next Actions
- [ ] [action items, if any]
- None — work is complete

步骤 4 — 更新记忆

读取库根目录中的 memory.md。追加任何新内容：

• 会话日志条目（一行：日期 + 项目 + 发生的事情）
• 会话中发现的偏好

不要重复已有条目。

读取

/tldr read {project-name}

在 01 - Projects/{project-name}/ 中搜索匹配 *-{project-name}-tldr.md 的文件。显示最新的一份（按文件名中的时间戳判断）。如果有多个文件，列出并询问要显示哪一个。

更新

/tldr update {project-name}

查找该项目最新的 tldr。读取文件。询问用户要添加或更改什么。编辑文件——追加新章节或修改现有章节。更新 updated frontmatter 字段。

删除

/tldr delete {project-name}

查找与项目名称匹配的 tldr。列出文件及日期。删除前询问确认：

要删除 01 - Projects/vault-setup-skill/2026-03-19-12-03-vault-setup-skill-tldr.md 吗？ 此操作无法撤销。

只有在用户明确回复“是”或“删除它”后才删除。

文件夹路由

默认目标位置为 01 - Projects/{project-name}/。但是，如果对话主题明显适合其他文件夹，则改用相应文件夹：

主题	目标位置	示例
项目工作（默认）	01 - Projects/{project-name}/	大多数会话
特定客户的工作	02 - Areas/{client-name}/	为特定客户开展的工作
研究 / 评估	03 - Resources/	工具评估、调查
通用 / 无项目	06 - Daily/	快速聊天、没有明确项目

路由到非项目文件夹时，文件名格式保持不变：YYYY-MM-DD-HH-mm-{topic}-tldr.md

故障排除

问题	原因	解决方法
项目文件夹不存在	这是该项目的第一份 tldr	写入文件前自动创建文件夹
库根目录中找不到 memory.md	文件尚未创建	创建文件，添加标题：# Memory，然后追加会话日志条目
同一天有多份 tldr	一天内进行了多个会话	每份文件名都使用唯一时间戳，因此不会冲突
无法确定库根目录	在库上下文之外调用了 Skill	询问用户库路径，或检查 CLAUDE.md 中的库位置

边缘情况

• 没有对话上下文：如果会话太短或内容过于简单，请询问用户要记录什么，而不是生成空的 tldr
• 项目名称不明确：如果用户提供的名称与多个文件夹匹配，请列出匹配项并询问用户要选哪一个
• 跳过删除确认：未经明确确认，绝不删除——如果用户的回复不是“yes”或“delete it”，就中止操作

平台说明

此技能适用于 macOS、Linux 和 Windows。知识库路径请使用正斜杠——Obsidian 会在不同平台间规范化路径。

---

注意事项

• 同一分钟内时间戳文件名冲突：YYYY-MM-DD-HH-mm- 精度意味着 60 秒内创建的两个 tldr 会相互覆盖。快速迭代时，请追加 -ss 秒，或在写入前检查文件是否已存在。
• **/tldr 不带参数时会根据“对话上下文”推断项目——通常不准确：**模型推断的名称可能是最近讨论的话题，而非实际项目。写入前务必向用户确认建议的名称——推断错误会产生孤立文件夹。
• **memory.md 只会不断追加，不会轮换：**多年的会话日志最终都会堆积在同一个文件中。请定期归档到 memory/YYYY-archive.md，否则文件会变成难以阅读的长篇内容。
• kebab-case 项目名称与现有文件夹冲突：vault-setup-skill 和 vault setup skill 都会转换成同一路径。系统会静默复用现有文件夹——如果用户想创建一个名称相近的新项目，就会造成混淆。
• **路由表会根据主题关键词匹配，而非用户意图：**会话中只要提到“research”，就会被路由到 03 - Resources/，即使内容实际是项目工作。写入前请确认目标文件夹，尤其是主题含糊时。
• **/tldr delete 会按 glob *-{project}-tldr.md 匹配：**名为 api 的项目会匹配 payment-api-tldr.md 和 internal-api-tldr.md。确认前请明确列出所有匹配项；绝不要根据部分名称匹配结果批量删除。