x-read

X の読み取り（ダイジェスト作成と返信の提案）

このスキルの役割

このスキルには 2 つのユースケースがある。どちらも読み取り専用で、投稿・返信・引用・いいね・リポストは行わない（書き込みは x-post スキルの領分）。結果は実行結果としてそのまま返す（Slack などの外部サービスへは送らない）。

1. ダイジェスト作成（既定）：タイムライン（ホーム／最近検索）を取得し、技術・ビジネスの観点で価値のある話題を選んで要約ダイジェストを作る。
2. 返信の提案：指定されたアカウント（1 つでも複数でもよい）のタイムライン、または指定されたポストを読み、返信する価値のあるポストを選んで返信の下書きを提案する。提案するだけで、このスキルからは返信を投稿しない。

議論の経緯と争点を追う依頼は x-discussion スキルの領分。ある話題やアカウントについて「何がどう主張され、どう批判され、どこが未解決か」を時系列と論点で整理し、Slack へ還元するのはそちらを使う。このスキルが扱うのは、ダイジェストと返信案までである。

実行環境の注意

• rg は利用できません。探索には find / grep / tail / sed などの標準的なコマンドを使う。必要な確認は、この SKILL.md に書かれた具体的なコマンドを優先する。

取得モードの使い分け

fetch_timeline.py にはタイムライン系の 3 モード（home / search / user）と、単一ポスト取得の post モードがある。目的が違うので、実行のたびにどれを使うかを選ぶ。

	home（ホームタイムライン）	search（最近検索）	user（特定アカウント）
何が取れるか	フォロー中アカウントの最新投稿（逆時系列）	直近 7 日の公開ポスト全体からキーワード・ハッシュタグに一致するもの	指定アカウントの最新の元投稿
フォロー外の投稿	含まれない	含まれる	指定したアカウント次第
向いている目的	いつものフォロー圏の動向把握（定点観測）	特定テーマの新しい会話・書き手の発見（守備範囲の拡張）	返信の提案（そのアカウントの文脈を把握する）
必須の引数	なし	--query "<検索クエリ>"	--user <ユーザー名>（繰り返し指定で複数アカウント可）
API	GET /2/users/:id/timelines/reverse_chronological	GET /2/tweets/search/recent	GET /2/users/:id/tweets

使い分けの目安：定例のダイジェスト作成は home を基本とし、追いかけたいテーマが決まっているときに search を足す。user は返信提案のユースケース専用。

このほか、タイムラインではなく単一ポストの取得モードとして post がある：

• python3 {baseDir}/scripts/fetch_timeline.py --mode post --id <ポストID>（--id の繰り返しで複数可）
• ポスト ID だけで対象を特定できる。返信先・引用元があれば in_reply_to / quoted フィールドに入れ子で含まれるので、会話の文脈を踏まえられる。
• ID で明示指定されたものをそのまま返すため、他モードの除外フィルタと --limit は適用されない。削除済み・非公開の ID は stderr に not available と出る。

タイムライン系モード（home / search / user）共通の仕様

• 出力は 1 行 1 件の JSON（id, author, name, text, created_at, likes, reposts）で、新しい順。
• 次の 4 つは、情報があるときだけ足される（ダイジェスト用途では無視してよい）。
  • conversation_id：そのポストが属する会話の根。返信のときだけ出る（元投稿では自分自身なので省かれる）。
  • urls：本文中の t.co を展開した URL。自分自身を指すもの（画像や長文の続きへの内部リンク）は除いてある。
  • media：添付された画像・動画の type と url、alt_text があれば alt_text。
  • edit_history：編集されたポストのみ。古い順の ID 一覧で、最後が現行版。
• text は長文ポスト（280 字超）でも全文が入る。
• リツイート・自分の投稿・引用の入れ子は除外済み。返信は home / user では自動除外、search ではクエリに -is:reply を書いたときだけ除外される。
• --include-replies（user モードのみ）で返信を除外しない。--raw で自分の投稿と引用の除外をやめる。どちらも既定は off なので、ダイジェスト作成と返信の提案では使わない。
• API からは常に 1 ページ（最大 100 件）取得し、フィルタ後に --limit 件（既定 30、上限 100）まで出力する。user モードで複数アカウントを指定した場合、--limit はアカウントごとに適用される（投稿頻度が低いアカウントが多いアカウントに埋もれないようにするため）。
• API 消費：home / search は 1 リクエスト。user はユーザー名の一括解決 1 リクエスト + アカウント数分のリクエスト。