
shiiman-slack
Slack 通知管理 - 未読確認、既読化、メンション確認・返信、プロフィール更新を提供
- version
- 4.1.3
- GitHub stars
- 7
Install
/plugin install shiiman-slack@shiiman-claude-code-pluginsRun it inside Claude Code after adding the marketplace with /plugin marketplace add shiiman/claude-code-plugins.
Contents
Discovered from sourceSkills 6
Mention Checker
Slack で自分へのメンションを確認します。
Help
$ARGUMENTS に --help が含まれる場合、以下を表示して終了:
/shiiman-slack:mention-check - Mention Checker
概要:
Slack で自分へのメンションを確認します。
使用方法:
/shiiman-slack:mention-check [オプション]
オプション:
--help このヘルプを表示
トリガー
- 「メンション確認」
- 「Slackメンション」
- 「自分へのメンション」
- 「@mention を見せて」
- 「メンション一覧」
動作
- Pythonスクリプト
slack_message.py mentionsを実行 - 自分へのメンションを検索
- メンション一覧を整理して表示
- 返信するか確認する(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, -c | Yes | チャンネルID |
--thread-ts, -t | Yes | スレッドのタイムスタンプ |
--text, -m | Yes | 返信テキスト |
トークン設定
/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-name | Slack に表示される名前 |
| ステータス | --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:readchannels:historygroups:readgroups:historyusers: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