From 6f0dfdf2437c661d25c128aa2ae51781176c90c1 Mon Sep 17 00:00:00 2001 From: Masahiro Chaen Date: Wed, 8 Apr 2026 19:43:12 +0900 Subject: [PATCH] docs: add Clips feature section to README Add documentation for the new Clips knowledge clipping feature: - /clip skill for manual clipping (X tweets + articles) - X bookmark auto-sync (daily cron at 22:00) - Slack/Discord integration - Clip file format and daily note integration - sync-x-bookmarks.sh script reference Co-Authored-By: Claude Opus 4.6 (1M context) --- README.md | 55 ++++++++++++++++++++++++++++++++++++++++++++++++++++ README_JP.md | 55 ++++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 110 insertions(+) diff --git a/README.md b/README.md index 8c69348..ccd76fb 100644 --- a/README.md +++ b/README.md @@ -91,6 +91,54 @@ Updated automatically by Dreaming (morning + evening + weekly). Tracks patterns - Should CC Memory duplicates be consolidated? ``` +## Clips — Knowledge Clipping + +Clips automatically captures tweets and articles into your vault. Like Karpathy's compounding knowledge pattern, everything you read accumulates and becomes searchable. + +### Three Ways to Clip + +| Method | Trigger | How it works | +|--------|---------|--------------| +| **`/clip` skill** | `/clip ` in Claude Code | Detects X tweet vs article, fetches content, generates summary + tags, saves to `clips/` | +| **X Bookmark Sync** | Daily cron (22:00) | Auto-fetches yesterday's X bookmarks via `xurl`, summarizes, saves to `clips/x/` | +| **Slack/Discord** | Post URL in channel | External agent picks up URL, scrapes, saves to `clips/articles/` | + +### Clip File Format + +```markdown +--- +date: 2026-04-08 +type: clip +source: x | article +url: https://... +author: "@username" +tags: [ai, claude-code, agent] +--- + +## Summary +(3-5 line summary in your language) + +## Key Points +- Point 1 +- Point 2 + +## Notes +> Important quotes + +## Related +[[insights/...]] | [[clips/...]] +``` + +### Daily Note Integration + +Each clip is automatically linked in the day's daily note: + +```markdown +## Clips +- [[clips/x/2026-04-08_sam-altman-social-contract]] — Sam Altman's social contract +- [[clips/articles/2026-04-08_karpathy-llm-wiki]] — Karpathy LLM Wiki pattern +``` + ## Architecture ``` @@ -165,6 +213,12 @@ Updated automatically by Dreaming (morning + evening + weekly). Tracks patterns │ ├── project/ Project statuses │ └── user/ User profile │ +├── clips/ ← Clipped tweets & articles (auto + manual) +│ ├── x/ X bookmarks (auto-synced daily at 22:00) +│ ├── articles/ Web articles (via /clip or Slack) +│ ├── _index.md Clip index (auto-updated) +│ └── tags.md Tag-based classification (Dataview) +│ ├── clients/ ← Client knowledge (Karpathy pattern) ├── meetings/ ← Meeting summaries (auto from /auto-minutes) ├── decisions/ ← Decision log @@ -316,6 +370,7 @@ score: 74 | `weekly-sync.sh` | Weekly lint: broken links, orphan pages, stale content | | `git-pull-sync.sh` | Hourly git pull with stash handling | | `sync-agent-to-vault.sh` | Enriches daily notes from external agent JSON data | +| `sync-x-bookmarks.sh` | Auto-fetches X bookmarks + clips (cron 22:00) | All scripts are macOS-compatible (no GNU extensions), reviewed for security (no shell injection, PID-based locking instead of flock). diff --git a/README_JP.md b/README_JP.md index fe93e2b..6306968 100644 --- a/README_JP.md +++ b/README_JP.md @@ -78,6 +78,54 @@ Dreaming（朝夕+週次）が自動更新。時間とともに浮かび上が - Q1: スキル26個構築、cronジョブ32本稼働 ``` +## Clips — ナレッジクリッピング + +ツイートや記事を自動でvaultに蓄積。Karpathyの「知識が複利で増える」パターンで、読んだもの全てが検索可能に。 + +### 3つの取り込み方法 + +| 方法 | トリガー | 動作 | +|------|---------|------| +| **`/clip` スキル** | `/clip ` | Xツイート vs 記事を判定→内容取得→要約+タグ→`clips/`に保存 | +| **Xブックマーク自動同期** | 毎日22:00 cron | `xurl`で昨日のブックマークを取得→要約→`clips/x/`に保存 | +| **Slack/Discord経由** | チャンネルにURL投稿 | 外部エージェントが処理→`clips/articles/`に保存 | + +### クリップファイルのフォーマット + +```markdown +--- +date: 2026-04-08 +type: clip +source: x | article +url: https://... +author: "@username" +tags: [ai, claude-code, agent] +--- + +## 要約 +（3-5行の日本語要約） + +## キーポイント +- ポイント1 +- ポイント2 + +## 原文メモ +> 重要な引用 + +## 関連 +[[insights/...]] | [[clips/...]] +``` + +### daily noteへの自動連携 + +クリップするたびに、その日のdaily noteに自動追記: + +```markdown +## Clips +- [[clips/x/2026-04-08_sam-altman-social-contract]] — Sam Altmanのsocial contract +- [[clips/articles/2026-04-08_karpathy-llm-wiki]] — Karpathy LLM Wikiパターン +``` + ## アーキテクチャ ``` @@ -157,6 +205,12 @@ vault/ ├── system/ ← Claude Codeシステムミラー（SYNCED） ├── skills/ ← スキル一覧+個別ページ（SYNCED） ├── memory/ ← CC Memory個別ファイルミラー（SYNCED） +├── clips/ ← ツイート・記事のクリッピング（自動+手動） +│ ├── x/ Xブックマーク（毎日22:00自動同期） +│ ├── articles/ Web記事（/clip or Slack経由） +│ ├── _index.md クリップ一覧（自動更新） +│ └── tags.md タグ別分類（Dataview対応） +│ ├── clients/ ← 顧客ナレッジ蓄積（Karpathyパターン） ├── meetings/ ← 議事録要点 ├── decisions/ ← 経営判断ログ @@ -248,6 +302,7 @@ gh repo create my-vault --private --source=. --push | `weekly-sync.sh` | 週次Lint: 壊れたリンク・孤立ページ・古いページ検出 | | `git-pull-sync.sh` | 毎時git pull（stash対応） | | `sync-agent-to-vault.sh` | 外部エージェントのJSONデータでdaily note充実化 | +| `sync-x-bookmarks.sh` | Xブックマーク自動取得+クリップ（cron 22:00） | 全スクリプトmacOS互換（GNU拡張なし）、セキュリティレビュー済み（PIDロック、インジェクション対策）。