MENU

Claude Codeでカオスな休憩通知を自動化する演出スキルの作り方

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

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

Claude Code を使った AI coding workflow では、repo や directory の構造を意識しながら作業することが多いものの、集中しすぎて休憩を忘れてしまうことがよくあります。作業に没頭していると、長時間同じ姿勢で過ごしてしまったり、気づけば context が膨れ上がって重要な情報が埋もれてしまうことも。「AI coding workflow での集中維持」と「適度なリフレッシュ」のバランスは意外と難しいポイントです。

  • Claude Code の session を長時間続けていると、気づかぬうちに身体が固まってしまう
  • repository understanding や path management に没頭しすぎて、休憩のタイミングを見失う
  • monorepo で複数 directory を行き来していると、context 切り替えの合間に一息つく余裕がなくなる
  • memory が膨張し、long context で重要なやりとりが薄まってしまうタイミングでリセット感が欲しい
  • 真面目な雰囲気が続きがちな onboarding や session 再開時、ちょっとした遊び心が欲しくなる

特に通知・演出・OS連携系の悩みとして、「仕事の合間に強制的に休憩を挟みたいが、普通のリマインダーだと味気ない」「AI と一緒にちょっとしたユーモアを楽しみたい」という声も増えています。

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

一言サマリ: このスキルは、作業中に突然ランダムな偽OS休憩通知を炸裂させ、Claude Code の workflow に強制ユーモアとリフレッシュを注入します。

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

  • AI coding workflow の中で、突発的かつ完全ランダムなタイミングで「謎の休憩通知」が現れ、緊張感を一瞬ブレイクできる
  • 通知内容が毎回異なり、意味不明なメッセージで思わず笑ってしまうことで、長時間の集中作業にリズムが生まれる
  • repository understanding や path management の合間に、意図せずリフレッシュできる環境を自動で作り出せる
  • onboarding や session 再開時の堅苦しい空気を、AI 側から崩してくれる
  • Skill の発動は完全に作業やデータに影響せず、安心して workflow に組み込める
QUICK INSTALL
このSkillをすぐ試す

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

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

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

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

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


# /random-os-fake-breaktime-alert

[OS通知] 緊急！脳内メモリ休息モード発動
------------------------------------------
Claude Code の session が開始されました。
本日は「肩回しタイム」推奨。
5分間だけ repository のことは忘れて、深呼吸をどうぞ。

(この通知は完全にフィクションです。作業には影響しません)

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


# packages/api/ から packages/web/ に移動

[OS通知] OS推奨：5分間ぼーっとするべし
------------------------------------------
monorepo の directory 移動を検知しました。
今こそ「意味不明な休憩」を取る絶好のタイミングです。

例: packages/web/README.md を開く前に、ストレッチをどうぞ。

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


# /random-os-fake-breaktime-alert

[OS通知] 謎のエラー: "脳内キャッシュ満タン"
------------------------------------------
AI coding workflow での集中力が最大値に達しました。
ここで「コーヒー片手に空を見上げる」モードを推奨します。

(この通知は冗談です。ご安心ください)

before / after の違い

場面 Skill 無し Skill 有り
session 再開時 repo 構造から毎回説明、path も指定し直し Claude Code が自動で context を復元、最小プロンプトで再開
monorepo 移動 違う package のコードを参照しがち directory boundary を意識して必要な範囲だけ見る＋唐突に休憩通知
長時間 workflow long context で重要箇所が薄まる 適度なタイミングで「強制リフレッシュ」通知が入り、集中力リセット

発動方式

明示呼び出し (/random-os-fake-breaktime-alert) と暗黙発動 (「休憩したい」「集中しすぎている」などの指示や状況記述) の両方に対応。

Skill の中身を全部見せる

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

.claude/skills/random-os-fake-breaktime-alert/
├── SKILL.md
├── scripts/
│   └── random_os_fake_breaktime_alert.py
└── references/
    └── design_notes.md

各ファイルの役割

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

SKILL.md

---
name: random-os-fake-breaktime-alert
description: 作業中の緊張感を和らげたい、またはユーモアを注入したい場面で発動。『休憩』『通知』『リラックス』『集中力低下』『OSアラート』などのキーワードや、明示的な /random-os-fake-breaktime-alert コマンドで発動します。
---

# 機能概要
このSkillは、作業中のデスクトップに「謎のOS風・強制休憩通知」をランダムなタイミングで表示します。通知内容も毎回ランダムで、「肩回しタイム発動」「OS推奨：5分間ぼーっとするべし」「緊急！脳内メモリ休息モード」など、意味不明かつカオスなメッセージが炸裂。真面目な現場に唐突なユーモアを注入し、張り詰めた空気を一瞬だけほぐすことができます。実作業やデータには一切影響を与えず、あくまで演出と気分転換を目的としています。

# 使い方
- 明示呼び出し例: `/random-os-fake-breaktime-alert`
- 暗黙発動キーワード例: 「休憩したい」「集中力が切れた」「通知で遊びたい」「OSアラート」「リラックスしたい」などを含む会話や指示

# 出力例
```terminal
[OS通知] 肩回しタイム発動！今すぐ両腕を回転せよ。
[OS通知] 緊急！脳内メモリ休息モード。5分間ぼーっと推奨。
[OS通知] システム推奨：窓の外を眺めて深呼吸するべし。
[OS通知] 休憩プロトコル：好きな飲み物を用意してください。
[OS通知] 謎のアップデート中。作業を一時中断してください。
```

# 注意点
- 本Skillは実際の作業やファイルには一切干渉しません。
- 通知はローカル環境のデスクトップ通知機能を利用します（Linux/macOS/Windows対応）。
- 一部環境では通知が表示されない場合があります。
- ログや履歴はローカルに保存されません。

# 参考資料
- 参考: references/design_notes.md
- 公式: https://docs.python.org/ja/3/library/subprocess.html, https://pypi.org/project/plyer/

scripts/random_os_fake_breaktime_alert.py

import sys
import time
import random
import argparse
import platform
import subprocess
from threading import Thread

try:
    from plyer import notification
    PLYER_AVAILABLE = True
except ImportError:
    PLYER_AVAILABLE = False

NOTIFICATIONS = [
    "肩回しタイム発動！今すぐ両腕を回転せよ。",
    "OS推奨：5分間ぼーっとするべし。",
    "緊急！脳内メモリ休息モード。",
    "窓の外を眺めて深呼吸するべし。",
    "休憩プロトコル：好きな飲み物を用意してください。",
    "謎のアップデート中。作業を一時中断してください。",
    "OS推奨：目を閉じて10秒間リラックス。",
    "肩甲骨を寄せてリフレッシュ！",
    "システム：ストレッチ推奨。",
    "OSからのお願い：背筋を伸ばしてください。",
    "脳内キャッシュが溢れています。休憩を推奨します。",
    "強制休憩モード発動。5分間席を外してください。"
]

TITLE = "[OS通知]"


def show_notification(message):
    """
    OSに応じてデスクトップ通知を表示
    """
    if PLYER_AVAILABLE:
        notification.notify(
            title=TITLE,
            message=message,
            timeout=8
        )
        return
    system = platform.system()
    if system == "Darwin":  # macOS
        script = f'display notification "{message}" with title "{TITLE}"'
        subprocess.run(["osascript", "-e", script])
    elif system == "Linux":
        subprocess.run(["notify-send", TITLE, message])
    elif system == "Windows":
        try:
            import win10toast
            toaster = win10toast.ToastNotifier()
            toaster.show_toast(TITLE, message, duration=8)
        except ImportError:
            print(f"{TITLE} {message}")
    else:
        print(f"{TITLE} {message}")


def random_notification_loop(min_interval=900, max_interval=2700):
    """
    ランダムな間隔で通知を表示し続ける
    min_interval, max_interval: 秒単位
    """
    try:
        while True:
            interval = random.randint(min_interval, max_interval)
            time.sleep(interval)
            message = random.choice(NOTIFICATIONS)
            show_notification(message)
    except KeyboardInterrupt:
        print("通知ループを終了します。")


def send_single():
    message = random.choice(NOTIFICATIONS)
    show_notification(message)
    print(f"{TITLE} {message}")


def list_messages():
    print("--- 通知メッセージ一覧 ---")
    for i, msg in enumerate(NOTIFICATIONS, 1):
        print(f"{i}. {msg}")


def summary():
    print("Skill名: random-os-fake-breaktime-alert")
    print(f"登録メッセージ数: {len(NOTIFICATIONS)}")
    print(f"対応OS: macOS, Linux, Windows (一部要追加パッケージ)")
    print("通知内容は毎回ランダムで変化。実作業やデータには一切影響なし。")


def main():
    parser = argparse.ArgumentParser(description="謎のOS風・強制休憩通知スクリプト")
    subparsers = parser.add_subparsers(dest="command")

    parser_send = subparsers.add_parser("send", help="1回だけランダム通知を表示")
    parser_loop = subparsers.add_parser("loop", help="定期/ランダム間隔で通知を繰り返し表示")
    parser_loop.add_argument("--min", type=int, default=900, help="最小通知間隔(秒)")
    parser_loop.add_argument("--max", type=int, default=2700, help="最大通知間隔(秒)")
    parser_list = subparsers.add_parser("list", help="メッセージ一覧を表示")
    parser_summary = subparsers.add_parser("summary", help="Skill概要を表示")

    args = parser.parse_args()

    if args.command == "send":
        send_single()
    elif args.command == "loop":
        min_int = max(10, args.min)
        max_int = max(min_int, args.max)
        print(f"通知ループ開始: {min_int}～{max_int}秒間隔")
        random_notification_loop(min_interval=min_int, max_interval=max_int)
    elif args.command == "list":
        list_messages()
    elif args.command == "summary":
        summary()
    else:
        parser.print_help()

if __name__ == '__main__':
    main()

references/design_notes.md

# 概要
本Skillは、作業中の緊張感を和らげるために、意味不明なOS風休憩通知をランダムに表示する演出系ツールです。実作業やファイルには一切干渉せず、純粋な気分転換・ユーモア注入を目的としています。

# 公式ドキュメント抜粋
- plyer: https://plyer.readthedocs.io/en/latest/
- notify-send: https://wiki.archlinux.jp/index.php/Notify-send
- osascript: https://developer.apple.com/library/archive/documentation/AppleScript/Conceptual/AppleScriptLangGuide/introduction/ASLR_intro.html

# 利用例
- チームの朝会や長時間作業時のリフレッシュ演出
- 一人作業の集中力維持や、会議のアイスブレイク
- /random-os-fake-breaktime-alert send で即座に通知、loopで定期的に発動

# 注意点
- OSの通知機能が無効・非対応の場合は標準出力のみ
- plyer未導入時はnotify-send/osascript/標準出力で代替
- ログや履歴は保存されません

# 設計方針
- ユーザー操作不要でランダム発動可能
- メッセージ内容・発動タイミングともにカオス性を重視
- 実作業やデータの安全性を最優先

導入手順

この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-breaktime-alert .claude/skills/random-os-fake-breaktime-alert

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

3. ファイル配置確認

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

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

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

5. 動作確認

/random-os-fake-breaktime-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 を取りたい
  • 集中しすぎていると感じた時: 強制的にリフレッシュしたい場面で
  • プロジェクトの空気を和ませたい時: onboarding やチーム作業の雰囲気作りに

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

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

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

関連記事

目次