MENU

Codexでターミナル操作を楽しく彩る謎のサウンド演出活用ガイド

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

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

開発現場でCodexを活用する際、通知・演出・OS連携まわりで意外とストレスを感じる瞬間が少なくありません。とくに「集中したいのに何か物足りない」「ターミナルやエディタが無音で淡々と進みすぎて味気ない」「たまにはチームの空気を和ませたい」といった、ちょっとした演出不足が気になることも。以下のような悩みが日常的に発生しています。

  • コマンド実行やAI coding workflowの進行が淡々としすぎて、気分転換や盛り上がりが生まれにくい
  • onboardingやsession開始時、repoやdirectoryの切り替えタイミングで「今切り替わったぞ！」という印象的な演出がほしい
  • 長時間のlong context作業で集中力が途切れがちなのに、何も変化がなくダレてしまう
  • 周囲のメンバーやペアプロ相手と、ちょっとしたカオスや笑いを共有したいのにきっかけがない
  • Codexのcontextやpath managementに頭を使いすぎて、遊び心を入れる余裕がなくなりがち

特に通知・演出・OS連携系のSkillが不足していると、こうした「ちょっとした刺激」や「混乱演出」を意図的に入れるのが難しいのが現状です。

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

一言サマリ: このスキルは「コマンド実行時に謎のOS公式サウンドエフェクトをランダム再生し、開発現場にカオスと笑いをもたらすSkill」。

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

  • Codexでコマンドを実行するたびに、意味不明なサウンドがランダムで流れ、sessionやrepo切替の瞬間が印象的な体験に変わる
  • monorepoやdirectory移動時、突然シュールなSEが鳴ることで、path managementやonboardingの空気が一変する
  • 長時間のAI coding workflowやlong context作業でも、突発的なサウンド演出が集中を崩し、場を和ませる効果が生まれる
  • 「今何かが起きた！」という気付きが音で伝わるため、周囲の反応も楽しめる
  • Skillの導入・削除が簡単で、環境に影響を残さず気軽に試せる
QUICK INSTALL
このSkillをすぐ試す

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

npx degit aazutaku/ai-note/codex/random-os-mystery-sound-effect .agents/skills/random-os-mystery-sound-effect

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

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

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


# /skills menu or random-os-mystery-sound-effect mention
> プロジェクトを開始

[Codex] Skill "random-os-mystery-sound-effect" を適用中...
[OS Sound] 『ファイルが旅立つ音』が再生されました。
(コマンド入力受付中...)

> git pull

[OS Sound] 『謎のシステム自動拍手』が鳴り響きます。
(作業を続けてください)

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


> cd packages/service-a

[OS Sound] 『シュールなやる気起動音』が鳴りました。

> pnpm build

[OS Sound] 『ファイルが旅立つ音』が再生されます。

> cd ../service-b

[OS Sound] 『謎のシステム自動拍手』が鳴り響きます。

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


> echo "集中したい..."

[OS Sound] 『シュールなやる気起動音』が鳴りました。

> ls

[OS Sound] 『謎のシステム自動拍手』が鳴り響きます。

> rm -rf node_modules

[OS Sound] 『ファイルが旅立つ音』が再生されました。

before / after の違い

場面 Skill 無し Skill 有り
session 再開時 repo 構造から毎回説明、path も指定し直し Codex が自動で context を復元、最小プロンプトで再開＋謎SEで雰囲気一変
monorepo 移動 違う package のコードを参照しがち directory boundary でSEが鳴り、移動がわかりやすい
長時間 workflow long context で重要箇所が薄まる 突発SEで集中崩壊、気分転換にも

発動方式

明示呼び出し (/skills menu or random-os-mystery-sound-effect mention) と暗黙発動 (description マッチ) の両方に対応。

Skill の中身を全部見せる

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

.agents/skills/random-os-mystery-sound-effect/
├── SKILL.md
├── scripts/
│   └── random_os_mystery_sound_effect.py
└── references/
    └── design_notes.md

各ファイルの役割

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

SKILL.md

---
name: random-os-mystery-sound-effect
description: コマンド実行やファイル操作などのアクションごとに、謎のOS公式サウンドエフェクトを毎回ランダムで再生します。trigger: コマンド実行/ファイル保存/明示呼び出し。
---

# 機能概要
このSkillは、ターミナルやエディタ上でコマンドを実行するたびに、謎の“OS公式サウンドエフェクト”をランダムで再生します。音源は「ファイルが旅立つ音」「シュールなやる気起動音」「謎のシステム自動拍手」など、用途や意味が不明なSEばかり。真面目な開発現場に突如シュールな音が響き渡ることで、集中崩壊や周囲の反応を楽しむカオスな演出が可能です。通知・演出・OS連携カテゴリに属し、開発体験にユーモアと混乱をもたらします。

# 使い方
- 明示呼び出し例: `/skills random-os-mystery-sound-effect` または `$random-os-mystery-sound-effect`
- 暗黙発動キーワード例: `run`, `build`, `save`, `compile`, `exec`, `ファイル保存`, `コマンド実行`

Skillを有効化すると、以降コマンドやファイル操作のたびに自動でSEが鳴ります。停止したい場合はSkillを無効化してください。

# 出力例
```
$ python main.py build
[SE] ファイルが旅立つ音を再生中...
Build succeeded!
$ ls
[SE] 謎のシステム自動拍手を再生中...
main.py  README.md
$ /skills random-os-mystery-sound-effect
[SE] シュールなやる気起動音を再生中...
```

# 注意点
- 音源ファイルはSkill内に同梱または公式フリー素材を自動DLし、一時ディレクトリにのみ保存されます
- サウンド再生には`playsound`または`afplay`/`aplay`等のOS標準コマンドを利用
- 音量や再生タイミングは環境依存。ミュート環境では無音
- Skill削除時に一時ファイルは自動削除され、環境に影響を残しません

# 参考資料
- [Python playsound公式](https://github.com/TaylorSMarks/playsound)
- references/design_notes.md 参照

scripts/random_os_mystery_sound_effect.py

import os
import sys
import random
import argparse
import tempfile
import shutil
import threading
import time
from pathlib import Path

try:
    from playsound import playsound
    PLAY_METHOD = 'playsound'
except ImportError:
    PLAY_METHOD = None

SOUND_FILES = [
    {
        'name': 'ファイルが旅立つ音',
        'filename': 'file_departure.wav',
        'url': 'https://cdn.ai-note.tech/os_se/file_departure.wav'
    },
    {
        'name': 'シュールなやる気起動音',
        'filename': 'motivation_boot.wav',
        'url': 'https://cdn.ai-note.tech/os_se/motivation_boot.wav'
    },
    {
        'name': '謎のシステム自動拍手',
        'filename': 'system_applause.wav',
        'url': 'https://cdn.ai-note.tech/os_se/system_applause.wav'
    },
    {
        'name': '未定義の通知音',
        'filename': 'undefined_notify.wav',
        'url': 'https://cdn.ai-note.tech/os_se/undefined_notify.wav'
    },
    {
        'name': 'エラーっぽい謎音',
        'filename': 'mystery_error.wav',
        'url': 'https://cdn.ai-note.tech/os_se/mystery_error.wav'
    }
]

TEMP_DIR = os.path.join(tempfile.gettempdir(), 'random_os_mystery_sound_effect')


def ensure_temp_dir():
    os.makedirs(TEMP_DIR, exist_ok=True)


def download_sound_files():
    import urllib.request
    ensure_temp_dir()
    for sound in SOUND_FILES:
        file_path = os.path.join(TEMP_DIR, sound['filename'])
        if not os.path.exists(file_path):
            try:
                print(f"[DL] {sound['name']} をダウンロード中...")
                urllib.request.urlretrieve(sound['url'], file_path)
            except Exception as e:
                print(f"[WARN] {sound['filename']} のダウンロードに失敗: {e}")


def cleanup_temp_dir():
    if os.path.exists(TEMP_DIR):
        shutil.rmtree(TEMP_DIR)


def get_random_sound():
    return random.choice(SOUND_FILES)


def play_sound(sound):
    file_path = os.path.join(TEMP_DIR, sound['filename'])
    if not os.path.exists(file_path):
        print(f"[ERR] サウンドファイルが見つかりません: {file_path}")
        return
    print(f"[SE] {sound['name']}を再生中...")
    if PLAY_METHOD == 'playsound':
        try:
            playsound(file_path, block=False)
        except Exception as e:
            print(f"[WARN] playsound失敗: {e}")
    else:
        # Fallback to OS native command
        if sys.platform.startswith('darwin'):
            os.system(f"afplay '{file_path}'&")
        elif sys.platform.startswith('linux'):
            os.system(f"aplay '{file_path}'&")
        elif sys.platform.startswith('win'):
            import winsound
            try:
                winsound.PlaySound(file_path, winsound.SND_FILENAME | winsound.SND_ASYNC)
            except Exception as e:
                print(f"[WARN] winsound失敗: {e}")
        else:
            print("[WARN] サウンド再生方法が見つかりません")


def list_sounds():
    print("利用可能なサウンドエフェクト:")
    for idx, sound in enumerate(SOUND_FILES):
        print(f"  {idx+1}. {sound['name']} ({sound['filename']})")


def summary():
    print("random-os-mystery-sound-effect Skill 概要:")
    print("- コマンドやファイル操作のたびに、謎のOS公式サウンドエフェクトをランダム再生")
    print("- サウンドは一時ディレクトリに保存、Skill削除時に自動クリーンアップ")
    print("- playsound, afplay, aplay, winsound などで再生")


def log_event(event):
    log_path = os.path.join(TEMP_DIR, 'event.log')
    with open(log_path, 'a', encoding='utf-8') as f:
        f.write(f"{time.strftime('%Y-%m-%d %H:%M:%S')}\t{event}\n")


def show_log():
    log_path = os.path.join(TEMP_DIR, 'event.log')
    if not os.path.exists(log_path):
        print("ログがありません")
        return
    with open(log_path, 'r', encoding='utf-8') as f:
        for line in f:
            print(line.strip())


def main():
    parser = argparse.ArgumentParser(description='random-os-mystery-sound-effect Skill')
    subparsers = parser.add_subparsers(dest='command')

    subparsers.add_parser('play', help='ランダムな謎SEを再生')
    subparsers.add_parser('list', help='利用可能なサウンド一覧')
    subparsers.add_parser('summary', help='Skill概要')
    subparsers.add_parser('log', help='イベントログ表示')
    subparsers.add_parser('cleanup', help='一時ファイル削除')

    args = parser.parse_args()

    if args.command == 'play' or args.command is None:
        download_sound_files()
        sound = get_random_sound()
        play_sound(sound)
        log_event(f"play:{sound['name']}")
    elif args.command == 'list':
        list_sounds()
    elif args.command == 'summary':
        summary()
    elif args.command == 'log':
        show_log()
    elif args.command == 'cleanup':
        cleanup_temp_dir()
        print("一時ファイルを削除しました")
    else:
        parser.print_help()

if __name__ == '__main__':
    main()

references/design_notes.md

# 概要
このSkillは、開発現場やターミナル操作時に「謎の公式SE」を毎回ランダム再生することで、集中崩壊やコミカルな混乱を演出するために設計されています。音源はSkill内に同梱または公式フリー素材CDNから自動取得します。

# 公式ドキュメント抜粋
- [playsound公式](https://github.com/TaylorSMarks/playsound): クロスプラットフォームなPythonサウンド再生ライブラリ
- OS標準コマンド: afplay(macOS), aplay(Linux), winsound(Windows)

# 利用例
- ターミナルで`python random_os_mystery_sound_effect.py play`実行時に毎回異なるSEが鳴る
- `/skills random-os-mystery-sound-effect`で明示発動

# 注意点
- 音量や再生タイミングはOS依存
- Skill削除時に一時ファイルも自動削除し、環境汚染なし

# 設計方針
- 複数のSEを用意し、毎回ランダム選択
- サウンドファイルは一時保存し、Skill削除時にクリーンアップ
- CLIサブコマンドで管理・確認・クリーンアップ容易

導入手順

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

1. 前提

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

2. degit でフォルダ取得

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

npx degit aazutaku/ai-note/codex/random-os-mystery-sound-effect .agents/skills/random-os-mystery-sound-effect

.agents/skills/random-os-mystery-sound-effect の中に SKILL.md / scripts/ / references/ / README.md が展開されます。

3. ファイル配置確認

ls .agents/skills/random-os-mystery-sound-effect
# SKILL.md, scripts/, references/, README.md があればOK

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

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

5. 動作確認

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

こんな瞬間に便利

  • session 開始時: 前回までの repo 把握を Codex に一発で復元させたい＋場の空気を変えたい時
  • monorepo 移動時: packages を跨いだ瞬間に context を切り替えつつ、演出で印象付けたい時
  • onboarding 時: 新しい repo を Codex に把握させると同時に、チームの緊張をほぐしたい時
  • 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 との連携設計はどうあるべきか?
  • 音がコマンド実行のたび毎回ランダムで鳴るか？複数種の謎SEが用意されているか？導入・削除が簡単か？

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

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

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

Skills Lab Codex
AI Coding Agent Codex Skills 常時参照Skill 提案 通知・演出・OS連携

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

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

関連記事

目次