spark-recipe-topic-timeline

レシピ：トピックの時系列

特定のプロジェクトやトピックについて、会議での議論とメールのスレッドを織り交ぜ、ひとつの時系列のストーリーを作成します。状況の把握、新しいメンバーへの説明、ステータス報告の準備に役立ちます。

前提条件： コマンドの参照方法とフィルター構文について、use-spark の基本スキルを読んでください。

必要なアクセスレベル： 読み取り専用。

手順

手順 1：対象範囲を決める

ユーザーに次の内容を尋ねます。

• トピックまたはプロジェクト名（検索キーワード）
• 期間（指定がない場合は直近 30 日間）

手順 2：会議データを収集する

spark meetings --filter "subject:topic-keyword newer_than:30d"

件名フィルターで関連する会議を見つけられない場合は、検索範囲を広げます。

spark meetings --filter "newer_than:30d"

関連する会議ごとに、概要を読みます。

spark meeting <id>

トピックが主要な議題だった会議に限り、詳細をすべて取得します。

spark meeting <id> --transcript --notes

次の情報を記録します：日付、参加者、トピックに関連する要点。

手順 3：メールデータを収集する

spark search "topic keyword"

明らかに関連性のあるスレッドについて、会話の内容をすべて読みます。

spark thread <id>

トピックに関係する特定の人物がいる場合は、その人のスレッドも取得します。

spark emails --filter "from:[email protected] subject:keyword newer_than:30d"

次の情報を記録します：各メッセージの日付、参加者、内容。

手順 4：時系列にまとめる

会議とメールのすべての項目をまとめ、日付順に並べます。各項目には次の情報を含めます。

• 日付
• チャネル： 会議／メール
• 参加者
• 内容： 要点をまとめた 1～2 文

手順 5：時系列に注釈を加える

編集者の注釈を追加します。

• 方向性が変わった転換点を示す
• 結論が出ていない未解決の話題を示す
• 進展が停滞している可能性を示す、活動のない期間を記録する

手順 6：時系列を提示する

まず、トピックの現状をまとめた段落を 1 つ提示し、その後、古い順に時系列全体を示します。最後に次の内容を記載します。

• 現在の状況： 最新の既知の状態
• 未解決事項： まだ解決していない項目
• 次の接点： トピックの進展につながる予定の会議、または返信待ちのメール

ヒント

• spark search は関連度順に並べ替え、本文全体を返すため、メールの検索を始めるのに最適です。
• 通常、会議の概要でトピックを十分に把握できます。正確な引用や発言者の特定が必要な会議に限り、--transcript を使用してください。
• 数か月にわたるトピックの場合は、出力が膨大にならないよう、月ごとなどに分けて作業してください。
• recipe-decision-tracker と組み合わせて使うと便利です。決定事項だけが必要な場合はそちらを使い、ストーリー全体が必要な場合はこちらを使ってください。
• 他の人のために作成する場合（新しいチームメンバーへのオンボーディングなど）、部外者には分からない前提知識も明記してください。