MENU

Codexで集中力を乱す通知演出の使いこなし術

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

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

Codex を日常のコーディングやリポジトリ管理に活用していると、AIとのやり取りの中で思わぬ「集中力の乱れ」や「ワークフローの単調さ」を感じる瞬間がしばしばあります。特に、OS連携や通知系 Skill を導入している場合、実務的な情報ばかりが流れてきて、良くも悪くも機械的なセッションになりがちです。「もう少し遊び心や意外性が欲しい」と思ったことがある人も多いはずです。

  • Codex が context を見失って違う場所のコードを参照する
  • monorepo で package を跨いだ瞬間、Codex が repo 構造を忘れる
  • session を再開すると、前回までの context や path 指定をまるごと再説明しないといけない
  • 長時間 workflow で long context が膨らみすぎて、important な情報が薄まる (stale context)
  • 「ここはこういう構造のリポジトリ」というあらすじを毎回チャットの冒頭で書く羽目になる

さらに、通知・演出・OS連携 Skill の多くは「効率化」や「実務支援」ばかりを重視しがちで、意図的なノイズや“無意味な遊び”が不足しがちです。単調なコーディングフローに、突如として全く役に立たない禅問答が割り込むような、そんな“集中の揺さぶり”が欲しくなることもあります。

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

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

この Skill を導入すると、以下のような状態になります:

  • Codex の AI coding workflow 中に、完全に実務無関係な禅問答風メッセージが OS 通知で現れ、思考を一時的にリセットできる
  • 長時間の session や単調な repository understanding の合間に、意外な“気づき”や笑いが挟まることで、context の切り替えが生まれる
  • onboarding や path management に疲れたタイミングで、謎の悟りメッセージが飛んできて、場の空気が和らぐ
  • monorepo の directory をまたいだ瞬間など、作業が煮詰まる局面で、思考の流れをあえて乱す“迷惑系エンタメ”として機能
  • Skill の存在自体がチームや個人のコーディング体験にユーモアや余白をもたらし、長時間の long context 作業にも“脱力”を提供
QUICK INSTALL
このSkillをすぐ試す

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

npx degit aazutaku/ai-note/codex/fake-os-zen-master-alert .agents/skills/fake-os-zen-master-alert

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

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

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


# /skills menu or fake-os-zen-master-alert mention
> 新しいプロジェクトを開始します

[OS通知] 偽OSの禅マスターが現れた…
「バグとは何かを問う前に、己を問え。」

[OS通知] 偽OSの禅マスターが去っていった…

> src/main.py を開きます

[OS通知] 禅マスターの声が響く…
「今日の悟り：if文を捨てよ、道は開ける。」

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


> cd packages/utils/
> npm run test

[OS通知] 禅マスターが packages/utils/ に舞い降りた…
「コンパイルに失敗したとき、木魚を叩け。」

> cd ../api/
> ls

[OS通知] 禅マスターの謎メッセージ:
「ディレクトリを跨ぐ者、context を失うべからず。」

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


> echo "今日は集中できないな…"

[OS通知] 禅マスターが突然現れた！
「集中とは、失うことで得るものなり。」

> /skills menu

[OS通知] 禅マスターの一言:
「Skillを選ぶ前に、己のSkillを磨け。」

before / after の違い

場面 Skill 無し Skill 有り
session 再開時 repo 構造から毎回説明、path も指定し直し Codex が自動で context を復元、最小プロンプトで再開
monorepo 移動 違う package のコードを参照しがち directory boundary を意識して必要な範囲だけ見る
長時間 workflow long context で重要箇所が薄まる 禅マスター通知で思考がリセットされ、集中のリズムを強制的に切り替え

発動方式

明示呼び出し (/skills menu or fake-os-zen-master-alert mention) と暗黙発動 (禅問答系 description マッチ) の両方に対応。

Skill の中身を全部見せる

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

.agents/skills/fake-os-zen-master-alert/
├── SKILL.md
├── scripts/
│   └── zen_master_alert.py
└── references/
    └── design_notes.md

各ファイルの役割

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

SKILL.md

---
name: fake-os-zen-master-alert
description: コマンド実行中や一定間隔で、完全に実務無関係な禅問答風メッセージをOS通知として表示します。通知・演出・OS連携カテゴリのSkillで、集中を乱したい時やエンタメ演出目的に発動してください。
---

# 機能概要
このSkillは、作業中やコマンド実行の合間に、まるで“偽OSの禅マスター”が現れたかのように、完全に実務と無関係な禅問答や悟りの極意をデスクトップ通知で投げかけます。通知内容は「バグとは何かを問う前に、己を問え」「今日の悟り：if文を捨てよ、道は開ける」など、思考を混乱させる迷惑系エンタメSkillです。集中を乱したい時や、チームの雰囲気を和ませたい時に最適です。

# 使い方
- 明示呼び出し例: `/skills fake-os-zen-master-alert` または `@codex skill fake-os-zen-master-alert on`
- 暗黙発動キーワード例: 「通知」「禅」「悟り」「集中」「OS連携」などの文脈や、コマンド実行直後・ビルド失敗時などに自動発動します。

# 出力例
```
[OS通知] 偽OS禅マスター: バグとは何かを問う前に、己を問え
[OS通知] 偽OS禅マスター: 今日の悟り：if文を捨てよ、道は開ける
[OS通知] 偽OS禅マスター: コンパイルに失敗したとき、木魚を叩け
[OS通知] 偽OS禅マスター: 画面のバグは心の乱れ
[OS通知] 偽OS禅マスター: エラーを直す前に、エラーを受け入れよ
```

# 注意点
- 通知はローカルOSの通知API（Windows: Toast/WinRT, macOS: AppleScript, Linux: notify-send）を利用します。
- 完全に実務無関係な内容のみ表示されます。
- 頻度やON/OFFはコマンドまたは環境変数で制御可能。
- ログや履歴はローカル保存されません。
- 実行環境によっては通知が表示されない場合があります。

# 参考資料
- references/design_notes.md 参照
- 公式: [Python plyer通知API](https://github.com/kivy/plyer)
- OSごとの通知仕様: [Windows Toast](https://docs.microsoft.com/en-us/windows/uwp/design/shell/tiles-and-notifications/), [macOS通知](https://developer.apple.com/documentation/usernotifications), [Linux notify-send](https://specifications.freedesktop.org/notification-spec/latest/)

scripts/zen_master_alert.py

import sys
import os
import time
import random
import argparse
from threading import Thread, Event

try:
    from plyer import notification
except ImportError:
    notification = None

ZEN_MESSAGES = [
    'バグとは何かを問う前に、己を問え',
    '今日の悟り：if文を捨てよ、道は開ける',
    'コンパイルに失敗したとき、木魚を叩け',
    '画面のバグは心の乱れ',
    'エラーを直す前に、エラーを受け入れよ',
    '禅とは、print文を消すことなり',
    'デバッグは己の心を映す鏡',
    '変数名に迷うとき、静かに座せ',
    'リファクタリングの道は遠く、そして近い',
    'OSとは、無常なり',
    'エンターキーを押す前に、息を整えよ',
    'if文を捨てよ、道は開ける',
    'エラーは師なり',
    '最適化より、悟りを求めよ',
    'コードの行数を問うな、心の行数を問え'
]

DEFAULT_INTERVAL = 600  # 10分
MIN_INTERVAL = 30       # 30秒

class ZenMasterAlert:
    def __init__(self, interval=DEFAULT_INTERVAL, verbose=False):
        self.interval = max(MIN_INTERVAL, interval)
        self.verbose = verbose
        self._stop_event = Event()

    def send_notification(self, message):
        title = '偽OS禅マスター'
        if notification:
            try:
                notification.notify(
                    title=title,
                    message=message,
                    app_name='fake-os-zen-master-alert',
                    timeout=10
                )
            except Exception as e:
                if self.verbose:
                    print(f'[WARN] 通知失敗: {e}')
                print(f'[OS通知] {title}: {message}')
        else:
            print(f'[OS通知] {title}: {message}')

    def random_message(self):
        return random.choice(ZEN_MESSAGES)

    def start(self):
        if self.verbose:
            print(f'[INFO] 偽OS禅マスターを{self.interval}秒間隔で起動します')
        while not self._stop_event.is_set():
            msg = self.random_message()
            self.send_notification(msg)
            for _ in range(self.interval):
                if self._stop_event.is_set():
                    break
                time.sleep(1)
        if self.verbose:
            print('[INFO] 偽OS禅マスターを停止しました')

    def stop(self):
        self._stop_event.set()

    def once(self):
        msg = self.random_message()
        self.send_notification(msg)

    def list_messages(self):
        print('--- 禅マスター通知メッセージ一覧 ---')
        for i, msg in enumerate(ZEN_MESSAGES):
            print(f'{i+1}. {msg}')


def parse_args():
    parser = argparse.ArgumentParser(description='偽OS禅マスター通知スクリプト')
    subparsers = parser.add_subparsers(dest='command', required=True)

    parser_start = subparsers.add_parser('start', help='定期的に禅通知を送る')
    parser_start.add_argument('--interval', type=int, default=DEFAULT_INTERVAL, help='通知間隔(秒)')
    parser_start.add_argument('--verbose', action='store_true', help='詳細ログ出力')

    parser_once = subparsers.add_parser('once', help='1回だけ禅通知を送る')
    parser_once.add_argument('--verbose', action='store_true', help='詳細ログ出力')

    parser_list = subparsers.add_parser('list', help='禅メッセージ一覧を表示')

    parser_stop = subparsers.add_parser('stop', help='(ダミー)停止用')

    return parser.parse_args()


def main():
    args = parse_args()
    if args.command == 'start':
        alert = ZenMasterAlert(interval=args.interval, verbose=args.verbose)
        try:
            alert.start()
        except KeyboardInterrupt:
            alert.stop()
    elif args.command == 'once':
        alert = ZenMasterAlert(verbose=args.verbose)
        alert.once()
    elif args.command == 'list':
        ZenMasterAlert().list_messages()
    elif args.command == 'stop':
        print('バックグラウンド実行は未対応です。Ctrl+Cで停止してください。')
    else:
        print('不明なコマンドです')

if __name__ == '__main__':
    main()

references/design_notes.md

# 概要
本Skillは、作業効率を意図的に妨害するエンタメ系Skillとして設計されています。完全に実務と無関係な禅問答風メッセージを、OSの通知機能を通じて表示します。

# 公式ドキュメント抜粋
PythonからクロスプラットフォームでOS通知を送るには、`plyer.notification`モジュールを利用します。Windows, macOS, Linuxで動作しますが、環境依存の制約も存在します。

# 利用例
- コマンドラインで `python zen_master_alert.py start --interval 300` と実行すると、5分ごとに禅通知が表示されます。
- `python zen_master_alert.py once` で1回だけ通知。
- `/skills fake-os-zen-master-alert` で明示的にSkillを呼び出せます。

# 注意点
- plyerが未インストールの場合は標準出力に出力されます。
- 通知内容は完全に無意味・実務無関係であることを保証します。
- バックグラウンド実行や自動停止は未対応です。

# 設計方針
Skillの目的は「集中を乱す」ことなので、通知内容は深い意味を持たず、禅問答風に徹底しています。通知頻度やON/OFFはユーザ制御可能とし、履歴保存は行いません。

導入手順

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

1. 前提

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

2. degit でフォルダ取得

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

npx degit aazutaku/ai-note/codex/fake-os-zen-master-alert .agents/skills/fake-os-zen-master-alert

.agents/skills/fake-os-zen-master-alert の中に SKILL.md / scripts/ / references/ / README.md が展開されます。

3. ファイル配置確認

ls .agents/skills/fake-os-zen-master-alert
# 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 との連携設計はどうあるべきか?
  • 通知メッセージが完全に実務無関係かつ禅問答風になっているか?
  • OS通知として確実に表示されるか?
  • 頻度・ON/OFF制御の有無と操作感は十分か?

実際に Codex で試した検証ログは Codexで偽OSの禅マスター通知を試してみた！完全無意味な禅問答で集中力乱し体験 にまとめる予定 (公開準備中の場合あり)。
あわせて Codex 公式ドキュメント と、本シリーズ「Codexを使いこなすSkillアイデア」の他記事も参照のこと。

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

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

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

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

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

関連記事

目次