MENU

Claude Codeでエラー通知を楽しく演出するサウンド活用ガイド

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

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

Claude Code を使った AI coding workflow では、効率化や自動化の恩恵を受けつつも、日々の作業で「ちょっとしたストレス」や「気が抜ける瞬間」が絶えません。特に通知や演出、OS連携系の機能が物足りないと感じる場面も多いのではないでしょうか。例えば、エラー発生時に何も起きず、淡々とログだけが流れてしまうと、思わず見逃してしまったり、場の空気が重くなりがちです。

  • エラー発生時、ログやメッセージだけでは気付かず、作業が止まってしまうことがある
  • 長時間の workflow で緊張感が切れ、重要なエラーをスルーしてしまう
  • チーム作業中、誰かのエラーが静かに流れてしまい、周囲が気付けない
  • monorepo で複数 directory を跨いで作業していると、どこで何が失敗したのか把握しづらい
  • 「またエラーか…」と気が滅入る瞬間も、何か遊び心ある演出がほしくなる

特に通知・演出・OS連携の観点では、エラー発生時の「場の雰囲気」を変えられる仕組みが求められています。

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

一言サマリ: コマンド実行時にエラーが発生した瞬間Skill。

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

  • エラー発生時に自作やノスタルジックなOS風ジングルがランダム再生され、作業場に独特の演出が加わる
  • 音で即座にエラーを認知できるため、長時間・複数人作業でも見逃しが減る
  • 音源はユーザーが自由に追加・差し替えでき、好みや場の雰囲気に合わせてカスタマイズ可能
  • ジョーク系の遊び心を持ち込むことで、エラー時の心理的負担を和らげる
  • Claude Code の repository understanding や path management の流れを崩さず、通知演出を強化できる
QUICK INSTALL
このSkillをすぐ試す

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

npx degit aazutaku/ai-note/claude-code/random-os-error-jingle .claude/skills/random-os-error-jingle

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

使う側がイメージしやすいよう、擬似 terminal で出力例を3パターン示す。Skill が返す出力は推測だが、現実的なフォーマット・現実的な長さで書く。

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


# /random-os-error-jingle
> Claude Code で main.py をテスト実行

[INFO] Running: python main.py
[ERROR] Traceback (most recent call last):
  File "main.py", line 42, in 
    raise ValueError("invalid input")
ValueError: invalid input

[SKILL] エラーが発生しました。ジングルを再生します。
[SKILL] 再生中: "nostalgic_famicom.wav" (音量: 80%)

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


> cd packages/api && npm run build

[INFO] Building package: api
[ERROR] Error: Cannot find module 'express'
    at Function.Module._resolveFilename (internal/modules/cjs/loader.js:636:15)
    ...

[SKILL] build エラー検知。ランダムジングル再生中。
[SKILL] サウンド: "custom_os_jingle1.wav"

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


> rm -rf important_dir/

[WARNING] Directory 'important_dir/' not found.
[SKILL] 何かおかしい動作を検知。ジングル(ランダム)を鳴らします。
[SKILL] サウンド: "my_weird_error.wav" (ミュート解除中)

before / after の違い

場面 Skill 無し Skill 有り
session 再開時 repo 構造から毎回説明、path も指定し直し Claude Code が自動で context を復元、最小プロンプトで再開
monorepo 移動 違う package のコードを参照しがち directory boundary を意識して必要な範囲だけ見る
長時間 workflow long context で重要箇所が薄まる エラー発生時に音で即座に気付けるため、重要な状況を逃さない

発動方式

明示呼び出し (/random-os-error-jingle) と暗黙発動 (エラー発生時の description マッチ) の両方に対応。

Skill の中身を全部見せる

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

.claude/skills/random-os-error-jingle/
├── SKILL.md
├── scripts/
│   └── random_os_error_jingle.py
└── references/
    └── design_notes.md

各ファイルの役割

ファイル 役割
SKILL.md Skill本体。frontmatter (name/description) と指示本文。Claude Code がこの内容をエージェント指示として読み込み、ユーザーのプロンプトに応じて発動します
scripts/random_os_error_jingle.py コマンド実行時のエラー発生でランダムジングル再生
references/design_notes.md 概要 をまとめた参考資料

SKILL.md

---
name: random-os-error-jingle
description: コマンド実行時やスクリプト内で例外・OSエラーが発生した際に、ランダムな“OSエラージングル”を再生するSkill。エラー発生・Exception・失敗・通知・サウンド演出などが発動条件。
---

# 機能概要
`random-os-error-jingle`は、コマンド実行やPythonスクリプト内でエラー（例外やOSエラー）が発生した瞬間、ローカルに用意した複数の“OSエラージングル”音源（WAV/MP3/ファミコン風など）からランダムで1つを強制再生します。作業中にエラーが起きたことを音で即座に知らせるだけでなく、周囲にも「また変な音が鳴ってる」と印象づけるジョーク系Skillです。音源の追加・差し替えも容易で、サウンド演出にこだわりたいユーザー向けです。

# 使い方
- 明示呼び出し: `/random-os-error-jingle --mute` でミュート、`--volume 0.3`で音量調整。
- 暗黙発動: `try/except`やコマンド失敗時に自動で発動。`Exception`, `OSError`, `失敗`, `エラー`, `通知`などのキーワードや例外発生時にトリガー。
- 音源は `.claude/skills/random-os-error-jingle/sounds/` にWAV/MP3形式で追加・差し替え可。

# 出力例
```
$ python my_script.py
Traceback (most recent call last):
  File "my_script.py", line 10, in <module>
    raise OSError("Disk not found!")
OSError: Disk not found!
[ジングル再生: famicom_error2.wav]
```

# 注意点
- 音源ファイルはローカル保存が必要です。
- サウンド再生には`playsound`/`pygame`/`pydub`などの実在APIを利用。
- ミュート/音量調整はコマンドライン引数で切替。
- サーバーや音声出力不可環境では動作しません。
- 除外パスや特定例外は`--exclude`で指定可能。

# 参考資料
- 詳細設計・参考: [references/design_notes.md]
- 公式: [https://pypi.org/project/playsound/], [https://www.pygame.org/docs/]

scripts/random_os_error_jingle.py

import os
import sys
import random
import argparse
import traceback
from glob import glob
try:
    from playsound import playsound
except ImportError:
    print("playsound モジュールが必要です。pip install playsound でインストールしてください。", file=sys.stderr)
    sys.exit(1)

SOUNDS_DIR = os.path.join(os.path.dirname(__file__), 'sounds')
SUPPORTED_FORMATS = ('.wav', '.mp3', '.ogg')

DEFAULT_VOLUME = 1.0  # playsoundは音量調整非対応。pygameやpydub利用時は調整可能。

class JinglePlayer:
    def __init__(self, sounds_dir=SOUNDS_DIR, mute=False, volume=DEFAULT_VOLUME, exclude=None):
        self.sounds_dir = sounds_dir
        self.mute = mute
        self.volume = volume
        self.exclude = exclude if exclude else []
        self.sounds = self._load_sounds()

    def _load_sounds(self):
        files = []
        for ext in SUPPORTED_FORMATS:
            files.extend(glob(os.path.join(self.sounds_dir, f'*{ext}')))
        if not files:
            print(f"警告: サウンドファイルが {self.sounds_dir} に見つかりません。", file=sys.stderr)
        return files

    def play_random(self):
        if self.mute or not self.sounds:
            return
        sound = random.choice(self.sounds)
        print(f"[ジングル再生: {os.path.basename(sound)}]", file=sys.stderr)
        # playsoundは音量調整非対応。pygame等で拡張可。
        try:
            playsound(sound)
        except Exception as e:
            print(f"サウンド再生失敗: {e}", file=sys.stderr)

    def should_exclude(self, exc_type, exc_value, tb):
        for ex in self.exclude:
            if ex.lower() in str(exc_type).lower() or ex.lower() in str(exc_value).lower():
                return True
        return False


def error_jingle_hook(exc_type, exc_value, tb):
    global player
    if player.should_exclude(exc_type, exc_value, tb):
        sys.__excepthook__(exc_type, exc_value, tb)
        return
    player.play_random()
    sys.__excepthook__(exc_type, exc_value, tb)


def parse_args():
    parser = argparse.ArgumentParser(description="コマンド実行時のエラー発生でランダムジングル再生")
    parser.add_argument('--mute', action='store_true', help='ジングルをミュート')
    parser.add_argument('--volume', type=float, default=DEFAULT_VOLUME, help='音量 (0.0-1.0)')
    parser.add_argument('--exclude', nargs='*', default=[], help='除外する例外タイプやキーワード')
    parser.add_argument('--test', action='store_true', help='ジングル再生テスト')
    parser.add_argument('--list', action='store_true', help='利用可能なジングル一覧表示')
    return parser.parse_args()


def main():
    global player
    args = parse_args()
    player = JinglePlayer(mute=args.mute, volume=args.volume, exclude=args.exclude)
    if args.list:
        print("利用可能なジングル:")
        for s in player.sounds:
            print(f"- {os.path.basename(s)}")
        sys.exit(0)
    if args.test:
        player.play_random()
        sys.exit(0)
    sys.excepthook = error_jingle_hook
    print("[random-os-error-jingle] Skill有効化中。例外発生時にジングル再生します。")
    # サンプル: 標準入力からPythonコードを受け取り実行（例外発生でジングル）
    code = ''
    if not sys.stdin.isatty():
        code = sys.stdin.read()
        try:
            exec(code, {})
        except Exception:
            pass  # excepthookでジングル再生
    else:
        print("スクリプト内でimportして利用するか、--testで動作確認できます。")

if __name__ == '__main__':
    main()

references/design_notes.md

# 概要
このSkillは、PythonスクリプトやCLIコマンド実行時の例外・OSエラー発生時に、ローカルのジングル音源をランダム再生することで、エラー通知とエンタメ性を両立します。

# 公式ドキュメント抜粋
- [playsound](https://pypi.org/project/playsound/): クロスプラットフォームな音声再生API。シンプルなWAV/MP3再生に対応。
- [pygame](https://www.pygame.org/docs/): 音量調整や多様なフォーマット再生が必要な場合に推奨。

# 利用例
- チーム開発現場で「誰がエラー出したか」可視化したい場合
- 個人開発でエラー発生時の気分転換や注意喚起
- エラーごとに異なる音源でサウンド演出を強化

# 注意点
- サーバーや音声出力不可な環境では無音となる。
- playsoundは音量調整非対応。高度な演出にはpygame/pydub等の拡張が必要。
- 音源ファイルは著作権等に注意し、自由に差し替え可。

# 設計方針
- 例外フックによる自動発動
- 音源の追加・除外・ミュート・音量調整の柔軟性
- スクリプト/CLI両対応のユーティリティ性

導入手順

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

1. 前提

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

2. degit でフォルダ取得

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

npx degit aazutaku/ai-note/claude-code/random-os-error-jingle .claude/skills/random-os-error-jingle

.claude/skills/random-os-error-jingle の中に SKILL.md / scripts/ / references/ / README.md が展開されます。

3. ファイル配置確認

ls .claude/skills/random-os-error-jingle
# SKILL.md, scripts/, references/, README.md があればOK

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

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

5. 動作確認

/random-os-error-jingle で呼び出すか、自然言語で発動条件にマッチする指示を出すと 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をコピーしました！

関連記事

目次