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 — プロジェクトを特定する

ユーザーに尋ねます。

これはどのプロジェクト用ですか？

候補：{conversation contextから推測したプロジェクト名}

会話のトピックからプロジェクト名を提案します。ユーザーに確認するか、別の名前を指定してもらいます。ファイル名にはケバブケースを使用します。

ステップ 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 を読みます。新しい項目があれば追記します。

• セッションログのエントリー（1 行：日付 + プロジェクト + 起きたこと）
• セッション中にわかったユーザーの好み

既存のエントリーと重複させないでください。

読み取り

/tldr read {project-name}

01 - Projects/{project-name}/ で *-{project-name}-tldr.md に一致するファイルを検索します。ファイル名のタイムスタンプに基づいて、最も新しいものを表示します。複数ある場合は一覧を表示し、どれを表示するか尋ねます。

更新

/tldr update {project-name}

プロジェクトの最新の tldr を見つけて読みます。追加または変更する内容をユーザーに尋ねます。ファイルを編集し、新しいセクションを追記するか、既存のセクションを修正します。updated のフロントマター欄も更新します。

削除

/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 が複数ある	1 日に複数のセッションがある	ファイル名に異なるタイムスタンプを付けるため、競合しません
ボルトのルートを特定できない	ボルトのコンテキスト外でスキルが呼び出された	ユーザーにボルトのパスを尋ねるか、ボルトの場所を CLAUDE.md で確認します

エッジケース

• 会話のコンテキストがない場合：セッションが短すぎる、または内容がごくわずかな場合は、空の tldr を生成するのではなく、何を記録するかユーザーに尋ねます
• プロジェクト名が曖昧な場合：ユーザーが複数のフォルダーに一致する名前を指定した場合は、一致する項目を列挙して、どれを指しているのか尋ねます
• 削除の確認が省略された場合：明示的な確認なしに削除してはいけません。「yes」または「delete it」以外のことをユーザーが言った場合は、中止します

プラットフォームに関する注意事項

このスキルは macOS、Linux、Windows で動作します。Obsidian はプラットフォーム間でパスを正規化するため、vault のパスにはスラッシュを使用します。

---

注意点

• 同じ分内でのタイムスタンプ付きファイル名の衝突：YYYY-MM-DD-HH-mm- の精度では、60 秒以内に作成された 2 つの tldr は互いに上書きされます。短時間に繰り返し作成する場合は、秒を表す -ss を追加するか、書き込む前にファイルの存在を確認します。
• 引数なしの /tldr は「会話のコンテキスト」からプロジェクトを推測しますが、間違っていることがよくあります：モデルが推測した名前は、実際のプロジェクトではなく、直近に話したトピックの場合があります。誤った推測によって孤立したフォルダーが作成されるため、書き込む前に必ず提案された名前をユーザーに確認します。
• memory.md への追記には上限がなく、ローテーションされずに増え続けます：何年分ものセッションログが 1 つのファイルに蓄積されます。定期的に memory/YYYY-archive.md にアーカイブしてください。そうしないと、ファイルが読み込みに時間のかかる長大なテキストになります。
• ケバブケースのプロジェクト名が既存のフォルダーと競合する場合：vault-setup-skill と vault setup skill は、どちらもケバブケースにすると同じパスになります。既存のフォルダーが黙って再利用されるため、ユーザーが似た名前で新しいプロジェクトを作成するつもりだった場合、混乱を招きます。
• ルーティングテーブルはユーザーの意図ではなく、トピックのキーワード一致で動作します：「research」に言及したセッションは、実際のプロジェクト作業であっても 03 - Resources/ に振り分けられます。特に曖昧なトピックでは、書き込む前に保存先フォルダーを確認します。
• /tldr delete は glob *-{project}-tldr.md で一致を判定します：プロジェクト名が api の場合、payment-api-tldr.md と internal-api-tldr.md に一致します。確認を求める前に、一致する項目をすべて明示的に列挙してください。名前の一部だけが一致する項目をまとめて削除してはいけません。