Slack 通知管理 - 未読確認、既読化、メンション確認・返信、プロフィール更新を提供

version
4.1.3
GitHub stars
7

Install

/plugin install shiiman-slack@shiiman-claude-code-plugins

Run it inside Claude Code after adding the marketplace with /plugin marketplace add shiiman/claude-code-plugins.

Contents

Discovered from source

Skills 6

Mention Checker

Slack で自分へのメンションを確認します。

Help

$ARGUMENTS に --help が含まれる場合、以下を表示して終了:

/shiiman-slack:mention-check - Mention Checker

概要:
  Slack で自分へのメンションを確認します。

使用方法:
  /shiiman-slack:mention-check [オプション]

オプション:
  --help  このヘルプを表示

トリガー

  • 「メンション確認」
  • 「Slackメンション」
  • 「自分へのメンション」
  • 「@mention を見せて」
  • 「メンション一覧」

動作

  1. Pythonスクリプト slack_message.py mentions を実行
  2. 自分へのメンションを検索
  3. メンション一覧を整理して表示
  4. 返信するか確認する(mention-reply で返信できます)

実装

# Pythonスクリプトでメンション取得
python ${CLAUDE_PLUGIN_ROOT}/scripts/slack_message.py --format table mentions \
  --max 20

出力例

# あなたへのメンション(直近20件)

メンション数: 5

channel         user        text                                    permalink
general         山田太郎    @you レビューお願いします               https://...
project-alpha   佐藤花子    @you 資料確認しました                   https://...
dev-team        田中一郎    @you バグ修正完了です                   https://...
random          木村さん    @you 明日の予定どうですか?             https://...
marketing       鈴木次郎    @you 新しい企画について相談したいです   https://...

機能

  • 検索: Slack Search APIで <@USER_ID> を検索
  • 最大件数: デフォルト20件、--max で変更可能
  • パーマリンク: 各メンションへの直接リンクを表示
  • チャンネル名: メンションがあったチャンネルを表示

トークン設定

/shiiman-slack:user-setup でトークンを設定してください。

必要なスコープ

  • search:read - メッセージ検索
  • users:read - 自分のユーザーID取得

注意事項

  • Slack Search APIは検索履歴の制限があります(フリープランでは直近10,000メッセージ)
  • パーマリンクをクリックすると、該当メッセージに直接ジャンプできます

Mention Replier

Slack でメンションに対してスレッド返信します。

Help

$ARGUMENTS に --help が含まれる場合、以下を表示して終了:

/shiiman-slack:mention-reply - Mention Replier

概要:
  Slack でメンションに対してスレッド返信します。

使用方法:
  /shiiman-slack:mention-reply [オプション]

オプション:
  --help  このヘルプを表示

トークンについて

トークン返信者表示名
User Token(xoxp-)ユーザー本人自分の名前とアイコン

ワークフロー

1. スレッド情報の確認

以下を確認:

  • チャンネルID
  • スレッドのタイムスタンプ(親メッセージのts)
  • 返信内容

2. トークン状態の確認

python ${CLAUDE_PLUGIN_ROOT}/scripts/slack_config.py token-show

User Token が設定済みかを確認。未設定の場合は先に token-set を実行する。

3. 送信前の確認

送信前に必ずユーザーに確認を取る:

確認例:

以下の内容でユーザーとしてスレッドに返信してよろしいですか?

チャンネル: #general (C01234567)
スレッド: 1234567890.123456
返信: 了解しました!
投稿者: あなた(ユーザー名)

[はい/いいえ]

4. スレッド返信

# スレッド返信
python ${CLAUDE_PLUGIN_ROOT}/skills/mention-reply/scripts/slack_thread.py reply \
  --channel "C01234567" \
  --thread-ts "1234567890.123456" \
  --text "了解しました!"

5. 送信結果の報告

送信した返信のタイムスタンプとスレッド情報を表示。

コマンドオプション

オプション必須説明
--channel, -cYesチャンネルID
--thread-ts, -tYesスレッドのタイムスタンプ
--text, -mYes返信テキスト

トークン設定

/shiiman-slack:user-setup でトークンを設定してください。 User Token には chat:write スコープが必要です。

Profile Updater

Slack のプロフィールを更新します。

Help

$ARGUMENTS に --help が含まれる場合、以下を表示して終了:

/shiiman-slack:profile-update - Profile Updater

概要:
  Slack のプロフィールを更新します。

使用方法:
  /shiiman-slack:profile-update [オプション]

オプション:
  --help  このヘルプを表示

前提条件

このスキルは User Token(SLACK_USER_TOKEN) が必要です。 User Token がない場合はエラーになります。

User Token の設定

/shiiman-slack:user-setup でトークンを設定してください。

必要なスコープ

User Token に以下のスコープが必要:

  • users.profile:write - プロフィール更新

ワークフロー

1. 現在のプロフィールを確認

python ${CLAUDE_PLUGIN_ROOT}/skills/profile-update/scripts/slack_profile.py show

2. 表示名を変更

python ${CLAUDE_PLUGIN_ROOT}/skills/profile-update/scripts/slack_profile.py update --display-name "新しい表示名"

3. ステータスを設定

python ${CLAUDE_PLUGIN_ROOT}/skills/profile-update/scripts/slack_profile.py update \
  --status-text "会議中" \
  --status-emoji ":calendar:"

4. ステータスをクリア

python ${CLAUDE_PLUGIN_ROOT}/skills/profile-update/scripts/slack_profile.py clear-status

更新可能なフィールド

フィールドオプション説明
表示名--display-nameSlack に表示される名前
ステータス--status-text現在の状態を示すテキスト
絵文字--status-emojiステータスに付く絵文字
役職--title役職・肩書き
電話番号--phone連絡先電話番号
名--first-name名前(名)
姓--last-name名前(姓)

使用例

表示名とステータスを同時に変更

python ${CLAUDE_PLUGIN_ROOT}/skills/profile-update/scripts/slack_profile.py update \
  --display-name "山田太郎 - リモート" \
  --status-text "在宅勤務中" \
  --status-emoji ":house:"

役職を変更

python ${CLAUDE_PLUGIN_ROOT}/skills/profile-update/scripts/slack_profile.py update \
  --title "シニアエンジニア"

注意事項

  • User Token がないとこのスキルは使用できません
  • ワークスペースの設定によっては一部フィールドが変更できない場合があります
  • ステータス絵文字は :emoji_name: 形式で指定します

Unread Checker

Slack の未読メッセージを確認します。

Help

$ARGUMENTS に --help が含まれる場合、以下を表示して終了:

/shiiman-slack:unread-check - Unread Checker

概要:
  Slack の未読メッセージを確認します。

使用方法:
  /shiiman-slack:unread-check [オプション]

オプション:
  --help  このヘルプを表示

ワークフロー

1. 未読メッセージ取得

Pythonスクリプトで未読メッセージ一覧を取得。3パターンのコマンドがある:

全チャンネル詳細(チャンネル省略時)
python ${CLAUDE_PLUGIN_ROOT}/scripts/slack_message.py --format table unread
全チャンネルサマリー(高速)
python ${CLAUDE_PLUGIN_ROOT}/scripts/slack_message.py unread --summary

--summary オプション: 各チャンネルの未読件数のみを一覧表示する。メッセージ本文は取得しないため高速。

単一チャンネル指定
python ${CLAUDE_PLUGIN_ROOT}/scripts/slack_message.py --format table unread \
  --channel <CHANNEL_ID>

オプション:

  • --channel <CHANNEL_ID>: チャンネルID(省略時は全チャンネルを横断確認)
  • --summary: 未読件数のみのサマリー表示(高速)
  • --max <number>: 最大取得件数(デフォルト: 20)
  • --format <table|json>: 出力形式(デフォルト: table)※サブコマンドの前に指定

2. 結果の整形

チャンネルごとに未読メッセージをグループ化して表示:

# Slack 未読メッセージ

## #general (5件)
**山田太郎** (10:30)
今日のミーティングは15時からです

**佐藤花子** (10:32)
了解しました!

## #project-alpha (3件)
**田中一郎** (09:15)
PRレビューお願いします

3. 優先度の提示

未読メッセージの優先度を判断:

  • メンション付き: 高優先度
  • DMやプライベートチャンネル: 中優先度
  • パブリックチャンネル: 通常優先度

4. 既読化の提案

未読メッセージ表示後、既読にするか確認する:

確認した未読を既読にしますか?(unread-mark で既読化できます)

トークン設定

/shiiman-slack:user-setup でトークンを設定してください。

必要なスコープ

  • channels:read
  • channels:history
  • groups:read
  • groups:history
  • users:read

Mark Reader

Slack チャンネルを既読にします(一括既読化)。

Help

$ARGUMENTS に --help が含まれる場合、以下を表示して終了:

/shiiman-slack:unread-mark - Mark Reader

概要:
  Slack チャンネルを既読にします(一括既読化)。

使用方法:
  /shiiman-slack:unread-mark [オプション]

オプション:
  --help  このヘルプを表示

ワークフロー

1. チャンネルの確認

既読にするチャンネルを確認

2. 既読化前の確認

既読化する前に必ずユーザーに確認を取る:

#general の未読を既読にしますか?
(チャンネル省略の場合: 全未読チャンネルを一括既読化しますか?)

[はい/いいえ]

3. 既読化実行

Pythonスクリプトを実行:

全未読チャンネルを一括既読化(チャンネル省略時)
python ${CLAUDE_PLUGIN_ROOT}/scripts/slack_message.py mark-read
単一チャンネル既読化
python ${CLAUDE_PLUGIN_ROOT}/scripts/slack_message.py mark-read \
  --channel C01234567

4. 結果の報告

既読化したチャンネル情報を表示

User Setup

Slack 操作で使用するデフォルトユーザーID を設定・管理します。

Help

$ARGUMENTS に --help が含まれる場合、以下を表示して終了:

/shiiman-slack:user-setup - User Setup

概要:
  Slack 操作で使用するデフォルトユーザーID を設定・管理します。

使用方法:
  /shiiman-slack:user-setup [オプション]

オプション:
  --help  このヘルプを表示

概要

このスキルは、shiiman-slack プラグインで使用するデフォルトユーザーID を設定します。 設定されたユーザーID は、メンション確認や未読確認などで自動的に使用されます。

ワークフロー

1. 現在の設定を確認

まず現在の設定を確認:

python ${CLAUDE_PLUGIN_ROOT}/scripts/slack_config.py show

2. ユーザーID の設定

ユーザーが指定したユーザーID を設定:

python ${CLAUDE_PLUGIN_ROOT}/scripts/slack_config.py set-user --user-id U01234567

ユーザーID の確認方法:

  • Slack でプロフィールを開く → 「...」→「メンバーIDをコピー」
  • または U で始まる11文字程度のID

3. 設定の削除

設定をクリアしたい場合:

python ${CLAUDE_PLUGIN_ROOT}/scripts/slack_config.py clear

設定ファイル

設定は ~/.config/shiiman-slack/config.json に保存されます。

{
  "default_user_id": "U01234567",
  "workspace": {
    "team_id": "T01234567",
    "team_name": "MyWorkspace"
  },
  "created_at": "2025-01-14T10:00:00Z",
  "updated_at": "2025-01-14T10:00:00Z"
}

設定後の利用

設定されたユーザーID は以下のスキルで自動的に使用されます:

  • mention-check: 自分へのメンションを確認
  • unread-check: 自分の未読メッセージを確認
  • unread-mark: 自分としてメッセージを既読化

Agents 1

通知管理専門エージェント

Slack の未読メッセージ確認、メンション確認、既読化など通知に関する操作を包括的にサポートします。

実行内容

  • 未読メッセージの確認
  • 自分へのメンションの確認
  • チャンネルの既読化
  • 通知の整理・優先順位付け

使用タイミング

  • 未読メッセージを確認したい時
  • 自分へのメンションを確認したい時
  • チャンネルを既読にしたい時
  • 通知を整理したい時

専門知識

  • Slack 通知のベストプラクティス
  • 未読管理の効率的な方法
  • メンションの適切な対応
  • 通知設定の最適化

使用するスキル

未読メッセージ確認(unread-check)

python ${CLAUDE_PLUGIN_ROOT}/scripts/slack_message.py unread \
  --channel C01234567 \
  --max 20 \
  --format table

一括既読化(unread-mark)

python ${CLAUDE_PLUGIN_ROOT}/scripts/slack_message.py mark-read \
  --channel C01234567

メンション確認(mention-check)

python ${CLAUDE_PLUGIN_ROOT}/scripts/slack_message.py mentions \
  --max 20 \
  --format table

出力形式

未読メッセージ

# 未読メッセージ

## #general (3件)

ts                  user_name    text
1234567890.123456   山田太郎     明日の予定について
1234567892.123456   佐藤花子     了解です
1234567895.123456   田中一郎     資料共有します

## #project-alpha (1件)

ts                  user_name    text
1234567880.123456   木村さん     レビューお願いします

メンション一覧

# あなたへのメンション(直近20件)

メンション数: 5

channel         user        text                                    permalink
general         山田太郎    @you レビューお願いします               https://...
project-alpha   佐藤花子    @you 資料確認しました                   https://...
dev-team        田中一郎    @you バグ修正完了です                   https://...

使用例

# 未読確認
#project-alpha の未読を確認して

# 全チャンネルの未読確認
Slackの未読メッセージを見せて

# 既読化
#general の未読を既読にして

# メンション確認
自分へのメンションを見せて

# メンション対応
メンションに返信して

必要なスコープ

  • channels:read - チャンネル情報取得
  • channels:history - パブリックチャンネル履歴
  • channels:write - 既読マーク設定
  • groups:read - プライベートチャンネル情報
  • groups:history - プライベートチャンネル履歴
  • groups:write - プライベートチャンネル既読マーク
  • search:read - メッセージ検索
  • users:read - ユーザー情報取得

注意事項

  • 既読化する前にユーザーに確認を取ることを推奨
  • Slack Search APIは検索履歴の制限があります(フリープランでは直近10,000メッセージ)
  • メンションのパーマリンクをクリックすると、該当メッセージに直接ジャンプできます

Sponsors

Details

Marketplace
shiiman/claude-code-plugins
Source
plugins/shiiman-slack
Category
Productivity

More from shiiman/claude-code-plugins

All 9