Claude Codeで作業中に癒しとリセットを生む通知演出の構築手順

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

Claude Code で日々開発を進めていると、どうしても単調な作業や、集中力が切れるタイミングに遭遇しがちです。特に長時間のセッションや複雑な monorepo の作業では、気づかぬうちに「頭が固まった」「リフレッシュしたい」と感じる場面が増えてきます。そんな時、ちょっとした気分転換や“謎の癒し”があれば…と思ったことはないでしょうか。

• Claude Code がいつの間にか違う directory を見始めて、想定外のファイルを読みに行く
• monorepo で package を跨いだ瞬間、Claude Code が repo 構造を忘れる
• session を再開すると、前回までの context や path 指定をまるごと再説明しないといけない
• 長時間 workflow で long context が膨らみすぎて、important な情報が薄まる (stale context)
• 「ここはこういう構造のリポジトリ」というあらすじを毎回チャットの冒頭で書く羽目になる

また、通知や演出が単調で、作業環境にちょっとした遊び心やリフレッシュ要素が不足しがちなのも、密かな悩みとなっています。

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

一言サマリ: このスキルは「OSペット乱入イベント」で作業の集中力リセットと癒しをもたらすSkill。

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

• Claude Code の AI coding workflow 中に、完全ランダムな“OSペット”演出が挿入され、長時間の単調作業に不意打ちの癒しや混乱が訪れる
• repository understanding や path management の合間に、強制的に context をリセットするきっかけを作れる
• monorepo や大規模 directory でも、たまには“何の役にも立たないイベント”で気分転換できる
• onboarding や長時間 session の合間に、AIが一瞬だけ“OSがペットを飼い始めた世界”を演出
• 記憶や context が煮詰まった時、謎イベントで頭をリフレッシュできる

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

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

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

# /random-os-fake-system-pet-interruption

[通知] OS公式ペット「バーチャル柴犬」が画面端に出現しました。
[演出] 柴犬が /src/utils/context_manager.py の上で昼寝を始めました。
[Tips] 「ペットをクリックすると、たまに鳴き声が聞ける」らしい。
[Claude Code] session context をリフレッシュ中...

(作業再開: repo, directory 構造の再認識が促されます)

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

> packages/core/ に移動して main.ts を編集

[通知] 仮想猫「ルナ」が packages/ui/ の README.md を横切りました。
[演出] 「マウスカーソルを追いかけています。ご注意ください。」
[Claude Code] monorepo の package 境界を再確認します。
(重要な context を再設定しています)

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

> ちょっと疲れたから何か面白いことして

[通知] OSペット「デジタル文鳥」が /docs/ ディレクトリで暴れています。
[演出] 「repository understanding を妨害中…？（嘘です）」
[Claude Code] path management もたまには休憩しましょう。

before / after の違い

場面	Skill 無し	Skill 有り
session 再開時	repo 構造から毎回説明、path も指定し直し	Claude Code が自動で context を復元、最小プロンプトで再開＋癒し演出
monorepo 移動	違う package のコードを参照しがち	directory boundary を意識して必要な範囲だけ見る＋ペットイベントでリフレッシュ
長時間 workflow	long context で重要箇所が薄まる	突発イベントで集中力をリセット、再度 context 把握しやすく

発動方式

明示呼び出し (/random-os-fake-system-pet-interruption) と暗黙発動 (「癒しが欲しい」「疲れた」などの description マッチ) の両方に対応。

Skill の中身を全部見せる

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

.claude/skills/random-os-fake-system-pet-interruption/
├── SKILL.md
├── scripts/
│   └── os_pet_interruption.py
└── references/
    └── design_notes.md

各ファイルの役割

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

SKILL.md

---
name: random-os-fake-system-pet-interruption
description: このSkillは、ユーザーが作業に集中している最中や長時間操作が続いている際に、完全ランダムなタイミングで“OSペット乱入”通知を発生させます。トリガーはsemantic-or-explicitで、/random-os-fake-system-pet-interruption コマンドや「癒し」「休憩」「集中しすぎ」などのキーワードを検知した場合にも発動します。
---

# 機能概要
このSkillは、あなたの作業中に突如として“OSペット乱入イベント”を発生させます。デスクトップ通知や端末出力を通じて、「仮想猫がマウスを追いかけています」「デジタル柴犬がファイルの上で昼寝中」など、完全ランダムなメッセージが表示されます。何の役にも立たないのに、謎の癒しや混乱をもたらし、作業中の集中力を強制的にリセットするユーモラスな体験を提供します。OSがペットを飼い始めた世界を一瞬だけ味わうことができます。

# 使い方
- 明示呼び出し: `/random-os-fake-system-pet-interruption` コマンドを実行
- 暗黙発動: 「癒し」「休憩」「集中しすぎ」「ペット」などのキーワードを含む会話や、長時間の連続操作時に自動発動

# 出力例
```
[OSペット通知] 仮想猫が画面を横切りました！
[OSペット通知] デジタル柴犬がファイル「report.docx」の上で昼寝中です。
[OSペット通知] 公式ペンギンがマウスカーソルを追いかけています。
[OSペット通知] バーチャルインコがタスクバーに止まりました。
[OSペット通知] 謎のカメがゆっくりとウィンドウを横断中。
```

# 注意点
- 本Skillは実際のデスクトップ上でペットが動くわけではなく、通知や端末出力のみです。
- ローカル環境でのみ動作し、通知API（notify2等）利用時はLinux/WSL/一部Macでのみ対応。
- 何度も発動する場合がありますが、実害はありません。
- ログは ~/.os_pet_events.log に保存されます。

# 参考資料
- references/design_notes.md を参照
- notify2公式: https://github.com/caronc/apprise
- Python random, time, argparse 標準モジュール

scripts/os_pet_interruption.py

import random
import time
import argparse
import sys
import os
try:
    import notify2
    NOTIFY_AVAILABLE = True
except ImportError:
    NOTIFY_AVAILABLE = False

PET_EVENTS = [
    "仮想猫が画面を横切りました！",
    "デジタル柴犬がファイル『{file}』の上で昼寝中です。",
    "公式ペンギンがマウスカーソルを追いかけています。",
    "バーチャルインコがタスクバーに止まりました。",
    "謎のカメがゆっくりとウィンドウを横断中。",
    "デジタルハムスターが端末の隅でひまわりの種を食べています。",
    "仮想ラビットがウィンドウの隙間から顔を覗かせました。",
    "公式パンダがフォルダを抱えて転がっています。",
    "バーチャル柴犬が通知領域でしっぽを振っています。",
    "謎のペットがどこからともなく現れました。"
]

SAMPLE_FILES = [
    "report.docx", "main.py", "presentation.pptx", "notes.txt", "summary.xlsx"
]

LOG_PATH = os.path.expanduser("~/.os_pet_events.log")


def random_pet_event():
    event = random.choice(PET_EVENTS)
    if "{file}" in event:
        event = event.format(file=random.choice(SAMPLE_FILES))
    return event


def send_notification(message):
    if NOTIFY_AVAILABLE:
        try:
            notify2.init("OS Pet Interruption")
            n = notify2.Notification("OSペット通知", message)
            n.set_timeout(5000)
            n.show()
        except Exception as e:
            print(f"[通知失敗] {e}")
            print(f"[OSペット通知] {message}")
    else:
        print(f"[OSペット通知] {message}")


def log_event(message):
    timestamp = time.strftime("%Y-%m-%d %H:%M:%S")
    with open(LOG_PATH, "a", encoding="utf-8") as f:
        f.write(f"[{timestamp}] {message}\n")


def trigger_pet_event():
    message = random_pet_event()
    send_notification(message)
    log_event(message)


def list_events(limit=10):
    if not os.path.exists(LOG_PATH):
        print("まだイベント履歴はありません。")
        return
    with open(LOG_PATH, encoding="utf-8") as f:
        lines = f.readlines()
    for line in lines[-limit:]:
        print(line.strip())


def summary_events():
    if not os.path.exists(LOG_PATH):
        print("まだイベント履歴はありません。")
        return
    counts = {}
    with open(LOG_PATH, encoding="utf-8") as f:
        for line in f:
            for ev in PET_EVENTS:
                key = ev.split("{file}")[0].strip()
                if key and key in line:
                    counts[key] = counts.get(key, 0) + 1
    print("== OSペットイベント集計 ==")
    for k, v in sorted(counts.items(), key=lambda x: -x[1]):
        print(f"{k} ... {v}回")


def random_interval_mode(min_sec=600, max_sec=3600):
    print(f"OSペット乱入イベント自動モード開始 ({min_sec}〜{max_sec}秒間隔)")
    try:
        while True:
            wait = random.randint(min_sec, max_sec)
            time.sleep(wait)
            trigger_pet_event()
    except KeyboardInterrupt:
        print("\n自動モード終了")


def main():
    parser = argparse.ArgumentParser(description="OSペット乱入イベントSkill")
    subparsers = parser.add_subparsers(dest="command")

    parser_trigger = subparsers.add_parser("trigger", help="ランダムにペットイベントを発生させる")
    parser_auto = subparsers.add_parser("auto", help="一定間隔で自動的にペットイベントを発生させる")
    parser_auto.add_argument("--min", type=int, default=600, help="最小間隔(秒)")
    parser_auto.add_argument("--max", type=int, default=3600, 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="イベント発生回数を集計")

    args = parser.parse_args()

    if args.command == "trigger":
        trigger_pet_event()
    elif args.command == "auto":
        random_interval_mode(args.min, args.max)
    elif args.command == "list":
        list_events(args.limit)
    elif args.command == "summary":
        summary_events()
    else:
        parser.print_help()

if __name__ == "__main__":
    main()

references/design_notes.md

# 概要
このSkillは、ユーザーの作業中に完全ランダムで“OSペット乱入”イベントを通知・出力することで、集中力のリセットや癒しを提供します。実際のデスクトップ描画は行わず、通知APIや端末出力のみを利用しています。

# 公式ドキュメント抜粋
- notify2: https://github.com/caronc/apprise
- Python random, argparse, time: https://docs.python.org/ja/3/library/

# 利用例
- `/random-os-fake-system-pet-interruption` コマンドで即時発動
- 長時間操作時に自動発動（autoモード）
- 履歴や集計コマンドで過去の癒しイベントを振り返る

# 注意点
- Linux/WSL/Macでのデスクトップ通知に対応。Windowsでは端末出力のみ。
- 実際のペット描画やアニメーション機能は含まれません。
- ログは ~/.os_pet_events.log に保存されます。

# 設計方針
- シンプルな構造と標準API活用で、どの環境でも動作することを重視。
- 完全ランダムな発動と多様なメッセージで飽きさせない体験を目指しました。

導入手順

この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-system-pet-interruption .claude/skills/random-os-fake-system-pet-interruption

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

3. ファイル配置確認

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

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

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

5. 動作確認

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

こんな瞬間に便利

• session 開始時: 前回までの repo 把握を Claude Code に一発で復元させたい＋癒し演出で気分転換
• monorepo 移動時: packages を跨いだ瞬間に context を切り替えたい＋謎イベントでリセット
• onboarding 時: 新しい repo を Claude Code に把握させ、こちらが path を全部指定する手間を省きたい
• session 再開時: long context が切れた後でも、必要な path と directory 構造だけ素早く戻したい＋OSペットで癒し
• 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 で試した検証ログは 謎のOSペットが突然乱入！Claude Codeで癒しと混乱を体験してみた にまとめる予定 (公開準備中の場合あり)。
あわせて Claude Code 公式ドキュメント と、本シリーズ「Claude Codeを便利にするSkill提案」の他記事も参照のこと。

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

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

• Claude Code 向けのSkill提案・検証記事の一覧はこちら
• AI Coding Agent Skills の全記事の一覧はこちら
• AI Coding Agent (Claude Code / Codex / Antigravity) 全般の記事の一覧はこちら
• お遊び枠 – commit時に猫が鳴く・メニューバー進捗など、通知や演出系のSkill記事の一覧はこちら
• CLAUDE.md / AGENTS.md など常時参照されるSkill・指示ファイルの記事の一覧はこちら
• ai-note がAIで設計したSkillの提案記事一覧の一覧はこちら