docs: comprehensive Clips setup guide — /clip, Slack DM, X bookmarks
- Detailed setup instructions for all 3 clipping methods - Slack DM clip: agent auto-action config, skill files, behavior spec - X bookmark cron: schedule, xurl --auth oauth2 requirement - Dataview queries for tag-based browsing - Both EN and JP versions updated Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
Masahiro Chaen
parent
6f0dfdf243
commit
833e9d30fc
2 changed files with 211 additions and 12 deletions
115
README.md
115
README.md
|
|
@ -93,15 +93,57 @@ Updated automatically by Dreaming (morning + evening + weekly). Tracks patterns
|
|||
|
||||
## 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.
|
||||
Clips automatically captures tweets and articles into your vault. Like Karpathy's compounding knowledge pattern, everything you read accumulates and becomes searchable in Obsidian.
|
||||
|
||||
### 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/` |
|
||||
| Method | Trigger | Best for |
|
||||
|--------|---------|----------|
|
||||
| **`/clip` skill** | `/clip <URL>` in Claude Code | Working at your desk, high-quality summaries |
|
||||
| **Slack DM** | Post URL in Slack DM to your agent | On the go (phone), instant capture |
|
||||
| **X Bookmark Sync** | Automatic every 4 hours | Passive — just bookmark on X, it syncs |
|
||||
|
||||
### 1. `/clip` — Manual Clip in Claude Code
|
||||
|
||||
```
|
||||
/clip https://x.com/karpathy/status/1234567890
|
||||
/clip https://example.com/great-article
|
||||
/clip https://url1.com https://url2.com # multiple URLs
|
||||
```
|
||||
|
||||
Detects X tweet vs article automatically. Fetches content, generates summary + tags in Japanese, saves to `clips/`, updates daily note, and pushes to git.
|
||||
|
||||
### 2. Slack DM — Clip from Your Phone
|
||||
|
||||
Just send a URL to your agent's Slack DM:
|
||||
|
||||
```
|
||||
https://example.com/interesting-article
|
||||
```
|
||||
|
||||
The agent detects the URL, scrapes the content, generates a summary, saves to `clips/`, and replies in a thread:
|
||||
|
||||
```
|
||||
📎 Clipped!
|
||||
📄 How LLMs Will Change Everything
|
||||
🏷️ #ai #llm #future
|
||||
📁 vault/clips/articles/2026-04-08_llm-change-everything.md
|
||||
```
|
||||
|
||||
**Setup**: Requires an always-on agent (like [OpenClaw](https://openclaw.com)) with Slack Socket Mode. Add the URL detection behavior to your agent's auto-actions. See [Slack Clip Setup](#slack-clip-setup) below.
|
||||
|
||||
### 3. X Bookmark Auto-Sync
|
||||
|
||||
Bookmark tweets on X as you normally would. A cron job syncs them to your vault automatically.
|
||||
|
||||
**Default schedule**: Every 4 hours (8:00, 12:00, 16:00, 20:00)
|
||||
|
||||
**Requirements**: [xurl](https://github.com/twitterdev/xurl) CLI with OAuth2 authentication.
|
||||
|
||||
```bash
|
||||
# Test manually
|
||||
xurl bookmarks -n 5 --auth oauth2
|
||||
```
|
||||
|
||||
### Clip File Format
|
||||
|
||||
|
|
@ -113,6 +155,7 @@ source: x | article
|
|||
url: https://...
|
||||
author: "@username"
|
||||
tags: [ai, claude-code, agent]
|
||||
via: slack | cli | cron # how it was clipped
|
||||
---
|
||||
|
||||
## Summary
|
||||
|
|
@ -139,6 +182,66 @@ Each clip is automatically linked in the day's daily note:
|
|||
- [[clips/articles/2026-04-08_karpathy-llm-wiki]] — Karpathy LLM Wiki pattern
|
||||
```
|
||||
|
||||
### Dataview Queries
|
||||
|
||||
Browse clips by tag in Obsidian:
|
||||
|
||||
```dataview
|
||||
TABLE rows.date, rows.source, rows.author
|
||||
FROM "clips"
|
||||
WHERE type = "clip"
|
||||
FLATTEN tags as tag
|
||||
GROUP BY tag
|
||||
SORT rows.date DESC
|
||||
```
|
||||
|
||||
### Slack Clip Setup
|
||||
|
||||
To enable Slack DM → clip, add this auto-action to your agent:
|
||||
|
||||
1. **Create skill files** in your agent's workspace:
|
||||
|
||||
```
|
||||
workspace/skills/slack-clip/
|
||||
├── SKILL.md ← Skill overview
|
||||
├── BEHAVIOR.md ← Detection rules + processing flow
|
||||
└── processed-clips.json ← Deduplication tracking
|
||||
```
|
||||
|
||||
2. **Add auto-action** to your agent's config (e.g., `AGENTS.md`):
|
||||
|
||||
```markdown
|
||||
### URL投稿 → Vaultクリップ
|
||||
DM にURLを含むメッセージが来たら自動でvault/clips/に保存。
|
||||
|
||||
検知方法:
|
||||
- メッセージテキストに https:// を含む（転送メッセージは除外）
|
||||
- Slack内部URL、画像直リンクは除外
|
||||
|
||||
処理:
|
||||
1. URL種別判定（X tweet vs 記事）
|
||||
2. X tweet → xurl read / 記事 → firecrawl scrape
|
||||
3. 要約・タグ生成 → vault/clips/ に保存
|
||||
4. git push + スレッド返信で確認
|
||||
```
|
||||
|
||||
3. **Ensure tools are available** to the agent:
|
||||
- `xurl` (X API CLI) with OAuth2 auth
|
||||
- `firecrawl` (web scraping CLI)
|
||||
- Git access to your vault repo
|
||||
|
||||
### X Bookmark Cron Setup
|
||||
|
||||
Add a cron job to your agent scheduler:
|
||||
|
||||
```json
|
||||
{
|
||||
"name": "clip-x-bookmarks",
|
||||
"schedule": "0 8-23/4 * * *",
|
||||
"message": "Fetch X bookmarks with `xurl bookmarks -n 20 --auth oauth2`, check for duplicates in vault/clips/x/, summarize new ones, save to vault/clips/x/, update _index.md, git push."
|
||||
}
|
||||
```
|
||||
|
||||
## Architecture
|
||||
|
||||
```
|
||||
|
|
|
|||
108
README_JP.md
108
README_JP.md
|
|
@ -80,15 +80,57 @@ Dreaming（朝夕+週次）が自動更新。時間とともに浮かび上が
|
|||
|
||||
## Clips — ナレッジクリッピング
|
||||
|
||||
ツイートや記事を自動でvaultに蓄積。Karpathyの「知識が複利で増える」パターンで、読んだもの全てが検索可能に。
|
||||
ツイートや記事を自動でvaultに蓄積。Karpathyの「知識が複利で増える」パターンで、読んだもの全てがObsidianで検索可能に。
|
||||
|
||||
### 3つの取り込み方法
|
||||
|
||||
| 方法 | トリガー | 動作 |
|
||||
|------|---------|------|
|
||||
| **`/clip` スキル** | `/clip <URL>` | Xツイート vs 記事を判定→内容取得→要約+タグ→`clips/`に保存 |
|
||||
| **Xブックマーク自動同期** | 毎日22:00 cron | `xurl`で昨日のブックマークを取得→要約→`clips/x/`に保存 |
|
||||
| **Slack/Discord経由** | チャンネルにURL投稿 | 外部エージェントが処理→`clips/articles/`に保存 |
|
||||
| 方法 | トリガー | 最適な場面 |
|
||||
|------|---------|-----------|
|
||||
| **`/clip` スキル** | Claude Codeで `/clip <URL>` | デスクワーク中、高品質な要約 |
|
||||
| **Slack DM** | エージェントのDMにURL投稿 | 外出先（スマホ）、即座にキャプチャ |
|
||||
| **Xブックマーク自動同期** | 4時間おきに自動 | パッシブ — Xでブックマークするだけ |
|
||||
|
||||
### 1. `/clip` — Claude Codeで手動クリップ
|
||||
|
||||
```
|
||||
/clip https://x.com/karpathy/status/1234567890
|
||||
/clip https://example.com/great-article
|
||||
/clip https://url1.com https://url2.com # 複数URL対応
|
||||
```
|
||||
|
||||
X tweet vs 記事を自動判定。内容取得→要約・タグ生成→`clips/`保存→daily note追記→git push。
|
||||
|
||||
### 2. Slack DM — スマホからクリップ
|
||||
|
||||
エージェントのSlack DMにURLを送るだけ:
|
||||
|
||||
```
|
||||
https://example.com/interesting-article
|
||||
```
|
||||
|
||||
エージェントがURLを検知→スクレイピング→要約→`clips/`保存→スレッド返信:
|
||||
|
||||
```
|
||||
📎 クリップしました！
|
||||
📄 LLMが全てを変える方法
|
||||
🏷️ #ai #llm #future
|
||||
📁 vault/clips/articles/2026-04-08_llm-change-everything.md
|
||||
```
|
||||
|
||||
**セットアップ**: 常時稼働エージェント（[OpenClaw](https://openclaw.com)等）+ Slack Socket Modeが必要。詳細は[Slack Clipセットアップ](#slack-clipセットアップ)参照。
|
||||
|
||||
### 3. Xブックマーク自動同期
|
||||
|
||||
普段どおりXでツイートをブックマークするだけ。cronジョブが自動でvaultに同期。
|
||||
|
||||
**デフォルトスケジュール**: 4時間おき（8:00, 12:00, 16:00, 20:00）
|
||||
|
||||
**必要なもの**: [xurl](https://github.com/twitterdev/xurl) CLI + OAuth2認証
|
||||
|
||||
```bash
|
||||
# 手動テスト
|
||||
xurl bookmarks -n 5 --auth oauth2
|
||||
```
|
||||
|
||||
### クリップファイルのフォーマット
|
||||
|
||||
|
|
@ -100,6 +142,7 @@ source: x | article
|
|||
url: https://...
|
||||
author: "@username"
|
||||
tags: [ai, claude-code, agent]
|
||||
via: slack | cli | cron
|
||||
---
|
||||
|
||||
## 要約
|
||||
|
|
@ -126,6 +169,59 @@ tags: [ai, claude-code, agent]
|
|||
- [[clips/articles/2026-04-08_karpathy-llm-wiki]] — Karpathy LLM Wikiパターン
|
||||
```
|
||||
|
||||
### Dataviewクエリ
|
||||
|
||||
Obsidianでタグ別にクリップを閲覧:
|
||||
|
||||
```dataview
|
||||
TABLE rows.date, rows.source, rows.author
|
||||
FROM "clips"
|
||||
WHERE type = "clip"
|
||||
FLATTEN tags as tag
|
||||
GROUP BY tag
|
||||
SORT rows.date DESC
|
||||
```
|
||||
|
||||
### Slack Clipセットアップ
|
||||
|
||||
Slack DM → clip を有効にする手順:
|
||||
|
||||
1. **スキルファイル作成** — エージェントのワークスペースに:
|
||||
|
||||
```
|
||||
workspace/skills/slack-clip/
|
||||
├── SKILL.md ← スキル概要
|
||||
├── BEHAVIOR.md ← 検知ルール + 処理フロー
|
||||
└── processed-clips.json ← 重複防止トラッキング
|
||||
```
|
||||
|
||||
2. **自動アクション追加** — エージェントの設定（`AGENTS.md`等）に:
|
||||
|
||||
```markdown
|
||||
### URL投稿 → Vaultクリップ
|
||||
DMにURLを含むメッセージが来たら自動でvault/clips/に保存。
|
||||
|
||||
検知: https:// を含む（転送メッセージ・Slack内部URL・画像直リンクは除外）
|
||||
処理: URL判定 → 取得 → 要約・タグ → vault保存 → git push → スレッド返信
|
||||
```
|
||||
|
||||
3. **ツール確認** — エージェントが以下にアクセスできること:
|
||||
- `xurl`（X API CLI）+ OAuth2認証
|
||||
- `firecrawl`（Webスクレイピング CLI）
|
||||
- vault リポジトリへのgitアクセス
|
||||
|
||||
### Xブックマークcronセットアップ
|
||||
|
||||
エージェントスケジューラにcronジョブを追加:
|
||||
|
||||
```json
|
||||
{
|
||||
"name": "clip-x-bookmarks",
|
||||
"schedule": "0 8-23/4 * * *",
|
||||
"message": "xurl bookmarks -n 20 --auth oauth2 でブックマーク取得、vault/clips/x/ と重複チェック、新規を要約して保存、_index.md更新、git push"
|
||||
}
|
||||
```
|
||||
|
||||
## アーキテクチャ
|
||||
|
||||
```
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue