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:
parent
6f0dfdf243
commit
833e9d30fc
2 changed files with 211 additions and 12 deletions
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