| name | ntfy-mobile-notify |
| description | スマホに ntfy でプッシュ通知を送信する。ユーザーが「スマホ通知も」「スマホにも通知」など明示的に要求したときに使う。 |
Ntfy Mobile Notify
概要
~/.agents/skills/ntfy-mobile-notify/scripts/send_mobile_notification.sh を使って、スマホ通知を ntfy コマンドで送信する。
通知ポリシー
- ユーザーが「スマホ通知も」「スマホにも通知」など、明示的に要求した場合のみ通知する。
NTFY_TOPIC が設定されていることを確認する。
- 通知は必ず
ntfy publish -t "<title>" "$NTFY_TOPIC" "<message>" で送信する。
タイトル規約
タイトルは必ず [$REPO_NAME] {Codex|Claude Code} ${実行内容の要約} 形式にする。--title で完全なタイトルを指定する場合も、この [$REPO_NAME] プレフィックスを必須とし、一致しない場合はエラー終了する。
REPO_NAME は次のコマンドで取得する。
REPO_NAME=$(basename "$(git rev-parse --show-toplevel 2>/dev/null)" 2>/dev/null || echo "non-git")
本文規約
- 本文は 100-200 文字程度で作成する。
- 変更内容、検証結果、補足を簡潔に含める。
- 1 通で要点が伝わるように情報を圧縮する。
実行主体の切替
- スクリプトは実行環境を判定して
Codex / Claude Code を自動選択する。
--agent codex|claude で明示指定できる。
NTFY_NOTIFY_AGENT=codex|claude でも上書きできる。
--agent や NTFY_NOTIFY_AGENT に codex|claude 以外を指定するとエラー終了する。
実行手順
NTFY_TOPIC を設定する。
--summary に 100-200 文字の要約を指定する。
- 必要なら
--agent で通知主体を指定する(詳細は「実行主体の切替」を参照)。
--title-suffix でタイトル末尾を指定する(省略時は スマホ通知)。
--dry-run で内容確認後に本送信する。
環境変数
NTFY_TOPIC: 必須。通知先トピック。
NTFY_NOTIFY_AGENT: 任意。通知主体を指定する(詳細は「実行主体の切替」を参照)。
実行例
REPO_NAME=$(basename "$(git rev-parse --show-toplevel 2>/dev/null)" 2>/dev/null || echo "non-git")
SKILL_SCRIPT="$HOME/.agents/skills/ntfy-mobile-notify/scripts/send_mobile_notification.sh"
SUMMARY='今回の作業では通知スキルの作成と検証を実施し、タイトル規約と本文長のチェックを追加しました。dry-runでコマンド整形とパラメータ展開を確認し、実行前に送信内容の妥当性を担保しています。'
NTFY_TOPIC="your-topic" \
"$SKILL_SCRIPT" \
--agent "codex" \
--title-suffix "通知スキル作成完了" \
--summary "$SUMMARY"
対応オプション
--summary: 必須。通知本文(100-200文字)。
--title-suffix: 任意。タイトル末尾の要約。
--agent: 任意。通知主体を codex または claude に固定する。
--title: 任意。完全なタイトルを指定する(形式は「タイトル規約」を参照)。
--repo-name: 任意。REPO_NAME を明示指定。
--dry-run: 任意。送信せずに実行内容を表示。
--help: 使い方を表示。
挙動メモ
NTFY_TOPIC 未設定時はエラー終了する。
ntfy コマンドが見つからない場合はエラー終了する(--dry-run を除く)。
--summary が 100-200 文字を外れる場合はエラー終了する。