notification

通知

重要なイベントやステータス変更をユーザーに通知する。

macOS 通知は常に実行し、環境変数 CUSTOM_CHANNEL_INBOX_ID があれば channel にも送信する。

使い方

macOS 通知（常に実行）

osascript -e 'display notification "メッセージ" with title "Claude Code"'

Channel 通知（環境変数があれば実行）

CUSTOM_CHANNEL_INBOX_ID 環境変数が設定されている場合のみ実行:

bun .claude/skills/notification/scripts/send-message.ts "ここにメッセージを書く"

senderId / senderName は環境変数 CUSTOM_CHANNEL_INBOX_ID / CUSTOM_CHANNEL_INBOX_NAME から自動付与される。送信先は常に "default"。

通知を送るタイミング

• ステータス変更時（タスク作成、計画完了、PR 完成など）
• ユーザーへの確認が必要なとき
• エラーで中断するとき
• 重要な問題を発見したとき

メッセージの書き方

基本ルール

• ユーザー目線の言葉で書く。技術的な詳細（クラス名、CSS値、ファイル名、関数名など）は含めない
• 「何ができるようになったか」「何が直ったか」を中心に書く
• チームメンバーの役割名はカタカナで書く（プログラマ、デザイナなど）。英語のエージェント名は使わない
• 簡潔に書く（1-3文程度）
• 内部用語やシステム用語を避ける（「粗探し」「重要度: 高」「Notion」「タスク起票」など）
• PR・Issue・タスクへのリンクがある場合は URL を含める（受け取った側がすぐ開けるように）

代わりに使う表現の例

報告例

良い例:

• 「投稿の公開範囲を選択できるようになりました。計画の確認をお願いします」
• 「ログイン機能の実装が完了しました。PR #123 で確認をお願いします https://github.com/org/repo/pull/123」
• 「セキュリティ上の問題を発見しました。優先的に対応が必要です」
• 「新しいタスクを起票しました」
• 「PR を作成しました」

悪い例:

• 「posts.create.ts に visibility フィルタを実装しました」（技術的すぎる）
• 「タスク起票完了」（簡潔すぎて内容が不明）
• 「bug-hunter が粗探しでバグを発見」（内部用語を使用）
• 「タスク #123 の計画確認待ちステータスへの遷移が完了しました」（長すぎる）
• 「処理を実行中です」（具体性がない）

注意

• 通知は重要なイベントに限定する
• 頻繁すぎる通知はユーザーの集中を妨げる
• メッセージは1文で完結させる