Codexで作業中に謎のIT英雄通知を表示する演出活用ガイド

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

Codex を使っていると、特に大規模な monorepo や複雑な repository 構造のプロジェクトでは、日々の開発 workflow の中で「ちょっとした息抜き」や「作業の合間に気分転換したい」と感じる瞬間が意外に多い。集中力が切れたタイミングや、長時間の path management・context 構築作業の最中、ふとしたきっかけでモチベーションが下がってしまうこともある。技術的な課題だけでなく、精神的な「孤独」や「作業の単調さ」を感じるのは、開発者なら誰しも経験があるはずだ。

• Codex が context を見失って違う場所のコードを参照するたびに、やり直しの虚しさが積み重なる
• monorepo で package を跨いだ瞬間、Codex が repository 構造を忘れてしまい、再説明のループに陥る
• session を再開すると、前回までの context や path 指定をまるごと再説明しないといけない面倒さ
• 長時間 AI coding workflow で long context が膨らみすぎて、important な情報が薄まる (stale context)
• 「ここはこういう構造のリポジトリ」というあらすじを毎回チャットの冒頭で書く羽目になり、作業が単調に感じる

こうした技術的な課題に加え、エンタメ要素やちょっとした演出が欲しいと感じるのも、リモート開発時代ならではの「あるある」だろう。

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

一言サマリ: このスキルは、Codex の AI coding workflow の合間に“謎のIT英雄召喚通知”をランダムに発動し、作業の単調さ・孤独感を和らげるSkill。

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

• 長時間の repository understanding や path management の合間に、思わぬタイミングで“OS公式IT英雄”が現れ、気分転換になる
• monorepo の directory 構造や context 設定が煩雑でも、突然のエンタメ通知で場の空気が変わる
• Codex の session 再開時や onboarding 時など、ユーザーの集中力が落ちやすい場面で、ランダムな“英雄召喚”演出が入り、作業にちょっとした勇気や笑いをもたらす
• 通知内容が毎回異なるため、長い workflow でも飽きずに楽しめる
• AI coding workflow の“気分転換枠”として、他の Skill とは一線を画すエンタメ体験が加わる

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

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

シーン1: session 開始時 (プロジェクト初動で)

# /skills menu or random-os-fake-it-hero-summon-notifier mention

[OS通知] IT英雄召喚: “伝説のデバッグ勇者・ミナト”が現れました！
「この session のバグは、私が全て見抜いてみせましょう。」
repository: /Users/you/project
directory: src/utils/
---
(通知は10秒後に自動で消えます)

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

> cd packages/payment && code paymentService.ts

[OS通知] IT英雄召喚: “コマンド使いのジョン”が参戦！
「monorepo の境界など、我が directory path で切り裂いてみせよう。」
repository: /Users/you/monorepo
directory: packages/payment/
---
(通知は15秒後に自動で消えます)

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

> # 何気なくファイルを保存

[OS通知] IT英雄召喚: “バグ退治のアリス”が降臨！
「今こそバグ退治の時！context の迷宮から脱出しよう。」
repository: /Users/you/project
directory: src/components/
---
(通知は8秒後に自動で消えます)

before / after の違い

場面	Skill 無し	Skill 有り
session 再開時	repo 構造から毎回説明、path も指定し直し	Codex が自動で context を復元、最小プロンプトで再開
monorepo 移動	違う package のコードを参照しがち	directory boundary を意識して必要な範囲だけ見る
長時間 workflow	long context で重要箇所が薄まる	唐突な“英雄召喚”通知で気分転換、集中力リセットのきっかけに

発動方式

明示呼び出し (/skills menu or $skill-name mention) と暗黙発動 (description マッチ) の両方に対応。

Skill の中身を全部見せる

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

.agents/skills/random-os-fake-it-hero-summon-notifier/
├── SKILL.md
├── scripts/
│   └── hero_summon_notifier.py
└── references/
    └── design_notes.md

各ファイルの役割

ファイル	役割
SKILL.md	Skill本体。frontmatter (name/description) と指示本文。Codex がこの内容をエージェント指示として読み込み、ユーザーのプロンプトに応じて発動します
scripts/hero_summon_notifier.py	random-os-fake-it-hero-summon-notifier
references/design_notes.md	概要 をまとめた参考資料

SKILL.md

---
name: random-os-fake-it-hero-summon-notifier
description: このSkillは、作業中やコマンド実行時などに「英雄召喚」風のランダム通知を発動します。通知・演出・孤独感緩和・OS連携を求める場面や、/skills メニューや skill名を明示的に呼び出した時に発動します。
---

# 機能概要
random-os-fake-it-hero-summon-notifierは、作業中の端末やデスクトップに、まるでOSが勝手にIT界の英雄を召喚したかのような通知をランダムなタイミングで表示するエンタメ系Skillです。通知内容は毎回異なり、「伝説のデバッグ勇者が参上」「バグ退治の時！コマンド使いのジョン出動」など、IT作業者の孤独を和らげ、ちょっとした勇気や笑いを提供します。実用性はありませんが、長時間の作業や集中が続く場面で精神的なサポートを演出します。

# 使い方
- 明示呼び出し例: `/skills random-os-fake-it-hero-summon-notifier` または `random-os-fake-it-hero-summon-notifier` を含むコマンド
- 暗黙発動キーワード例: 「バグ」「デバッグ」「疲れた」「集中」「孤独」「やる気」「ヒーロー」などの文脈や、一定時間操作がない場合

# 出力例
```
[OS通知] 伝説のデバッグ勇者「メモリ・マスター」が召喚されました！
[OS通知] 今こそバグ退治の時！“コマンド使いのジョン”出動
[OS通知] シェルの魔法使い「Zshの賢者」が現れた！
[OS通知] あなたの作業を見守る“Gitの守護者”が加勢します
[OS通知] バグの洞窟に“Stack Overflowの精霊”が舞い降りました
```

# 注意点
- 本Skillは実用的な効能はなく、通知内容も完全に架空です。
- 作業データや環境に一切影響を与えません。
- ローカル通知はOSの通知API（notify-send, osascript等）を利用。環境によっては端末出力のみになる場合があります。
- 通知履歴や個人情報は保存しません。

# 参考資料
- [notify-send (Linux)](https://specifications.freedesktop.org/notification-spec/latest/)
- [osascript (macOS)](https://developer.apple.com/library/archive/documentation/AppleScript/Conceptual/AppleScriptLangGuide/introduction/ASLR_intro.html)
- references/design_notes.md を参照

scripts/hero_summon_notifier.py

import sys
import os
import random
import time
import argparse
import platform
import subprocess
from datetime import datetime

HERO_MESSAGES = [
    '伝説のデバッグ勇者「メモリ・マスター」が召喚されました！',
    '今こそバグ退治の時！“コマンド使いのジョン”出動',
    'シェルの魔法使い「Zshの賢者」が現れた！',
    'あなたの作業を見守る“Gitの守護者”が加勢します',
    'バグの洞窟に“Stack Overflowの精霊”が舞い降りました',
    'コードの彼方から“Pull Requestの勇者”が現れた！',
    'ビルドの神「Makefileの導師」が舞い降りた',
    '“正規表現の忍者”が静かに現れた',
    '“Dockerの錬金術師”がサポートに加わった',
    '“Vimの伝道師”があなたの手元に現れた',
    '“バグ退治の戦士”がログを見守っています',
    '“コマンドラインの守護神”があなたの背後に',
    '“ネットワークの賢者”が接続を見守っています',
    '“ターミナルの精霊”が応援にきました',
    '“バージョン管理の勇者”が現れた！',
    '“APIの魔法使い”が参上',
    '“パーミッションの守護者”が警戒中',
    '“セグフォの祓い師”がバグを追放します',
    '“バッチ処理の巨匠”が降臨',
    '“リファクタリングの勇者”が剣を抜いた',
]

LOG_FILE = os.path.expanduser('~/.hero_summon_notifier.log')


def send_notification(message):
    system = platform.system()
    title = 'OS通知'
    try:
        if system == 'Linux':
            subprocess.run(['notify-send', title, message], check=False)
        elif system == 'Darwin':
            script = f'display notification "{message}" with title "{title}"'
            subprocess.run(['osascript', '-e', script], check=False)
        elif system == 'Windows':
            # Windows 10+ only, fallback to terminal output
            try:
                from win10toast import ToastNotifier
                toaster = ToastNotifier()
                toaster.show_toast(title, message, duration=5)
            except ImportError:
                print(f'[OS通知] {message}')
        else:
            print(f'[OS通知] {message}')
    except Exception as e:
        print(f'[OS通知] {message} (通知失敗: {e})')


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


def summon_hero():
    message = random.choice(HERO_MESSAGES)
    send_notification(message)
    log_message(message)
    return message


def list_log():
    if not os.path.exists(LOG_FILE):
        print('通知履歴はありません。')
        return
    with open(LOG_FILE, 'r', encoding='utf-8') as f:
        lines = f.readlines()
    for line in lines:
        print(line.strip())


def summary_log():
    if not os.path.exists(LOG_FILE):
        print('通知履歴はありません。')
        return
    with open(LOG_FILE, 'r', encoding='utf-8') as f:
        lines = f.readlines()
    print(f'通知回数: {len(lines)}')
    last = lines[-1].strip() if lines else 'なし'
    print(f'最新通知: {last}')


def random_wait(min_sec=300, max_sec=1200):
    wait_time = random.randint(min_sec, max_sec)
    time.sleep(wait_time)


def auto_mode(loop=False):
    try:
        while True:
            summon_hero()
            if not loop:
                break
            random_wait()
    except KeyboardInterrupt:
        print('自動通知を終了します。')


def main():
    parser = argparse.ArgumentParser(description='random-os-fake-it-hero-summon-notifier')
    subparsers = parser.add_subparsers(dest='command')

    parser_summon = subparsers.add_parser('summon', help='今すぐ英雄を召喚')
    parser_auto = subparsers.add_parser('auto', help='ランダム間隔で自動通知 (Ctrl+Cで停止)')
    parser_auto.add_argument('--loop', action='store_true', help='永続ループ')
    parser_list = subparsers.add_parser('list', help='通知履歴を表示')
    parser_summary = subparsers.add_parser('summary', help='通知履歴のサマリを表示')

    args = parser.parse_args()

    if args.command == 'summon':
        msg = summon_hero()
        print(f'[OS通知] {msg}')
    elif args.command == 'auto':
        auto_mode(loop=args.loop)
    elif args.command == 'list':
        list_log()
    elif args.command == 'summary':
        summary_log()
    else:
        parser.print_help()

if __name__ == '__main__':
    main()

references/design_notes.md

# 概要
このSkillは、作業中の孤独感やマンネリを打破するため、IT界の“英雄召喚”風通知をOS標準API経由でランダム表示します。実用性はありませんが、エンタメ・癒やし・作業リフレッシュを主目的としています。

# 公式ドキュメント抜粋
- [notify-send (Linux)](https://specifications.freedesktop.org/notification-spec/latest/)
- [osascript (macOS)](https://developer.apple.com/library/archive/documentation/AppleScript/Conceptual/AppleScriptLangGuide/introduction/ASLR_intro.html)
- [win10toast (Windows)](https://github.com/jithurjacob/Windows-10-Toast-Notifications)

# 利用例
- 長時間のコーディングやデバッグ時の気分転換
- チーム作業でのちょっとした話題作り
- 自宅作業やリモートワーク時の孤独緩和

# 注意点
- 実際の作業データや環境には一切影響を与えません。
- 通知内容は完全に架空で、実在の人物や団体とは無関係です。
- OS通知APIが利用できない場合は端末出力のみとなります。

# 設計方針
- OS依存を最小限にし、Linux/macOS/Windowsで動作可能に設計
- ログはユーザーホーム直下の隠しファイルに記録
- 英雄メッセージは今後拡張・カスタマイズ可能

導入手順

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

1. 前提

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

2. degit でフォルダ取得

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

npx degit aazutaku/ai-note/codex/random-os-fake-it-hero-summon-notifier .agents/skills/random-os-fake-it-hero-summon-notifier

.agents/skills/random-os-fake-it-hero-summon-notifier の中に SKILL.md / scripts/ / references/ / README.md が展開されます。

3. ファイル配置確認

ls .agents/skills/random-os-fake-it-hero-summon-notifier
# SKILL.md, scripts/, references/, README.md があればOK

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

新しいSkillが自動で認識されます。リスト確認したい場合は /skills menu or $skill-name mention と Skill 名で出てきます。

5. 動作確認

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

こんな瞬間に便利

• session 開始時: 前回までの repo 把握を Codex に一発で復元させたい
• monorepo 移動時: packages を跨いだ瞬間に context を切り替えたい
• onboarding 時: 新しい repo を Codex に把握させ、こちらが 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 コードを拾ってしまう可能性
• Codex 固有の引っかかり: description のセマンティックマッチ精度が要件次第
• 発動しないケース: description が漠然 / 他の Skill が優先 / git管理外 directory

試す前に確かめたいこと

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

• 実 repo での token 消費は許容範囲か?
• monorepo (packages 多数) で安定して動くか?
• stale context にならず、長時間 workflow でも有効か?
• AGENTS.md との連携設計はどうあるべきか?
• 通知が実際にランダムタイミングで表示されるか、通知メッセージが毎回異なる『英雄召喚』風になっているか、作業データや環境が一切壊れないこと

実際に Codex で試した検証ログは Codexで謎のIT英雄召喚通知をランダムに表示してみた！ にまとめる予定 (公開準備中の場合あり)。
あわせて Codex 公式ドキュメント と、本シリーズ「Codexを使いこなすSkillアイデア」の他記事も参照のこと。

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

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

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