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 2026-04-08 21:13:03 +09:00
parent 6f0dfdf243
commit 833e9d30fc
2 changed files with 211 additions and 12 deletions

View file

@ -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"
}
```
## アーキテクチャ
```