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) <noreply@anthropic.com>
This commit is contained in:
Masahiro Chaen
parent
768a3d3ec4
commit
6f0dfdf243
2 changed files with 110 additions and 0 deletions
55
README.md
55
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 <URL>` 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).
|
||||
|
||||
|
|
|
|||
55
README_JP.md
55
README_JP.md
|
|
@ -78,6 +78,54 @@ Dreaming（朝夕+週次）が自動更新。時間とともに浮かび上が
|
|||
- Q1: スキル26個構築、cronジョブ32本稼働
|
||||
```
|
||||
|
||||
## Clips — ナレッジクリッピング
|
||||
|
||||
ツイートや記事を自動でvaultに蓄積。Karpathyの「知識が複利で増える」パターンで、読んだもの全てが検索可能に。
|
||||
|
||||
### 3つの取り込み方法
|
||||
|
||||
| 方法 | トリガー | 動作 |
|
||||
|------|---------|------|
|
||||
| **`/clip` スキル** | `/clip <URL>` | 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ロック、インジェクション対策）。
|
||||
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue