Slack Task Manager

Slack/Task Manager サブエージェント

Slack検索・TODO抽出・タスク管理を専用コンテキストで実行するサブエージェント。

目的

Slackデータとタスク管理をメインエージェントのコンテキストから分離し：

• 大量のSlackメッセージ検索を効率化
• 複数データソースからのタスク抽出を統合
• 検索結果のサマリーのみを返却

機能一覧

1. Slack検索 (tools/slack_search.py)

BookRAGに基づく階層的インデックスを活用したセマンティック検索。

機能

使用方法（Python）

pythonCopy code
from tools.slack_search import SlackSearch

search = SlackSearch()

# ワークスペース概要
overview = search.get_workspace_overview()

# チャンネル検索
results = search.find_channels("DX展示会")

# チャンネル詳細
detail = search.get_channel_detail("my-workspace/example-channel")

# 関連チャンネル
related = search.find_related_channels("my-workspace/example-channel")

# 人物検索
person = search.find_person("清水")

検索例

pythonCopy code
# プロジェクト関連のチャンネルを探す
results = search.find_channels("AIチュートリアル")

# 特定の人物が関わるチャンネル
person = search.find_person("田中")

2. TODO抽出 (skills/slack-todo-extractor/scripts/extract_todos.py)

Slackのメンションからタスクを抽出し、ステータス判定を行う。

使用方法

bashCopy code
# 基本（キーワードベース）
python skills/slack-todo-extractor/scripts/extract_todos.py \
  --users "YourName,your-username" \
  --period "2026-01-06:2026-01-08"

# LLMベース（高精度、要GEMINI_API_KEY）
python skills/slack-todo-extractor/scripts/extract_todos.py \
  --users "YourName,your-username" \
  --period "1/6:8" \
  --use-llm

# JSON出力
python skills/slack-todo-extractor/scripts/extract_todos.py \
  -u "YourName" -p "1/6:8" --use-llm -o json

パラメータ

ステータス判定

3. タスク抽出 (tools/extract_tasks.py)

複数のデータソースから自動的にタスクを抽出・優先順位付け。

データソース

使用方法

bashCopy code
# 全ソースからタスク抽出
uv run python tools/extract_tasks.py

# 特定ソースのみ
uv run python tools/extract_tasks.py --sources git,slack

# HowToDo生成付き
uv run python tools/extract_tasks.py --with-howtodo

# HTML出力
uv run python tools/extract_tasks.py --format html --output tasks.html

出力形式

yamlCopy code
tasks:
  - id: task_001
    source: slack
    title: "EASソリューションの調査"
    priority: high
    status: pending
    due_date: "2026-01-10"
    assignee: "YourName"
    channel: "my-workspace/team-core"

サブエージェント呼び出しパターン

メインエージェントは以下のパターンでこのサブエージェントを呼び出す：

pythonCopy code
Task(
    subagent_type="generalPurpose",
    model="fast",
    description="Slack search",
    prompt="""
    このスキルを読んで実行してください: skills/slack-task-manager/SKILL.md
    
    タスク: {ユーザーの指示}
    検索クエリ: {検索ワード}
    期間: {期間指定}
    
    検索結果のサマリーを返却してください。
    """
)

返却フォーマット

Slack検索結果

yamlCopy code
status: success
query: "DX展示会"
results:
  - channel: "my-workspace/example-event-2026"
    description: "2026年DX展示会の準備チャンネル"
    relevance: 0.95
    recent_activity: "2026-01-25"
  - channel: "my-workspace-2/example-project"
    description: "DXプロジェクト全般"
    relevance: 0.82
total_matches: 5

TODO抽出結果

yamlCopy code
status: success
period: "2026-01-06 ~ 2026-01-08"
summary:
  total: 12
  pending: 3
  in_progress: 5
  completed: 4
high_priority:
  - title: "EASソリューションの調査"
    from: "Sota Moriyama"
    channel: "my-workspace/team-core"
    status: pending

前提条件

• slack-sync/ のSlack同期が完了していること
• スレッド返信が必要な場合は事前に同期

bashCopy code
# Slack同期
python data/slack-sync/scripts/fetch_slack.py --workspace my-workspace

# スレッド返信も取得
python data/slack-sync/scripts/fetch_slack.py --workspace my-workspace --refresh-threads

依存関係

txtCopy code
python-dotenv>=1.0.0
google-generativeai>=0.3.0  # LLMモード使用時

環境変数

bashCopy code
# LLMモード使用時
GEMINI_API_KEY=your_api_key

Notion 連携は OAuth 統一です（環境変数は不要）。事前に /setup-notion を実行し、ncli login と Notion 公式 Hosted MCP（https://mcp.notion.com/mcp）をセットアップしてください。

ユースケース

1. チャンネル検索: プロジェクト関連のチャンネルを探す
2. TODO確認: 自分宛のメンションからタスクを抽出
3. タスク統合: 複数ソースからタスクを一覧化
4. 優先順位付け: 期限・重要度でタスクを整理