Claude Codeで謎のやる気スピーチ通知を実現する設計ガイド

  • URLをコピーしました!
目次

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

Claude Code で日々コーディングしていると、真面目な開発フローの中にちょっとした気分転換や遊び心が欲しくなる瞬間がある。特に長時間の作業や、複雑な repository を相手にしていると、集中力やモチベーションの維持が課題となりがちだ。そんな時、淡々としたAI coding workflowに「何か面白い刺激がほしい」と感じるユーザーも多いはず。

また、通知や演出系のSkillが少ない現状では、作業の区切りやイベントを盛り上げる工夫が不足しがち。OS連携を活かした新しい体験を求める声も根強い。Claude Code ならではの context管理や repository understanding の合間に、エンタメ要素が自然に混ざれば、日常のディレクトリ移動やpath managementも少し楽しくなるのではないだろうか。

  • 長時間のコーディングで集中力が切れ、単調な作業が続いて気分転換が欲しくなる
  • monorepo で directory を跨いで作業していると、環境やcontextの切り替えに疲れが出る
  • Claude Code の通知や演出が味気なく、作業の区切りやイベント感が薄い
  • repoやdirectory構造の把握に追われ、オンボーディングやsession再開時のテンションが上がらない
  • AI coding workflowにユーモアや遊び心が欲しいが、既存Skillでは物足りない

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

一言サマリ: 作業中やコマンド実行のたびにSkill。

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

  • 作業やコマンド実行のたびに、OS公式風の謎のモチベーションスピーチがランダムに通知され、日常のコーディングにエンタメ要素が加わる
  • 長時間のworkflowやmonorepo作業中も、予期せぬ激励通知で気分転換・リフレッシュできる
  • onboardingやsession再開時に、堅苦しいcontext説明の合間にユーモアを挿入し、場の雰囲気を和らげる
  • repository understandingやpath managementのタイミングで、ちょっとした遊び心を感じられる
  • AI coding workflowに「OS公認の勇者」気分をプラスし、作業のマンネリ化を防ぐ
QUICK INSTALL
このSkillをすぐ試す

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

npx degit aazutaku/ai-note/claude-code/os-random-fake-motivational-speech-alert .claude/skills/os-random-fake-motivational-speech-alert

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

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

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


# /os-random-fake-motivational-speech-alert
> session start

[OS公式通知] 
「あなたのキーボードの叩き方に、開発者の情熱を感じます。」
「このrepositoryは今、伝説の始まりを迎えました。」
「Claude Codeと共に、あなたのcommitは宇宙を救う一歩となるでしょう。」

(作業を続けてください)

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


> cd packages/payment && /os-random-fake-motivational-speech-alert

[OS公式通知] 
「monorepoの境界を越えるあなたの勇気に、敬意を表します。」
「/packages/payment ディレクトリの挑戦は、AI coding workflowの歴史に刻まれるでしょう。」
「repository understanding の新たな扉が、今ここに開かれました。」

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


> /os-random-fake-motivational-speech-alert

[OS公式通知] 
「あなたのコードレビューは、未来のエンジニア達に語り継がれます。」
「path management の達人として、OSはあなたを公式に認定します。」
「今日のあなたは、AI coding workflowの英雄です。」

before / after の違い

場面 Skill 無し Skill 有り
session 再開時 repo 構造から毎回説明、path も指定し直し Claude Code が自動で context を復元、最小プロンプトで再開+謎の激励通知で気分転換
monorepo 移動 違う package のコードを参照しがち directory boundary を意識して必要な範囲だけ見る+OS公式通知でテンションUP
長時間 workflow long context で重要箇所が薄まる 合間に激励スピーチ通知が入り、集中力をリフレッシュ

発動方式

明示呼び出し (/os-random-fake-motivational-speech-alert) と暗黙発動 (description マッチ) の両方に対応。

Skill の中身を全部見せる

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

.claude/skills/os-random-fake-motivational-speech-alert/
├── SKILL.md
├── scripts/
│   └── motivational_alert.py
└── references/
    └── design_notes.md

各ファイルの役割

ファイル 役割
SKILL.md Skill本体。frontmatter (name/description) と指示本文。Claude Code がこの内容をエージェント指示として読み込み、ユーザーのプロンプトに応じて発動します
scripts/motivational_alert.py Cross-platform notification. Falls back to stdout if GUI notification fails.
references/design_notes.md 概要 をまとめた参考資料

SKILL.md

---
name: os-random-fake-motivational-speech-alert
description: コマンド実行時や作業中に、毎回内容が異なる“公式風やる気爆上げスピーチ”通知を発動。通知内容は本気の激励風で、明示的な呼び出し(/os-random-fake-motivational-speech-alert)や任意の作業トリガーで発生します。
---

# 機能概要
このSkillは、コーディングやコマンド実行などの作業時に、毎回異なる“OS公式”風のやる気爆上げスピーチ通知をデスクトップや端末画面に表示します。通知内容は「あなたのcommitが宇宙を救う」「今こそコード界の伝説になるときです」など、どこかズレた本気の激励ばかり。作業の合間にエンタメ要素を注入し、日常のコーディング体験をユーモラスに彩ります。

# 使い方
- 明示呼び出し: `/os-random-fake-motivational-speech-alert`
- 暗黙発動: 任意のコマンド実行・ファイル保存・ビルド等のタイミングで自動発火
- オプション: `--count 3` で複数回連続通知、`--list` で過去の通知履歴を表示

# 出力例
```
[OS公式通知] あなたのキーボードの叩き方に情熱を感じます。
[OS公式通知] 今こそコード界の伝説になるときです。
[OS公式通知] あなたのcommitは宇宙を救う。
[OS公式通知] その一行が未来を変える。
[OS公式通知] シンタックスエラーすら、あなたの成長の証です。
```

# 注意点
- 通知内容は毎回ランダム生成されますが、実害は一切ありません。
- システムやデータには影響せず、通知履歴はローカルファイルにのみ保存されます。
- 一部OSではGUI通知がサポートされない場合、端末出力のみとなります。

# 参考資料
- references/design_notes.md
- [Python公式: notifications, random, argparse](https://docs.python.org/3/)

scripts/motivational_alert.py

import os
import sys
import random
import argparse
import datetime
import platform
from pathlib import Path

try:
    # For cross-platform notification
    if platform.system() == 'Darwin':
        import subprocess
    elif platform.system() == 'Linux':
        import subprocess
    elif platform.system() == 'Windows':
        from win10toast import ToastNotifier
except ImportError:
    pass

NOTIFICATION_HISTORY = Path.home() / '.os_random_fake_motivational_speech_alert_history.log'

SPEECHES = [
    'あなたのキーボードの叩き方に情熱を感じます。',
    '今こそコード界の伝説になるときです。',
    'あなたのcommitは宇宙を救う。',
    'その一行が未来を変える。',
    'シンタックスエラーすら、あなたの成長の証です。',
    'タイポは冒険の始まりです。',
    'あなたのpushが世界に波紋を広げます。',
    'OSはあなたの努力を見守っています。',
    'バグは勇者の勲章です。',
    '今この瞬間、あなたはOS公認の勇者です。',
    'レビューの嵐に立ち向かうあなたに敬礼。',
    'デバッグは魂の修行です。',
    'そのコード、未来への架け橋です。',
    'あなたのテストが世界を守る。',
    'OSもあなたの成長に感動しています。',
    'あなたのpull requestは歴史に刻まれるでしょう。',
    'エラーはあなたの味方です。',
    '今日も素晴らしいコードをありがとう。',
    'あなたのロジックに宇宙が震えています。',
    'OS公式: その情熱、無限大。',
]


def notify(message):
    """
    Cross-platform notification. Falls back to stdout if GUI notification fails.
    """
    system = platform.system()
    notified = False
    try:
        if system == 'Darwin':
            subprocess.run(['osascript', '-e', f'display notification "{message}" with title "OS公式通知"'], check=True)
            notified = True
        elif system == 'Linux':
            subprocess.run(['notify-send', 'OS公式通知', message], check=True)
            notified = True
        elif system == 'Windows':
            toaster = ToastNotifier()
            toaster.show_toast('OS公式通知', message, duration=5)
            notified = True
    except Exception:
        pass
    if not notified:
        print(f'[OS公式通知] {message}')


def log_notification(message):
    timestamp = datetime.datetime.now().strftime('%Y-%m-%d %H:%M:%S')
    with open(NOTIFICATION_HISTORY, 'a', encoding='utf-8') as f:
        f.write(f'{timestamp}\t{message}\n')


def random_speech():
    return random.choice(SPEECHES)


def show_random_notifications(count=1):
    for _ in range(count):
        msg = random_speech()
        notify(msg)
        log_notification(msg)


def list_history(limit=10):
    if not NOTIFICATION_HISTORY.exists():
        print('通知履歴はまだありません。')
        return
    with open(NOTIFICATION_HISTORY, 'r', encoding='utf-8') as f:
        lines = f.readlines()
    if not lines:
        print('通知履歴はまだありません。')
        return
    print(f'直近{min(limit, len(lines))}件の通知履歴:')
    for line in lines[-limit:]:
        print(line.strip())


def summary_history():
    if not NOTIFICATION_HISTORY.exists():
        print('通知履歴はまだありません。')
        return
    with open(NOTIFICATION_HISTORY, 'r', encoding='utf-8') as f:
        lines = f.readlines()
    print(f'通知発行回数: {len(lines)}')
    dates = {}
    for line in lines:
        date = line.split('\t')[0].split(' ')[0]
        dates[date] = dates.get(date, 0) + 1
    print('日別通知数:')
    for date, cnt in sorted(dates.items()):
        print(f'  {date}: {cnt}')


def parse_args():
    parser = argparse.ArgumentParser(description='OS公式やる気爆上げスピーチ通知')
    subparsers = parser.add_subparsers(dest='command')

    parser_alert = subparsers.add_parser('alert', help='ランダム通知を表示')
    parser_alert.add_argument('--count', type=int, default=1, help='連続通知回数')

    parser_list = subparsers.add_parser('list', help='通知履歴を表示')
    parser_list.add_argument('--limit', type=int, default=10, help='表示件数')

    parser_summary = subparsers.add_parser('summary', help='通知履歴のサマリ表示')

    return parser.parse_args()


def main():
    args = parse_args()
    if args.command == 'alert' or args.command is None:
        cnt = getattr(args, 'count', 1)
        show_random_notifications(cnt)
    elif args.command == 'list':
        list_history(args.limit)
    elif args.command == 'summary':
        summary_history()
    else:
        print('不明なコマンドです。--help を参照してください。')

if __name__ == '__main__':
    main()

references/design_notes.md

# 概要
このSkillは、コマンド実行や作業時に毎回異なる“OS公式”風やる気スピーチを通知することで、日常のコーディングにユーモアとエンタメ要素を加えることを目的としています。

# 公式ドキュメント抜粋
- [Python notifications](https://docs.python.org/3/library/subprocess.html)
- [notify-send (Linux)](https://wiki.archlinux.jp/index.php/Notify-send)
- [osascript (macOS)](https://ss64.com/osx/osascript.html)
- [win10toast (Windows)](https://pypi.org/project/win10toast/)

# 利用例
- コマンド実行時に自動で通知を発火し、モチベーションを高める
- `/os-random-fake-motivational-speech-alert` で明示的に通知を受ける
- `--list` で過去の通知履歴を振り返る

# 注意点
- 通知は冗談目的であり、業務システムや本番環境では慎重に利用してください
- 履歴はユーザーホーム配下にのみ保存され、外部送信は一切ありません

# 設計方針
クロスプラットフォームな通知実装と、履歴管理・サマリ機能を組み合わせ、拡張性と安全性を両立しています。

導入手順

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

1. 前提

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

2. degit でフォルダ取得

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

npx degit aazutaku/ai-note/claude-code/os-random-fake-motivational-speech-alert .claude/skills/os-random-fake-motivational-speech-alert

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

3. ファイル配置確認

ls .claude/skills/os-random-fake-motivational-speech-alert
# SKILL.md, scripts/, references/, README.md があればOK

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

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

5. 動作確認

/os-random-fake-motivational-speech-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
  • 通知が多すぎて逆に集中力を削ぐ: 頻度調整や mute 機能の検討も必要

試す前に確かめたいこと

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

  • 実 repo での token 消費は許容範囲か?
  • monorepo (packages 多数) で安定して動くか?
  • stale context にならず、長時間 workflow でも有効か?
  • CLAUDE.md との連携設計はどうあるべきか?
  • 通知内容が毎回違い、本気の激励風であることをどう担保するか?
  • 通知が作業時や任意タイミングで確実に発火するか?
  • 実害ゼロ&システムやデータには一切影響しないことをどう確認するか?

実際に Claude Code で試した検証ログは Claude Codeで謎のやる気スピーチ通知を連発させてみた! にまとめる予定 (公開準備中の場合あり)。
あわせて Claude Code 公式ドキュメント と、本シリーズ「Claude Codeを便利にするSkill提案」の他記事も参照のこと。

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

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

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

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