search-messages

Telegram メッセージを検索

すべてのチャット、または特定のチャット内のメッセージを検索します。

自己進化型スキル：このスキルは使用するたびに改善されます。指示が誤っていた場合、パラメーターに変更があった場合、または回避策が必要だった場合は、後回しにせず、すぐにこのファイルを修正してください。実際に再現可能な問題のみ更新してください。

事前確認

1. セッションが存在する必要があります：~/.local/share/gramjs/<profile>.session
   • 存在しない場合は、先に /tlg:setup を実行してください

使用方法

/usr/bin/env bash << 'EOF'
ROOT="$(cc-plugin-root tlg)"
SCRIPT="$ROOT/scripts/tg-cli.ts"

# Global search (all chats)
bun "$SCRIPT" search "search term" -n 20

# Search in specific chat
bun "$SCRIPT" search "keyword" --chat 2124832490

# Filter by sender
bun "$SCRIPT" search "topic" --from @username

# Combined: search in chat from specific sender
bun "$SCRIPT" search "query" --chat @groupname --from @sender -n 10
EOF

パラメーター

パラメーター	型	説明
query	string	検索テキスト（必須）
--chat	string/int	特定のチャットに限定します（全チャットを検索する場合は省略）
--from	string/int	送信者で絞り込みます
-n/--limit	int	結果の最大件数（デフォルト：20）
--preview	int	各本文を N 文字に切り詰めます（デフォルト：全文、複数行でインデント表示）。

出力形式

デフォルト（全文、複数行でインデント表示）：

[YYYY-MM-DD HH:MM] [Chat Name] (id:12345) Sender: First line of body
    continuation line 1 (indented under header)
    continuation line 2

--preview 100 の場合：

[YYYY-MM-DD HH:MM] [Chat Name] (id:12345) Sender: First line of body ⏎ continuation collapsed onto…

メッセージごとに 1 行で表示したい大量の結果をスキャンする場合に限り、--preview N を使用してください。デフォルトでは全文が表示されます。長い本文が 150 文字で暗黙のうちに切り詰められることはなくなりました（以前のデフォルトでは、内容が重要な場合に手動で回避する必要がありました）。

避けるべきパターン

• 大量リクエストのリスク：よく使われる語句で全チャットを検索すると、レート制限に達する可能性があります（10 リクエストごとに約 30 秒の待機）
• 結果が空：全チャット検索には空でないクエリー文字列が必要です

実行後の振り返り

このスキルの実行後、終了する前に次の点を確認してください。

1. コマンドは成功しましたか？ — 失敗した場合は、原因となった指示またはエラーテーブルを修正してください。
2. パラメーターや出力に変更はありましたか？ — tg-cli.ts のインターフェースに変更があった場合は、使用例とパラメーターテーブルを一致するよう更新してください。
3. 回避策が必要でしたか？ — 別のフラグや追加手順など、即興で対応した場合は、次回同じ回避策が不要になるよう、この SKILL.md を更新してください。

問題が実際に再現可能な場合のみ更新してください。推測に基づく更新は行わないでください。