김경종
240 lines
11 KiB
Markdown
240 lines
11 KiB
Markdown
---
|
||
name: wiki-digest
|
||
description: >
|
||
Generate a periodic knowledge digest — a human-readable newsletter-style summary of what was
|
||
learned, updated, and connected in your wiki over a specified period (day/week/month). Use when
|
||
the user says "what did I learn this week", "give me a digest", "weekly summary", "knowledge
|
||
report", "what's new in my wiki", "/wiki-digest [period]", "summarize my recent learning", or
|
||
wants a readable overview of recent wiki activity. Distinct from wiki-status (which reports
|
||
ingestion delta of sources) — wiki-digest summarizes *knowledge*, not sources.
|
||
---
|
||
|
||
# Wiki Digest — Knowledge Newsletter Generator
|
||
|
||
You are generating a human-readable digest of recent wiki activity: what was learned, what was updated, what themes are emerging, and what's worth reviewing. This skill summarizes *knowledge*, not sources — think of it as a weekly review session, not an ingestion status report.
|
||
|
||
## Before You Start
|
||
|
||
1. **Resolve config** — follow the Config Resolution Protocol in `llm-wiki/SKILL.md` (walk up CWD for `.env` → `~/.obsidian-wiki/config` → prompt setup). This gives `OBSIDIAN_VAULT_PATH` and `OBSIDIAN_LINK_FORMAT`.
|
||
2. **Parse the period** from the user's request:
|
||
- "daily" / "today" / "yesterday" → last 24 hours
|
||
- "weekly" / "this week" / no argument (default) → last 7 days
|
||
- "monthly" / "this month" → last 30 days
|
||
- ISO date like "since 2026-05-01" → pages updated since that date
|
||
- Explicit number like "last 14 days" → that many days
|
||
3. Read `$OBSIDIAN_VAULT_PATH/log.md` — last 200 lines — for entries within the period (timestamps are ISO-8601 prefixed lines).
|
||
4. Read `$OBSIDIAN_VAULT_PATH/hot.md` for current session context.
|
||
5. If `$OBSIDIAN_VAULT_PATH/_insights.md` exists, read its **Anchor Pages** table — you'll use it later to identify which new pages became hubs.
|
||
|
||
## Step 1: Collect Pages Active in the Period
|
||
|
||
Glob all `.md` files under `$OBSIDIAN_VAULT_PATH`. Skip special/system files:
|
||
- `index.md`, `log.md`, `hot.md`, `AGENTS.md`, `_insights.md`
|
||
- Anything under `_meta/`, `_archives/`, `_raw/`
|
||
- Journal digest pages themselves (`journal/digest-*.md`)
|
||
|
||
For each remaining page, read its frontmatter:
|
||
- `created` — when the page was first written
|
||
- `updated` — when it was last modified
|
||
|
||
Classify:
|
||
- **New pages**: `created` is within the period
|
||
- **Updated pages**: `updated` is within the period but `created` is before it
|
||
- **Unchanged**: neither date falls in the period → skip
|
||
|
||
If fewer than 5 pages were active, note it and offer to widen: *"Only 3 pages were active in the last 7 days — want a monthly digest instead?"* Stop here unless the user says to continue.
|
||
|
||
For each active page, collect: `title`, `category`, `tags`, `summary` (frontmatter field), `lifecycle`, any `^[ambiguous]` or `^[inferred]` markers in the body.
|
||
|
||
## Step 2: Identify Themes
|
||
|
||
From all active pages' tags, tally theme frequency:
|
||
|
||
```
|
||
For each tag across new + updated pages:
|
||
count how many active pages carry it
|
||
Sort descending, take top 5
|
||
```
|
||
|
||
Also read `$OBSIDIAN_VAULT_PATH/_meta/taxonomy.md` (if it exists). Flag any tag from step 1 that **does not appear** in the taxonomy — these are new vocabulary words that emerged this period.
|
||
|
||
Note which categories grew most (concepts/, entities/, skills/, synthesis/, references/, etc.).
|
||
|
||
## Step 3: Find Notable New Connections
|
||
|
||
Scan new and updated pages for cross-category wikilinks — links that bridge different knowledge layers. These are the most intellectually interesting outputs of the period.
|
||
|
||
For each active page, extract all `[[wikilink]]` targets. Classify each link by the target's category prefix. Flag links that cross categories (e.g., a `concepts/` page linking to an `entities/` page, or a `synthesis/` page bridging two topics).
|
||
|
||
Rank candidates by interestingness:
|
||
- **+3** if the link is across two categories that rarely connect (use `_insights.md` bridge data if available)
|
||
- **+2** if the target page is a top-10 hub (per `_insights.md` anchors)
|
||
- **+2** if the link appears in a `synthesis/` page (deliberate cross-cutting)
|
||
- **+1** if the source page is marked `^[inferred]` (synthesized connection, not directly stated)
|
||
|
||
Take the top 3–5 connections. Write each as a plain-English sentence: not just "A → B" but *why* the connection is interesting.
|
||
|
||
## Step 4: Surface Open Threads
|
||
|
||
Scan active pages and `_raw/` for unresolved work:
|
||
|
||
- **Drafts**: pages with `lifecycle: draft` or `lifecycle: stub`
|
||
- **Ambiguous claims**: count `^[ambiguous]` markers across all active pages (don't list every one — just the count and which pages have the most)
|
||
- **Unstaged notes**: count files in `$OBSIDIAN_VAULT_PATH/_raw/` (anything here hasn't been promoted)
|
||
- **Taxonomy gaps**: tags from Step 2 that aren't in `_meta/taxonomy.md`
|
||
|
||
## Step 5: Choose Recommended Re-reads
|
||
|
||
From the *existing* (pre-period) pages, identify 2–3 worth revisiting given this week's new context.
|
||
|
||
Heuristic: find pre-period pages that share the most tags with the active pages from Step 1. These are foundational pages whose topic was extended this period — the new pages build on them but the user may not have revisited the foundation.
|
||
|
||
Also include any pre-period page that now has 2+ new incoming links from active pages (it just became more connected — a sign it's load-bearing).
|
||
|
||
Write each recommendation with a concrete reason: *"[[concepts/attention-mechanism]] — your foundational page; three new papers ingested this week all extend it"*, not just the page title.
|
||
|
||
## Step 6: Generate the Digest
|
||
|
||
Produce a structured, scannable markdown report. The Headlines section is the most important — it should feel like the opening of a good newsletter, synthesizing actual insight rather than listing page names.
|
||
|
||
Apply the link format from `llm-wiki/SKILL.md` (Link Format section) using `OBSIDIAN_LINK_FORMAT`. Default is `[[wikilink]]`.
|
||
|
||
```markdown
|
||
# Wiki Digest — [Period Label]
|
||
> [N new pages · M updated pages · period: YYYY-MM-DD to YYYY-MM-DD]
|
||
|
||
## Headlines
|
||
|
||
- [Concrete insight #1 — synthesize the actual knowledge, not just "learned about X"]
|
||
- [Concrete insight #2]
|
||
- [Concrete insight #3]
|
||
|
||
## New Knowledge
|
||
|
||
### New pages ([count])
|
||
| Page | Category | Summary |
|
||
|---|---|---|
|
||
| [[concepts/foo]] | concept | One-sentence summary from frontmatter |
|
||
| [[entities/bar]] | entity | One-sentence summary |
|
||
|
||
### Notable updates ([count])
|
||
| Page | What changed |
|
||
|---|---|
|
||
| [[skills/react-hooks]] | Added patterns for useCallback with async effects |
|
||
|
||
*(If no updates, omit this subsection.)*
|
||
|
||
## Emerging Themes
|
||
|
||
- **#[tag]** ([N pages]) — [One sentence on why this topic was active]
|
||
- **#[tag]** ([N pages]) — [...]
|
||
- **#[NEW TAG]** ([N pages]) ⭐ *New vocabulary — not yet in taxonomy*
|
||
|
||
Most active category: **[category/]** ([N pages added or updated])
|
||
|
||
## Key Connections Made
|
||
|
||
- [[concepts/A]] → [[entities/B]] — [Plain-English reason this connection is interesting]
|
||
- [[synthesis/X]] created — bridges [[concepts/Y]] and [[concepts/Z]] for the first time
|
||
- *(up to 5 connections)*
|
||
|
||
## Open Threads
|
||
|
||
- **Drafts to compile** ([count]): [[concepts/foo]], [[concepts/bar]] — still in draft lifecycle
|
||
- **Ambiguous claims**: [N] `^[ambiguous]` markers across [M] pages — run `/wiki-synthesize` to resolve
|
||
- **Unstaged notes**: [N] files in `_raw/` — run `/wiki-ingest _raw/` to promote them
|
||
- **Taxonomy gaps**: Tags `#newtag1`, `#newtag2` used but not in taxonomy — run `/tag-taxonomy`
|
||
|
||
*(Omit any subsection where count is 0.)*
|
||
|
||
## Recommended Re-reads
|
||
|
||
- [[concepts/X]] — [Specific reason: "3 new papers this week all extend this concept"]
|
||
- [[synthesis/Y]] — [Specific reason: "2 new pages created this week reference it"]
|
||
- [[skills/Z]] — [Specific reason: "now has 4 new incoming links — it's become a hub"]
|
||
|
||
---
|
||
*Generated by wiki-digest · [TIMESTAMP] · [N pages scanned in [VAULT_PATH]]*
|
||
```
|
||
|
||
**Visibility**: If a page is tagged `visibility/pii`, exclude it from all tables and connection lists (but count it in the totals, noted as "+ N private"). If the user explicitly says "include private pages" or "full digest", include them normally.
|
||
|
||
## Step 7: Output & Optionally Save
|
||
|
||
**Default (chat output):** Print the digest directly. At the end, ask:
|
||
*"Want me to save this as `journal/digest-YYYY-MM-DD.md`?"*
|
||
|
||
**If user prefixed with "save" or "write"** (e.g., `/wiki-digest save` or "generate and save my weekly digest"):
|
||
- Write to `$OBSIDIAN_VAULT_PATH/journal/digest-YYYY-MM-DD.md` (weekly/monthly) or `journal/digest-YYYY-MM-DD-daily.md` (daily)
|
||
- Add frontmatter:
|
||
```yaml
|
||
---
|
||
title: "Wiki Digest — [Period Label]"
|
||
category: journal
|
||
tags: [digest, meta/review]
|
||
sources: []
|
||
created: TIMESTAMP
|
||
updated: TIMESTAMP
|
||
summary: "Weekly knowledge digest: [N new, M updated pages]. Top themes: [tag1], [tag2]."
|
||
---
|
||
```
|
||
- Update `index.md` with the new entry under Journal
|
||
- Do **not** add to `.manifest.json` (digests aren't source ingestions)
|
||
|
||
Either way, append to `log.md`:
|
||
```
|
||
- [TIMESTAMP] DIGEST period="7d" new_pages=N updated_pages=M themes=T connections=C saved=false
|
||
```
|
||
|
||
## Edge Cases
|
||
|
||
| Situation | Handling |
|
||
|---|---|
|
||
| Fewer than 5 active pages | Offer to widen the period; proceed only if user confirms |
|
||
| Empty vault (no pages at all) | Tell the user to run an ingest first; stop |
|
||
| No `_meta/taxonomy.md` | Skip taxonomy gap check; omit that line from Open Threads |
|
||
| No `_insights.md` | Skip hub-based scoring in Step 3; still produce connections section |
|
||
| All pages are `visibility/pii` | Report "N private pages active this period" with no details; offer full mode |
|
||
| Period spans a wiki rebuild | Note it in the digest: "Wiki was rebuilt during this period — page dates reflect post-rebuild state" |
|
||
|
||
## Notes
|
||
|
||
- **Headlines are the payoff.** Don't list page titles — synthesize the actual learning. If someone learned about attention mechanisms this week, the headline should capture the insight, not just say "added 3 transformer pages".
|
||
- **Be concrete about re-reads.** "This page is relevant" is useless. "3 of this week's papers all cite the same claim in this page" is actionable.
|
||
- **This skill only reads.** The only writes are the optional journal page, and the `log.md` append. It does not modify existing wiki pages.
|
||
- **Don't duplicate wiki-status.** If the user asks "what needs ingesting" or "what's the delta", route to `wiki-status`. This skill answers "what did I learn", not "what's pending".
|
||
|
||
## QMD Refresh After Vault Writes
|
||
|
||
QMD is a search index, not the source of truth. If `$QMD_WIKI_COLLECTION` is empty or unset, skip this step. Run it only after this skill has written or rewritten vault markdown. If QMD refresh fails, do not roll back the vault changes; report the QMD status separately.
|
||
|
||
Use `$QMD_CLI` if set; otherwise use `qmd`.
|
||
|
||
```bash
|
||
${QMD_CLI:-qmd} update
|
||
```
|
||
|
||
If the output says vectors are needed or embeddings may be stale, run:
|
||
|
||
```bash
|
||
${QMD_CLI:-qmd} embed
|
||
```
|
||
|
||
Verify the collection with either:
|
||
|
||
```bash
|
||
${QMD_CLI:-qmd} ls "$QMD_WIKI_COLLECTION"
|
||
```
|
||
|
||
or, when a specific page path is known:
|
||
|
||
```bash
|
||
${QMD_CLI:-qmd} get "qmd://$QMD_WIKI_COLLECTION/<page>.md" -l 5
|
||
```
|
||
|
||
Record one of:
|
||
- `QMD refreshed: update + embed + verified`
|
||
- `QMD refreshed: update only + verified`
|
||
- `QMD skipped: QMD_WIKI_COLLECTION unset`
|
||
- `QMD skipped: qmd CLI unavailable`
|
||
- `QMD failed: <short error summary>` |