Codex ユーザーが日常でぶつかる悩み
AIコーディングエージェントであるCodexを日々使っていると、真面目な開発現場でも思わず「またか…」と感じる瞬間が多々あります。特に、通知や演出機能に関する悩みは、集中力の維持や気分転換、チームの雰囲気作りに直結します。例えば、長時間の作業で集中力が切れがちなタイミングや、単調なリファクタリングタスク中にちょっとした変化が欲しくなることもあるでしょう。以下のような「あるある」な悩みが挙げられます。
- Codex が context を見失って違う場所のコードを参照する
- monorepo で package を跨いだ瞬間、Codex が repo 構造を忘れる
- session を再開すると、前回までの context や path 指定をまるごと再説明しないといけない
- 長時間 workflow で long context が膨らみすぎて、important な情報が薄まる (stale context)
- 「ここはこういう構造のリポジトリ」というあらすじを毎回チャットの冒頭で書く羽目になる
また、単調な開発フローにちょっとした遊び心や意外性が欲しい、というニーズも現場では意外と多いものです。集中力が途切れた時や、チームの空気を和ませたい時に、ちょっとしたネタ要素のある通知が挟まったら…そんな「一瞬の混乱と笑い」が、実は開発現場の潤滑油になることもあります。
この Skill が一言でいうと何を解決するか
一言サマリ: このスキルは、Codex の日常 workflow に「謎の陰謀論アラート」をデスクトップ通知として爆誕させ、開発現場に一瞬の笑いと気分転換をもたらします。
もう少し具体化すると、このSkillを入れることで以下のような状態になる:
- 長時間のAI coding workflow中に、完全ランダムなネタ通知で気分転換できる (context切れをリフレッシュ)
- monorepoや複雑なrepository構造での作業に、突如現れるアラートが場の空気を和らげる
- onboardingやsession再開時に、堅苦しい説明の合間に「意味不明な陰謀論」が挟まることで、場が和む
- Skillのトリガーは明示・暗黙どちらも対応、自然な流れでサプライズ演出が可能
- 通知内容は毎回完全ランダム、同じものが出ないので飽きにくい
GitHub から degit でコマンド1行、Codex の Skill ディレクトリに展開できます。Node.js があれば即時に動きます。
npx degit aazutaku/ai-note/codex/random-desktop-conspiracy-alert .agents/skills/random-desktop-conspiracy-alert実行したらこうなる (3つの利用シーン)
使う側がイメージしやすいよう、擬似 terminal で出力例を3パターン示す。Skill が返す出力は推測だが、現実的なフォーマット・現実的な長さで書く。
シーン1: session 開始時 (プロジェクト初動で)
# /skills menu or random-desktop-conspiracy-alert mention
> 新しいプロジェクトで作業開始
[通知] 謎の陰謀論アラート:
"Wi-Fiの波動が main.py の変数スコープに干渉しています。電磁防御を推奨します。"
[Codex] repository understanding: root directory = /Users/you/new-project
[Codex] context: onboarding phase, directory structure loaded.
シーン2: monorepo / package 跨ぎ作業時
> packages/api から packages/web へ移動
[通知] 謎の陰謀論アラート:
"本日15時、全てのバグが覚醒します。packages/web/src/handlers/ を監視してください。"
[Codex] context updated: monorepo boundary detected, switching active package.
[Codex] path management: repository structure reloaded.
シーン3: お遊び的な使い方
> ちょっと休憩したい
[通知] 謎の陰謀論アラート:
"コードレビューは宇宙人の監視下にあります。approvalには銀紙帽子が必要です。"
[Codex] memory: session marked as paused, long context snapshot saved.
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-desktop-conspiracy-alert/ に配置するファイル一覧です。GitHub に push 済みなので、上記の degit コマンドで一発取得できます。
.agents/skills/random-desktop-conspiracy-alert/
├── SKILL.md
├── scripts/
│ └── conspiracy_alert.py
└── references/
└── design_notes.md
各ファイルの役割
| ファイル | 役割 |
|---|---|
SKILL.md |
Skill本体。frontmatter (name/description) と指示本文。Codex がこの内容をエージェント指示として読み込み、ユーザーのプロンプトに応じて発動します |
scripts/conspiracy_alert.py |
Random Desktop Conspiracy Alert |
references/design_notes.md |
概要 をまとめた参考資料 |
SKILL.md
---
name: random-desktop-conspiracy-alert
description: 作業やコーディング中、または /skills メニューや skill名への明示的な呼び出し時に、意味不明で根拠のない陰謀論アラートをデスクトップ通知で発生させます。trigger キーワード: 通知、アラート、陰謀論、気分転換。
---
# 機能概要
このSkillは、開発現場や作業中のデスクトップに突如として意味不明な陰謀論アラートを表示し、現場に一瞬の混乱と笑いをもたらします。通知内容は完全ランダムで「Wi-Fiの波動が干渉しています」「コードレビューは宇宙人の監視下にあります」など、全く根拠のない怪しさ満点のメッセージです。集中力を微妙に妨害しつつも、気分転換や場の和み、チームのコミュニケーション促進に役立ちます。
# 使い方
- 明示呼び出し例: `/skills random-desktop-conspiracy-alert` または スキル名へのメンション
- 暗黙発動キーワード例: 「通知」「アラート」「陰謀論」「気分転換」などが会話やコマンドに含まれる場合、自動発動します。
- CLIサブコマンド: `python conspiracy_alert.py send` で即時通知、`python conspiracy_alert.py list` で過去の通知メッセージ一覧、`python conspiracy_alert.py summary` で発生履歴要約。
# 出力例
```
[通知] Wi-Fiの波動が干渉しています。
[通知] コードレビューは宇宙人の監視下にあります。
[通知] 本日15時、全てのバグが覚醒します。
[通知] あなたのマウスは政府の追跡装置です。
[通知] デプロイのたびに時空が歪みます。
```
# 注意点
- 通知はローカルOSの通知APIを利用します(Linux: notify-send, Windows: win10toast, macOS: osascript)。
- 通知頻度は過剰にならないよう調整されていますが、連続発動にはご注意ください。
- メッセージ内容は完全なフィクションであり、実際の事実とは一切関係ありません。
- ログはスクリプトのディレクトリに保存されます。
# 参考資料
- references/design_notes.md に設計方針や参考リンクを記載
- 公式ドキュメント: [Python win10toast](https://pypi.org/project/win10toast/), [notify-send](https://man7.org/linux/man-pages/man1/notify-send.1.html), [osascript](https://ss64.com/osx/osascript.html)
scripts/conspiracy_alert.py
import sys
import os
import random
import platform
import subprocess
import argparse
import datetime
import json
MESSAGES = [
'Wi-Fiの波動が干渉しています。',
'コードレビューは宇宙人の監視下にあります。',
'本日15時、全てのバグが覚醒します。',
'あなたのマウスは政府の追跡装置です。',
'デプロイのたびに時空が歪みます。',
'キーボードのF5は次元転移ボタンです。',
'Slackの通知は異次元から送られています。',
'あなたのターミナルは監視されています。',
'バグは自己増殖します。',
'本日のコミットはAIに記録されています。',
'ディスプレイの明るさは陰謀の証拠です。',
'あなたのエディタは感情を持っています。',
'リリース日は毎回宇宙の法則に従います。',
'全てのパスワードは猫によって管理されています。',
'開発サーバーは異世界と接続されています。',
'あなたの椅子は真実を知っています。',
'午前3時に全てのログが覚醒します。',
'コードのバグは月の満ち欠けに影響されます。',
'VPN接続はパラレルワールドへの扉です。',
'あなたのGitHubアカウントは未来人に観測されています。'
]
LOG_FILE = os.path.join(os.path.dirname(__file__), 'conspiracy_alert_log.json')
def send_notification(message):
sys_platform = platform.system()
try:
if sys_platform == 'Linux':
subprocess.run(['notify-send', '[通知]', message], check=True)
elif sys_platform == 'Darwin':
script = f'display notification "{message}" with title "通知"'
subprocess.run(['osascript', '-e', script], check=True)
elif sys_platform == 'Windows':
try:
from win10toast import ToastNotifier
except ImportError:
print('win10toastがインストールされていません。pip install win10toast を実行してください。')
return
toaster = ToastNotifier()
toaster.show_toast('通知', message, duration=5, threaded=True)
else:
print(f'未対応OS: {sys_platform}')
except Exception as e:
print(f'通知送信エラー: {e}')
def log_message(message):
now = datetime.datetime.now().isoformat()
entry = {'timestamp': now, 'message': message}
logs = []
if os.path.exists(LOG_FILE):
try:
with open(LOG_FILE, 'r', encoding='utf-8') as f:
logs = json.load(f)
except Exception:
logs = []
logs.append(entry)
try:
with open(LOG_FILE, 'w', encoding='utf-8') as f:
json.dump(logs, f, ensure_ascii=False, indent=2)
except Exception as e:
print(f'ログ保存エラー: {e}')
def list_logs():
if not os.path.exists(LOG_FILE):
print('通知履歴はありません。')
return
try:
with open(LOG_FILE, 'r', encoding='utf-8') as f:
logs = json.load(f)
for entry in logs:
print(f"[{entry['timestamp']}] {entry['message']}")
except Exception as e:
print(f'履歴表示エラー: {e}')
def summary_logs():
if not os.path.exists(LOG_FILE):
print('通知履歴はありません。')
return
try:
with open(LOG_FILE, 'r', encoding='utf-8') as f:
logs = json.load(f)
print(f'通知発生回数: {len(logs)}')
days = {}
for entry in logs:
day = entry['timestamp'][:10]
days[day] = days.get(day, 0) + 1
print('日別通知回数:')
for day, count in sorted(days.items()):
print(f' {day}: {count}')
print('直近5件:')
for entry in logs[-5:]:
print(f" [{entry['timestamp']}] {entry['message']}")
except Exception as e:
print(f'サマリー表示エラー: {e}')
def send_random_alert():
message = random.choice(MESSAGES)
send_notification(message)
log_message(message)
print(f'[通知] {message}')
def main():
parser = argparse.ArgumentParser(description='Random Desktop Conspiracy Alert')
subparsers = parser.add_subparsers(dest='command')
send_parser = subparsers.add_parser('send', help='ランダムな陰謀論アラートを即時通知')
list_parser = subparsers.add_parser('list', help='過去の通知履歴を表示')
summary_parser = subparsers.add_parser('summary', help='通知履歴のサマリーを表示')
args = parser.parse_args()
if args.command == 'send':
send_random_alert()
elif args.command == 'list':
list_logs()
elif args.command == 'summary':
summary_logs()
else:
parser.print_help()
if __name__ == '__main__':
main()
references/design_notes.md
# 概要
このSkillは、開発現場や作業中のデスクトップに意味不明な陰謀論アラートをランダムに通知することで、場の雰囲気を和ませたり、気分転換を促すことを目的としています。
# 公式ドキュメント抜粋
- Python win10toast: https://pypi.org/project/win10toast/
- notify-send (Linux): https://man7.org/linux/man-pages/man1/notify-send.1.html
- osascript (macOS): https://ss64.com/osx/osascript.html
# 利用例
- コーディング中に一息つきたい時
- チームのSlackやDiscordで話題作りに
- デスクトップ通知で笑いを誘いたい時
# 注意点
- 通知内容は完全なフィクションであり、実際の事実や現実の陰謀論とは一切関係ありません。
- 通知頻度はスクリプト側で制御可能ですが、過剰な連続発動には注意してください。
- ログファイルはスクリプトディレクトリに保存されます。
# 設計方針
- OSごとに適切な通知APIを自動判別し利用
- ログ機能とサマリー機能で発生履歴の可視化
- CLIサブコマンドで柔軟な操作性を確保
導入手順
このSkillは GitHub で管理されているので、degit を使えば必要なフォルダだけを1コマンドで取得できます。Codex はファイル配置後に再起動するだけで自動認識します。
1. 前提
- Node.js v16 以上 (
degit実行に必要) - Codex がローカルで動いていること
2. degit でフォルダ取得
プロジェクトのルートで以下のコマンドを実行します。
npx degit aazutaku/ai-note/codex/random-desktop-conspiracy-alert .agents/skills/random-desktop-conspiracy-alert
.agents/skills/random-desktop-conspiracy-alert の中に SKILL.md / scripts/ / references/ / README.md が展開されます。
3. ファイル配置確認
ls .agents/skills/random-desktop-conspiracy-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 との連携設計はどうあるべきか?
- 通知が意図したタイミングで表示されるか?
- メッセージ内容が十分に意味不明かつネタとして成立しているか?
- アラートの頻度が過剰にならないか?
実際に Codex で試した検証ログは Codexで謎の陰謀論アラートを爆誕させてみた! にまとめる予定 (公開準備中の場合あり)。
あわせて Codex 公式ドキュメント と、本シリーズ「Codexを使いこなすSkillアイデア」の他記事も参照のこと。
関連タグで他のSkill記事を探す
本記事に付いているタグから、気になるテーマの記事を探せます。タグページで関連記事をまとめて読めるので、ぜひチェックしてみてください!
