MENU

Claude Codeで緊張感を演出する通知スキルの作り方ガイド

Skills Lab Claude Code
  • URLをコピーしました！
目次

Claude Code ユーザーが日常でぶつかる悩み

Claude Code を使っていると、普段のコーディング作業やリポジトリ操作がどこか淡々と進みがちです。特に、重大なコマンド（例: git push、rm、npm publish など）を実行する瞬間も、日々のルーチンに埋もれてしまい、緊張感や高揚感が薄れてしまうことも少なくありません。気づけば、重大な操作も「Enterキーを押すだけ」の単なる作業になってしまい、注意力が散漫になりがちです。
また、Claude Code の AI coding workflow では context や repository understanding が自動で進む一方で、操作の重みやイベント性が希薄になるという声も。特に以下のような悩みがよく挙がります。

  • 重大なコマンドを実行する際も、Claude Code の出力が淡々としていて、重要なタイミングを見逃しやすい
  • monorepo で複数の directory を横断していると、どの repository や path で何をしているか意識が薄れがち
  • 長時間の session で集中力が切れ、うっかり取り返しのつかないコマンドを実行してしまうことがある
  • workflow の中で「ここが運命の分かれ道」という瞬間が埋もれてしまい、作業が単調になる
  • onboarding 時に、重要な操作の前後で緊張感や注意喚起が不足し、ミスを誘発しやすい

通知や演出、OS連携による「イベント感」の演出が足りないことで、作業のメリハリや注意喚起が弱くなっているという課題が見えてきます。

この Skill が一言でいうと何を解決するか

一言サマリ: このスキルは、重大コマンド実行時に“OS風ドラムロール”とデスクトップ通知で緊張感を演出し、普段の作業を一大イベントに変える Skill。

もう少し具体化すると、このSkillを入れることで以下のような状態になる:

  • 重大なコマンド（git push, rm, npm publish など）の直前にドラムロールと通知が走り、緊張感が高まることで操作ミスを防ぎやすくなる
  • repository や directory を跨ぐ重要なタイミングでイベント感が生まれ、AI coding workflow のメリハリや集中力が向上する
  • onboarding 時や長時間 session でも、重要局面を明確に認識できるため、context の切れ目や path management のミスを減らせる
  • 毎回異なる演出や通知パターンで、作業に“遊び心”とサプライズが加わり、単調な作業の気分転換にもなる
  • Claude Code の repository understanding や memory 機能と連携し、重要局面での注意喚起が自動化される
QUICK INSTALL
このSkillをすぐ試す

GitHub から degit でコマンド1行、Claude Code の Skill ディレクトリに展開できます。Node.js があれば即時に動きます。

npx degit aazutaku/ai-note/claude-code/os-command-drumroll-alert .claude/skills/os-command-drumroll-alert

実行したらこうなる (3つの利用シーン)

使う側がイメージしやすいよう、擬似 terminal で出力例を3パターン示します。

シーン1: session 開始時 (CLAUDE.md と組み合わせて)


# /os-command-drumroll-alert
> git push origin main

[ドラムロール音が鳴り始める...]
[デスクトップ通知] 運命の瞬間です！本当に git push しますか？
[Claude Code] "main ブランチへの push が実行されます。内容を再確認してください。"
[通知] 今こそ、あなたの選択がリポジトリの未来を変えます！

(Enterを押すと、通常通り git push が実行される)

シーン2: monorepo / package 跨ぎ作業時


> cd packages/payment
> rm -rf dist/

[ドラムロール音が鳴り響く...]
[デスクトップ通知] packages/payment ディレクトリで "rm -rf dist/" を実行しようとしています。
[Claude Code] "重大な削除コマンドです。directory と path を再確認してください。"
[通知] この操作は取り消せません。本当に実行しますか？

(Enterを押すと、コマンドが実行される)

シーン3: お遊び的な使い方


> npm publish

[ドラムロール音が盛大に！]
[デスクトップ通知] 祝・公開！この package を npm に publish します。
[Claude Code] "バージョン・依存関係・README.md を再確認しましたか？"
[通知] あなたのコードが世界に羽ばたきます。準備はよろしいですか？

(Enterで publish 実行)

before / after の違い

場面 Skill 無し Skill 有り
session 再開時 repo 構造から毎回説明、path も指定し直し 重大コマンド直前にドラムロール＋通知で注意喚起、context 切れ目でも重要局面を認識
monorepo 移動 違う package のコードを参照しがち directory boundary で演出発動、操作 path を明確化
長時間 workflow long context で重要箇所が薄まる 重大局面で演出が入るため、stale context でも注意を引き戻せる

発動方式

明示呼び出し (/os-command-drumroll-alert) と暗黙発動（コマンド内容やディレクトリ名などの description マッチ）の両方に対応しています。

Skill の中身を全部見せる

.claude/skills/os-command-drumroll-alert/ に配置するファイル一覧です。GitHub に push 済みなので、上記の degit コマンドで一発取得できます。

.claude/skills/os-command-drumroll-alert/
├── SKILL.md
├── scripts/
│   └── drumroll_alert.py
└── references/
    └── design_notes.md

各ファイルの役割

ファイル 役割
SKILL.md Skill本体。frontmatter (name/description) と指示本文。Claude Code がこの内容をエージェント指示として読み込み、ユーザーのプロンプトに応じて発動します
scripts/drumroll_alert.py 重大コマンド直前にドラムロールと通知で演出するスキル
references/design_notes.md 概要 をまとめた参考資料

SKILL.md

---
name: os-command-drumroll-alert
description: このSkillは、git push、rm、npm publish、docker pushなどの重大コマンド検知時、直前にドラムロール音とOS通知で“運命の選択”を演出します。コマンド実行前の緊張感を高め、重大操作のミス防止や気分転換にも役立ちます。
---

# 機能概要
`os-command-drumroll-alert`は、ターミナルやエディタで重大コマンド（例: `git push`, `rm -rf`, `npm publish`, `docker push`など）が実行される直前に、OS風のドラムロール音を鳴らし、デスクトップ通知で「本当にやるのか？」「運命の選択が迫る！」などの演出を自動的に挿入するSkillです。普段の作業が一気に壮大なイベントに変わり、エンジニアの心拍数を無駄に上げてくれます。ミス防止や気分転換、作業のリズムチェンジにも有効です。

# 使い方
- 明示呼び出し: `/os-command-drumroll-alert "git push"`
- 暗黙発動: `git push`, `rm -rf`, `npm publish`, `docker push` などのコマンド入力直前に自動発動（semantic trigger）。
- カスタムコマンド登録も可能。

# 出力例
```
[ドラムロール音が鳴る]
[通知] 今から本当に "git push" を実行しますか？
[通知] 運命の選択が迫る！
[通知] ドラマチックな瞬間に突入します。
(3秒後)
[INFO] コマンド "git push" を実行します。
```

# 注意点
- ドラムロール音はOS標準または内蔵WAVファイルを使用。
- 通知はOSの通知API（Windows: Toast, macOS: AppleScript, Linux: notify-send）を自動判別。
- 重大コマンド以外には発動しません。
- ローカルでのみ動作。通知や音声が不要な場合は環境変数で無効化可。

# 参考資料
- [Python playsound](https://github.com/TaylorSMarks/playsound)
- [notify2 (Linux通知)](https://pypi.org/project/notify2/)
- [Windows Toast通知](https://docs.microsoft.com/en-us/windows/uwp/design/shell/tiles-and-notifications/send-local-toast)
- references/design_notes.md も参照

scripts/drumroll_alert.py

import sys
import os
import argparse
import random
import subprocess
import platform
import time
from pathlib import Path

try:
    from playsound import playsound
except ImportError:
    playsound = None

# 通知メッセージのバリエーション
NOTIFY_MESSAGES = [
    '今から本当に "{cmd}" を実行しますか？',
    '運命の選択が迫る！',
    'ドラマチックな瞬間に突入します。',
    'この操作は取り消せません。',
    '心の準備はできていますか？',
    '重大なコマンドが検出されました。',
    'あなたの選択が未来を変えるかもしれません。',
    'エンジニアの運命を賭けた一手！',
    '緊張のドラムロールが鳴り響く…',
    'さあ、運命の実行ボタンを押しましょう。'
]

# 重大コマンドリスト
CRITICAL_COMMANDS = [
    'git push', 'rm ', 'rm -rf', 'npm publish', 'docker push', 'gcloud app deploy',
    'kubectl delete', 'terraform apply', 'aws s3 rm', 'az webapp deploy', 'scp ', 'rsync '
]

# ドラムロール音ファイル（WAV/MP3）
DRUMROLL_SOUNDS = [
    str(Path(__file__).parent / 'sounds/drumroll1.wav'),
    str(Path(__file__).parent / 'sounds/drumroll2.wav'),
    str(Path(__file__).parent / 'sounds/drumroll3.wav')
]


def is_critical_command(cmdline):
    for kw in CRITICAL_COMMANDS:
        if cmdline.strip().startswith(kw):
            return True
    return False


def play_drumroll():
    # 環境変数で無効化可
    if os.environ.get('DRUMROLL_ALERT_SOUND', '1') != '1':
        return
    sound_file = random.choice(DRUMROLL_SOUNDS)
    if not Path(sound_file).exists():
        print(f"[WARN] ドラムロール音ファイルが見つかりません: {sound_file}")
        return
    if playsound:
        try:
            playsound(sound_file)
        except Exception as e:
            print(f"[WARN] ドラムロール音再生失敗: {e}")
    else:
        # fallback: OS標準プレイヤー
        if platform.system() == 'Darwin':
            subprocess.run(['afplay', sound_file])
        elif platform.system() == 'Windows':
            subprocess.run(['powershell', '-c', f'(New-Object Media.SoundPlayer "{sound_file}").PlaySync();'])
        else:
            subprocess.run(['aplay', sound_file])


def send_notification(title, message):
    # 環境変数で無効化可
    if os.environ.get('DRUMROLL_ALERT_NOTIFY', '1') != '1':
        return
    sys_os = platform.system()
    if sys_os == 'Darwin':
        script = f'display notification "{message}" with title "{title}"'
        subprocess.run(['osascript', '-e', script])
    elif sys_os == 'Linux':
        subprocess.run(['notify-send', title, message])
    elif sys_os == 'Windows':
        try:
            import win10toast
            toaster = win10toast.ToastNotifier()
            toaster.show_toast(title, message, duration=5)
        except ImportError:
            # fallback: powershell
            ps_script = f"[Windows.UI.Notifications.ToastNotificationManager, Windows.UI.Notifications, ContentType = WindowsRuntime];"
            ps_script += f"$template = [Windows.UI.Notifications.ToastNotificationManager]::GetTemplateContent([Windows.UI.Notifications.ToastTemplateType]::ToastText02);"
            ps_script += f"$toastXml = $template;"
            ps_script += f"$toastXml.GetElementsByTagName('text')[0].AppendChild($toastXml.CreateTextNode('{title}')) | Out-Null;"
            ps_script += f"$toastXml.GetElementsByTagName('text')[1].AppendChild($toastXml.CreateTextNode('{message}')) | Out-Null;"
            ps_script += f"$toast = [Windows.UI.Notifications.ToastNotification]::new($toastXml);"
            ps_script += f"[Windows.UI.Notifications.ToastNotificationManager]::CreateToastNotifier('DrumrollAlert').Show($toast);"
            subprocess.run(['powershell', '-Command', ps_script])
    else:
        print(f"[通知] {title}: {message}")


def drumroll_alert(cmdline):
    print("[INFO] 重大コマンド検知: ドラムロール演出を開始します。")
    play_drumroll()
    for i in range(2):
        msg = random.choice(NOTIFY_MESSAGES).format(cmd=cmdline)
        send_notification("Drumroll Alert", msg)
        time.sleep(1)
    time.sleep(1)
    print(f"[INFO] コマンド \"{cmdline}\" を実行します。")


def main():
    parser = argparse.ArgumentParser(description='重大コマンド直前にドラムロールと通知で演出するスキル')
    parser.add_argument('command', nargs=argparse.REMAINDER, help='実行予定のコマンド')
    parser.add_argument('--dry-run', action='store_true', help='コマンド実行はせず演出だけ行う')
    parser.add_argument('--list-critical', action='store_true', help='重大コマンドリストを表示')
    parser.add_argument('--test-notify', action='store_true', help='通知テスト')
    parser.add_argument('--test-sound', action='store_true', help='ドラムロール音テスト')
    args = parser.parse_args()

    if args.list_critical:
        print("重大コマンド一覧:")
        for cmd in CRITICAL_COMMANDS:
            print(f"  - {cmd}")
        sys.exit(0)
    if args.test_notify:
        send_notification("Drumroll Alert", "これは通知テストです。")
        sys.exit(0)
    if args.test_sound:
        play_drumroll()
        sys.exit(0)
    if not args.command:
        print("[ERROR] コマンドを指定してください。例: drumroll_alert.py git push")
        sys.exit(1)
    cmdline = ' '.join(args.command)
    if is_critical_command(cmdline):
        drumroll_alert(cmdline)
    else:
        print(f"[INFO] 通常コマンド: {cmdline}")
    if not args.dry_run:
        try:
            subprocess.run(args.command)
        except Exception as e:
            print(f"[ERROR] コマンド実行失敗: {e}")

if __name__ == '__main__':
    main()

references/design_notes.md

# 概要
このSkillは、エンジニアが重大コマンドを実行する直前に、意図的に緊張感と演出を加えることで、操作ミスの防止や作業体験の向上を狙っています。音と通知の両方を活用し、日常的な作業をイベント化する設計です。

# 公式ドキュメント抜粋
- [playsound](https://github.com/TaylorSMarks/playsound): クロスプラットフォームな音声再生
- [notify2](https://pypi.org/project/notify2/): Linux通知
- [Windows Toast Notification](https://docs.microsoft.com/en-us/windows/uwp/design/shell/tiles-and-notifications/send-local-toast)

# 利用例
- `python drumroll_alert.py git push`
- `python drumroll_alert.py --dry-run rm -rf /tmp/test`
- 重大コマンド検知時に自動発動（エディタやターミナル統合）

# 注意点
- 音声ファイルはプロジェクト内の`sounds/`ディレクトリに配置してください。
- 通知APIはOSごとに異なるため、必要なパッケージ（playsound, win10toast等）は事前インストールが必要です。
- サーバー用途や無音環境では、環境変数で演出を無効化できます。

# 設計方針
- ユーザーの作業フローを妨げないよう、演出は短時間・非同期で完結。
- コマンド検知はシンプルなstartswith判定で誤検知を防止。
- 明示/暗黙両方のトリガーをサポートし、拡張性を重視。

導入手順

このSkillは GitHub で管理されているので、degit を使えば必要なフォルダだけを1コマンドで取得できます。Claude Code はファイル配置後に再起動するだけで自動認識します。

1. 前提

  • Node.js v16 以上 (degit 実行に必要)
  • Claude Code がローカルで動いていること

2. degit でフォルダ取得

プロジェクトのルートで以下のコマンドを実行します。

npx degit aazutaku/ai-note/claude-code/os-command-drumroll-alert .claude/skills/os-command-drumroll-alert

.claude/skills/os-command-drumroll-alert の中に SKILL.md / scripts/ / references/ / README.md が展開されます。

3. ファイル配置確認

ls .claude/skills/os-command-drumroll-alert
# SKILL.md, scripts/, references/, README.md があればOK

4. Claude Code を再起動 (or Skill 自動検出を待つ)

新しいSkillが自動で認識されます。リスト確認したい場合は /os-command-drumroll-alert と Skill 名で出てきます。

5. 動作確認

/os-command-drumroll-alert で呼び出すか、自然言語で発動条件にマッチする指示を出すと Skill が動きます。期待される出力イメージは「実行したらこうなる」セクションを参照してください。

こんな瞬間に便利

  • session 開始時: 前回までの repo 把握を Claude Code に一発で復元させたい
  • monorepo 移動時: packages を跨いだ瞬間に context を切り替えたい
  • onboarding 時: 新しい repo を Claude Code に把握させ、こちらが path を全部指定する手間を省きたい
  • session 再開時: long context が切れた後でも、必要な path と directory 構造だけ素早く戻したい
  • package 跨ぎ作業時: directory boundary を Skill 側で管理して、irrelevant な path 混入を防ぎたい
  • long-running workflow 前: long context で重要箇所が薄まる前に snapshot を取りたい
  • 重大コマンド実行直前: 普段のコマンド入力に緊張感とイベント性を加えたい

気になるポイント (壊れそうな箇所)

実運用に乗せる前に頭に入れておきたい懸念。後で検証する観点でもある:

  • stale context 問題: 長時間 workflow で Skill 出力が古くなり、現状と乖離する可能性
  • directory 増えすぎ問題: 大規模 repo で全 directory を網羅すると出力が肥大化して context window を圧迫
  • monorepo 肥大化: packages が多い構成では出力が雑になり、結局 path 指定し直しになる懸念
  • irrelevant path 混入: node_modules / build 成果物 / generated コードを拾ってしまう可能性
  • Claude Code 固有の引っかかり: paths フロントマターでの絞り込みを使わないと意図しないタイミングで発動する
  • 発動しないケース: description が漠然 / 他の Skill が優先 / git管理外 directory
  • 通知・演出が作業フローの邪魔になりすぎるリスク
  • 通知・サウンドが毎回同じパターンで飽きる可能性

試す前に確かめたいこと

この Skill を実運用に投入する前に確かめたい問いを並べる:

  • 実 repo での token 消費は許容範囲か?
  • monorepo (packages 多数) で安定して動くか?
  • stale context にならず、長時間 workflow でも有効か?
  • CLAUDE.md との連携設計はどうあるべきか?
  • 重大コマンド実行前に確実にドラムロール演出が走るか?
  • 通知とサウンドが毎回異なるパターンでランダム表示されるか?
  • 演出が作業フロー全体の邪魔になりすぎないか?

実際に Claude Code で試した検証ログは Claude Code の重大コマンド実行前にドラムロール演出を試してみた！ にまとめる予定 (公開準備中の場合あり)。
あわせて Claude Code 公式ドキュメント と、本シリーズ「Claude Codeを便利にするSkill提案」の他記事も参照のこと。

関連タグで他のSkill記事を探す

本記事に付いているタグから、気になるテーマの記事を探せます。タグページで関連記事をまとめて読めるので、ぜひチェックしてみてください！

Skills Lab Claude Code
AI Coding Agent Claude Code Skills 常時参照Skill 提案 通知・演出・OS連携

この記事が気に入ったら
フォローしてね！

よかったらシェアしてね！
  • URLをコピーしました！
  • URLをコピーしました！

関連記事

目次