MENU

Claude Codeでエラー通知に和風俳句を表示する演出の作り方入門

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

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

Claude Code を日々使っていると、真面目なエラー通知や作業中の演出にちょっとした“遊び”や“息抜き”が欲しくなる瞬間がある。特に長時間の開発や大規模 repository の調査、複雑な path management が絡むと、どうしても気が詰まりがち。そんなとき、ふとした和風演出や、意外性のある通知があれば、気分転換やチーム内の話題作りにもつながる。

  • エラー通知がいつも同じで、作業の気分転換やリフレッシュ要素が全くない
  • 長時間の AI coding workflow で集中力が切れ、ちょっとした“間”や和みが欲しくなる
  • repository understanding に時間がかかり、エラー時に気持ちの切り替えが難しい
  • monorepo や複雑な directory 構造でエラーが頻発し、通知がストレスになる
  • session 再開や onboarding 時も、無機質なエラーや注意メッセージばかりで飽きてしまう

特に「通知・演出・OS連携」系の悩みとして、開発現場に“ちょうどいい脱力感”や“遊び心”が求められる場面は意外に多い。

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

一言サマリ: このスキルは、エラー発生時に和風のランダム俳句を即座にデスクトップ通知することで、開発現場に遊び心と一瞬の静けさを届ける Skill。

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

  • エラー通知が毎回ランダムな俳句になるため、作業中の気分転換やリフレッシュ効果が得られる (AI coding workflow の合間に和みを提供)
  • monorepo や複雑な repository でも、エラー時のストレスが軽減され、context 切り替え時の心の負担が和らぐ
  • onboarding や session 再開時にも“謎演出”が入り、チーム内のコミュニケーションや話題作りに役立つ
  • 長時間の workflow で stale context が起きても、通知自体がマンネリ化しないので飽きが来にくい
  • エラー内容に左右されず、repository understanding の“間”を演出できる
QUICK INSTALL
このSkillをすぐ試す

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

npx degit aazutaku/ai-note/claude-code/random-os-fake-error-haiku-notifier .claude/skills/random-os-fake-error-haiku-notifier

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

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

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


# /random-os-fake-error-haiku-notifier
> プロジェクトの初期化をお願いします

[通知] OS公式: エラー俳句
春の宵　バグの影舞う　リポジトリ

(エラー内容は俳句で覆い隠される)

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


> packages/api/src/index.ts のビルドに失敗しました

[通知] OS公式: エラー俳句
デプロイや　monorepo越えて　風薫る

(本来のエラー内容は俳句通知で和らげられる)

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


> テストが全部落ちたので何か言って

[通知] OS公式: エラー俳句
落ちるテスト　桜ひらひら　春遠し

(ユーザーも思わず「なぜ俳句!?」とツッコミたくなる)

before / after の違い

場面 Skill 無し Skill 有り
session 再開時 repo 構造から毎回説明、path も指定し直し エラー時に俳句通知で和み、気持ちをリセット
monorepo 移動 違う package のコードを参照しがち エラー発生でも俳句通知が入り、ストレスを軽減
長時間 workflow long context で重要箇所が薄まる 通知自体が毎回変わるため、マンネリ化しない

発動方式

明示呼び出し (/random-os-fake-error-haiku-notifier) と暗黙発動 (エラー検知時やエラーメッセージに反応) の両方に対応。

Skill の中身を全部見せる

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

.claude/skills/random-os-fake-error-haiku-notifier/
├── SKILL.md
├── scripts/
│   └── haiku_notifier.py
└── references/
    └── design_notes.md

各ファイルの役割

ファイル 役割
SKILL.md Skill本体。frontmatter (name/description) と指示本文。Claude Code がこの内容をエージェント指示として読み込み、ユーザーのプロンプトに応じて発動します
scripts/haiku_notifier.py OS Error Haiku Notifier
references/design_notes.md 概要 をまとめた参考資料

SKILL.md

---
name: random-os-fake-error-haiku-notifier
description: Claude Codeは、エラー発生時や例外キャッチ時、または明示的に /random-os-fake-error-haiku-notifier が呼ばれた際にこのSkillを発動します。triggerType: always。キーワード: error, exception, fail, bug。
---

# 機能概要
このSkillは、開発者がターミナルやエディタでエラーや例外に遭遇した際、厳かな（しかし全く役に立たない）“OS公式風”のエラー俳句通知をデスクトップに表示します。エラー内容は無視し、毎回ランダムな俳句が選ばれるため、真面目なエラー通知に飽きた方や、作業中に一瞬の和みや混乱を求める方に最適です。俳句は日本語で生成され、通知は短時間で自動的に消えます。

# 使い方
- 明示呼び出し: `/random-os-fake-error-haiku-notifier` を入力すると即座に俳句通知が表示されます。
- 暗黙発動: `error`, `exception`, `fail`, `bug` などのキーワードを含む出力や例外発生時に自動で発動します。

# 出力例
```terminal
[OS Error Haiku]
バグの香や　春まだ遠き　デバッグ道

[OS Error Haiku]
夜のコード　静かに落ちる　未定義エラー

[OS Error Haiku]
桜散る　リファクタリングの　果てしなさ
```

# 注意点
- 通知内容はエラーの実態とは無関係です。
- 俳句は毎回ランダム生成・選択されます。
- 通知はローカル環境でのみ表示され、リモートやWeb IDEでは動作しない場合があります。
- ログやファイルへの保存は行いません。

# 参考資料
- [公式ドキュメント（Python notify2）](https://github.com/caronc/apprise)
- references/design_notes.md を参照してください。

scripts/haiku_notifier.py

import sys
import argparse
import random
import time
import threading
import platform

try:
    if platform.system() == 'Linux':
        import notify2
    elif platform.system() == 'Darwin':
        from subprocess import call
    elif platform.system() == 'Windows':
        from win10toast import ToastNotifier
except ImportError:
    pass

HAIKU_LIST = [
    'バグの香や　春まだ遠き　デバッグ道',
    '夜のコード　静かに落ちる　未定義エラー',
    '桜散る　リファクタリングの　果てしなさ',
    '朝焼けに　スタックトレース　消えゆけり',
    '秋深し　メモリリークの　気配かな',
    '冬の夜　静寂破る　例外音',
    '夏草や　デバッグ残る　夢の跡',
    '月明かり　タイポに泣いて　眠れずに',
    '霧の中　無限ループの　道しるべ',
    '風そよぐ　未定義変数　名も知らず'
]

DEFAULT_DURATION = 4  # seconds


def pick_random_haiku():
    return random.choice(HAIKU_LIST)


def notify_linux(haiku, duration):
    notify2.init('OS Error Haiku Notifier')
    n = notify2.Notification('OS Error Haiku', haiku)
    n.set_timeout(duration * 1000)
    n.show()


def notify_mac(haiku, duration):
    script = f'display notification "{haiku}" with title "OS Error Haiku"'
    call(["osascript", "-e", script])
    # macOS通知は自動消去不可


def notify_windows(haiku, duration):
    toaster = ToastNotifier()
    toaster.show_toast("OS Error Haiku", haiku, duration=duration, threaded=True)
    # Windowsはthreadedで自動消去


def notify_terminal(haiku):
    print(f"[OS Error Haiku]\n{haiku}\n")


def notify(haiku, duration=DEFAULT_DURATION):
    sys_platform = platform.system()
    try:
        if sys_platform == 'Linux':
            notify_linux(haiku, duration)
        elif sys_platform == 'Darwin':
            notify_mac(haiku, duration)
        elif sys_platform == 'Windows':
            notify_windows(haiku, duration)
        else:
            notify_terminal(haiku)
    except Exception as e:
        notify_terminal(haiku)


def handle_log(args):
    haiku = pick_random_haiku()
    notify(haiku)


def handle_list(args):
    print("=== OS Error Haiku 一覧 ===")
    for idx, h in enumerate(HAIKU_LIST, 1):
        print(f"{idx}. {h}")


def handle_summary(args):
    print(f"登録俳句数: {len(HAIKU_LIST)}")
    print("例:")
    for h in random.sample(HAIKU_LIST, min(3, len(HAIKU_LIST))):
        print(f"- {h}")


def main():
    parser = argparse.ArgumentParser(description='OS Error Haiku Notifier')
    subparsers = parser.add_subparsers(dest='command', required=True)

    parser_log = subparsers.add_parser('log', help='ランダム俳句を通知')
    parser_log.set_defaults(func=handle_log)

    parser_list = subparsers.add_parser('list', help='俳句リストを表示')
    parser_list.set_defaults(func=handle_list)

    parser_summary = subparsers.add_parser('summary', help='俳句サマリーを表示')
    parser_summary.set_defaults(func=handle_summary)

    args = parser.parse_args()
    args.func(args)


if __name__ == '__main__':
    main()

references/design_notes.md

# 概要
本Skillは、エラー発生時に開発者へ和風のユーモアを提供するための通知演出ツールです。技術的なエラー内容を一切参照せず、俳句のみをランダム表示することで、気分転換やストレス軽減を狙っています。

# 公式ドキュメント抜粋
- Pythonデスクトップ通知: [notify2 (Linux)](https://github.com/caronc/apprise)
- [win10toast (Windows)](https://github.com/jithurjacob/Windows-10-Toast-Notifications)
- macOS通知: osascript経由でAppleScript利用

# 利用例
- ターミナルで `python haiku_notifier.py log` を実行すると、即座に俳句通知が表示されます。
- エラー発生時にSkill連携から自動で呼び出す運用も可能です。

# 注意点
- 通知内容はエラーとは無関係です。
- 通知の自動消去はOS依存で、macOSでは明示的な消去は不可です。
- Web IDEやリモート環境では通知が表示されない場合があります。

# 設計方針
- シンプルかつOS横断的な通知実装
- 俳句リストは拡張可能
- ログ保存やエラー内容との連携はあえて行わず、混乱と和みを優先

導入手順

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

1. 前提

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

2. degit でフォルダ取得

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

npx degit aazutaku/ai-note/claude-code/random-os-fake-error-haiku-notifier .claude/skills/random-os-fake-error-haiku-notifier

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

3. ファイル配置確認

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

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

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

5. 動作確認

/random-os-fake-error-haiku-notifier で呼び出すか、自然言語で発動条件にマッチする指示を出すと 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
  • 通知が多すぎて邪魔になる: エラー頻発時は俳句通知が連発され、逆に集中力を削ぐ可能性
  • OS通知の挙動: 一部環境で通知が正しく表示されないことがある

試す前に確かめたいこと

この 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をコピーしました！

関連記事

目次