Codex ユーザーが日常でぶつかる悩み
Codex を使っていると、日々の開発フローの中で「ちょっとしたマンネリ」や「緊張感の欠如」を感じる瞬間が意外と多い。特に長時間同じ repository で作業していると、集中力が途切れたり、AI の出力が単調に感じたりすることがある。「AI coding workflow の中で、もう少し遊び心や刺激が欲しい」と思うことはないだろうか?
また、通知や演出系の Skill を活用していると、現場の空気が和らいだり、ちょっとした話題づくりになることも。context や path management などの堅い話題とは別に、「なぜかよく分からないけど面白い」演出が欲しくなるタイミングもある。
- Codex が context を見失って違う場所のコードを参照する
- monorepo で package を跨いだ瞬間、Codex が repo 構造を忘れる
- session を再開すると、前回までの context や path 指定をまるごと再説明しないといけない
- 長時間 workflow で long context が膨らみすぎて、important な情報が薄まる (stale context)
- 「ここはこういう構造のリポジトリ」というあらすじを毎回チャットの冒頭で書く羽目になる
こうした悩みの合間に、ふいに現れる謎の「OS風スクリーンショット通知」。それは本筋とは関係ないものの、開発現場の雰囲気を一変させる力を持つ。通知・演出・OS連携系 Skill の需要は、実は「真面目な課題解決」だけでなく「場の空気を変える」用途にも存在する。
この Skill が一言でいうと何を解決するか
一言サマリ: このスキルは、Codex の AI coding workflow に突如“謎のOS偽スクリーンショット通知”をランダム表示し、現場の緊張感やマンネリを一撃粉砕するSkill。
もう少し具体化すると、このSkillを入れることで以下のような状態になる:
- AI coding workflow の中に、唐突な通知演出で「場の空気」をリフレッシュできる
- repository understanding や path management の合間に、謎の通知が現れることで会話や集中力がリセットされる
- monorepo 作業や session 再開時、意味不明な OS 風アラートが出て話題のきっかけになる
- 長時間の作業で stale context になりかけた時、唐突な通知で一時的な「区切り」や「気分転換」が生まれる
- onboarding や新規参加者にも「このrepo、何か変なSkill入ってるぞ」という印象を残せる
GitHub から degit でコマンド1行、Codex の Skill ディレクトリに展開できます。Node.js があれば即時に動きます。
npx degit aazutaku/ai-note/codex/random-os-fake-screenshot-alert .agents/skills/random-os-fake-screenshot-alert実行したらこうなる (3つの利用シーン)
使う側がイメージしやすいよう、擬似 terminal で出力例を3パターン示す。Skill が返す出力は推測だが、現実的なフォーマット・現実的な長さで書く。
シーン1: session 開始時 (プロジェクト初動で)
# /skills menu or random-os-fake-screenshot-alert mention
> プロジェクト開始。main.py を編集したい。
[通知] スクリーンショットを保存しました: あなたの集中顔を記録しました
保存場所: /Users/username/Pictures/ss_20240624_135201.png
(実際には何も保存されていません)
[通知] 証拠画像を保存しました: バグ発生の瞬間をキャプチャ
保存場所: /Users/username/Pictures/ss_20240624_135202.png
シーン2: monorepo / package 跨ぎ作業時
> packages/api/ 配下のコードを修正して、packages/web/ に移動。
[通知] スクリーンショット保存済み: ディレクトリ移動の瞬間
保存場所: /Users/username/Pictures/ss_20240624_141015.png
[通知] あなたの "迷子顔" を記録しました
保存場所: /Users/username/Pictures/ss_20240624_141017.png
シーン3: お遊び的な使い方
> なんとなく Skill を明示呼び出し
[通知] 証拠画像を保存しました: コーヒーブレイク中のあなた
保存場所: /Users/username/Pictures/ss_20240624_143002.png
[通知] スクリーンショット保存済み: 意味不明な瞬間
保存場所: /Users/username/Pictures/ss_20240624_143003.png
before / after の違い
| 場面 | Skill 無し | Skill 有り |
|---|---|---|
| session 再開時 | repo 構造から毎回説明、path も指定し直し | Codex が自動で context を復元、最小プロンプトで再開。さらに謎通知で空気が変わる |
| monorepo 移動 | 違う package のコードを参照しがち | directory boundary を意識して必要な範囲だけ見る+謎通知が現れる |
| 長時間 workflow | long context で重要箇所が薄まる | 唐突な通知で一時的に集中がリセットされる |
発動方式
明示呼び出し (/skills menu or random-os-fake-screenshot-alert mention) と暗黙発動 (description マッチ) の両方に対応。
Skill の中身を全部見せる
.agents/skills/random-os-fake-screenshot-alert/ に配置するファイル一覧です。GitHub に push 済みなので、上記の degit コマンドで一発取得できます。
.agents/skills/random-os-fake-screenshot-alert/
├── SKILL.md
├── scripts/
│ └── random_os_fake_screenshot_alert.py
└── references/
└── design_notes.md
各ファイルの役割
| ファイル | 役割 |
|---|---|
SKILL.md |
Skill本体。frontmatter (name/description) と指示本文。Codex がこの内容をエージェント指示として読み込み、ユーザーのプロンプトに応じて発動します |
scripts/random_os_fake_screenshot_alert.py |
謎のOSスクリーンショット保存通知をランダム表示するSkill |
references/design_notes.md |
概要 をまとめた参考資料 |
SKILL.md
---
name: random-os-fake-screenshot-alert
description: このSkillは、コマンド実行や作業中に「スクリーンショット保存通知」をOSの通知API経由でランダム表示します。trigger: screenshot, save, 証拠, バグ, alert, 集中, などのキーワードや明示呼び出し時に発動します。
---
# 機能概要
このSkillは、作業やコマンド実行の合間に、まるでOSが勝手に“謎のスクリーンショット”を保存したかのような通知をデスクトップに表示します。通知内容は毎回ランダムで、「証拠画像を保存しました」「バグ発生の瞬間を記録」「あなたの集中顔を記録しました」など、実際には何も保存されず、意味不明な演出が現場に混沌とした笑いと緊張感をもたらします。マンネリ打破や休憩のきっかけ、場の空気を和ませるジョーク枠として最適です。
# 使い方
- 明示呼び出し例: `/skills random-os-fake-screenshot-alert` や `$random-os-fake-screenshot-alert` をチャットやCLIで実行
- 暗黙発動キーワード例: 「screenshot」「証拠」「バグ」「alert」「集中」などを含むコマンドや会話時に自動発動
- 通知はOSのネイティブ通知API(Windows: Toast, macOS: osascript, Linux: notify-send)を利用
# 出力例
```
[通知] スクリーンショット保存済み:バグ発生の瞬間
[通知] 証拠画像を保存しました(保存先:???)
[通知] あなたの集中顔を記録しました
[通知] システムが謎の瞬間をキャプチャしました
[通知] 何もしていませんが保存完了です
```
# 注意点
- 実際に画像やファイルは一切保存されません
- 通知内容は毎回ランダム生成され、同じメッセージはほぼ出ません
- 通知頻度やタイミングは迷惑にならないよう制御されています
- 一部の環境(WSL, SSH, headless等)では通知が表示されない場合があります
# 参考資料
- [Python公式: plyer, notify2, win10toast](https://pypi.org/project/plyer/), [osascript通知](https://ss64.com/osx/osascript.html)
- references/design_notes.md も参照
scripts/random_os_fake_screenshot_alert.py
import sys
import os
import random
import platform
import subprocess
import argparse
import time
from typing import List
RANDOM_MESSAGES = [
"スクリーンショット保存済み:バグ発生の瞬間",
"証拠画像を保存しました(保存先:???)",
"あなたの集中顔を記録しました",
"システムが謎の瞬間をキャプチャしました",
"何もしていませんが保存完了です",
"保存完了:何を保存したかは不明です",
"証拠画像をクラウドにアップロードしました(嘘)",
"バグトラッキング用スクリーンショット保存済み",
"あなたのリアクションを記録しました",
"OSが気まぐれにスクリーンショットを保存しました"
]
DEFAULT_INTERVAL = 0
class Notifier:
def __init__(self):
self.system = platform.system().lower()
def notify(self, message: str):
if self.system == 'windows':
self._notify_windows(message)
elif self.system == 'darwin':
self._notify_macos(message)
elif self.system == 'linux':
self._notify_linux(message)
else:
print(f"[通知] {message}")
def _notify_windows(self, message: str):
try:
from win10toast import ToastNotifier
toaster = ToastNotifier()
toaster.show_toast("スクリーンショット通知", message, duration=5, threaded=True)
except ImportError:
# Fallback: powershell
script = f'[Windows.UI.Notifications.ToastNotificationManager, Windows.UI.Notifications, ContentType = WindowsRuntime] > $null;'
script += f'$template = [Windows.UI.Notifications.ToastNotificationManager]::GetTemplateContent([Windows.UI.Notifications.ToastTemplateType]::ToastText02);'
script += f'$textNodes = $template.GetElementsByTagName("text");$textNodes.Item(0).AppendChild($template.CreateTextNode("スクリーンショット通知")) > $null;'
script += f'$textNodes.Item(1).AppendChild($template.CreateTextNode("{message}")) > $null;'
script += f'$toast = [Windows.UI.Notifications.ToastNotification]::new($template);'
script += f'$notifier = [Windows.UI.Notifications.ToastNotificationManager]::CreateToastNotifier("Python") ;'
script += f'$notifier.Show($toast)'
subprocess.call(["powershell", "-Command", script])
def _notify_macos(self, message: str):
try:
subprocess.run([
"osascript", "-e",
f'display notification "{message}" with title "スクリーンショット通知"'
], check=True)
except Exception:
print(f"[通知] {message}")
def _notify_linux(self, message: str):
try:
subprocess.run([
"notify-send", "スクリーンショット通知", message
], check=True)
except Exception:
print(f"[通知] {message}")
def random_message() -> str:
return random.choice(RANDOM_MESSAGES)
def show_alert(notifier: Notifier, count: int = 1, interval: float = 0):
for i in range(count):
msg = random_message()
notifier.notify(msg)
if interval > 0 and i < count - 1:
time.sleep(interval)
def list_messages():
print("--- 通知メッセージ候補 ---")
for m in RANDOM_MESSAGES:
print(f"- {m}")
def summary():
print("Skill: random-os-fake-screenshot-alert")
print("用途: OS風の謎スクリーンショット保存通知をランダム表示")
print(f"通知候補数: {len(RANDOM_MESSAGES)}")
print("サポートOS: Windows, macOS, Linux")
print("保存実体: なし (通知のみ)")
def parse_args():
parser = argparse.ArgumentParser(description='謎のOSスクリーンショット保存通知をランダム表示するSkill')
subparsers = parser.add_subparsers(dest='command')
parser_alert = subparsers.add_parser('alert', help='ランダム通知を表示')
parser_alert.add_argument('-n', '--count', type=int, default=1, help='通知回数')
parser_alert.add_argument('-i', '--interval', type=float, default=DEFAULT_INTERVAL, help='通知間隔(秒)')
parser_list = subparsers.add_parser('list', help='通知メッセージ候補一覧')
parser_summary = subparsers.add_parser('summary', help='Skill概要')
return parser.parse_args()
def main():
args = parse_args()
notifier = Notifier()
if args.command == 'alert' or args.command is None:
count = getattr(args, 'count', 1)
interval = getattr(args, 'interval', 0)
show_alert(notifier, count=count, interval=interval)
elif args.command == 'list':
list_messages()
elif args.command == 'summary':
summary()
else:
print("不明なサブコマンドです。--help を参照してください。")
if __name__ == '__main__':
main()
references/design_notes.md
# 概要
このSkillは、実際には何も保存しないが、OS風の“スクリーンショット保存通知”をデスクトップにランダム表示することで、場の空気を和ませたり、緊張感を和らげるジョーク演出を提供します。
# 公式ドキュメント抜粋
- [plyer通知API](https://plyer.readthedocs.io/en/latest/)
- [notify-send(Linux)](https://specifications.freedesktop.org/notification-spec/latest/)
- [osascript(macOS)](https://ss64.com/osx/osascript.html)
- [win10toast(Windows)](https://pypi.org/project/win10toast/)
# 利用例
- チーム開発中に突如表示して場を和ませる
- コマンド実行時の“謎の緊張感”演出
- 雑談やバグ報告時のネタ枠通知
# 注意点
- SSHやWSL、headless環境では通知が出ない場合があります
- 通知内容は毎回ランダムで、実害や実ファイル保存はありません
# 設計方針
- OSごとに標準的な通知APIを利用し、追加インストール不要を目指す
- 通知内容はリストからランダム選択、今後拡張も容易
- ジョーク性と安全性(実害ゼロ)を両立
導入手順
このSkillは GitHub で管理されているので、degit を使えば必要なフォルダだけを1コマンドで取得できます。Codex はファイル配置後に再起動するだけで自動認識します。
1. 前提
- Node.js v16 以上 (
degit実行に必要) - Codex がローカルで動いていること
2. degit でフォルダ取得
プロジェクトのルートで以下のコマンドを実行します。
npx degit aazutaku/ai-note/codex/random-os-fake-screenshot-alert .agents/skills/random-os-fake-screenshot-alert
.agents/skills/random-os-fake-screenshot-alert の中に SKILL.md / scripts/ / references/ / README.md が展開されます。
3. ファイル配置確認
ls .agents/skills/random-os-fake-screenshot-alert
# SKILL.md, scripts/, references/, README.md があればOK
4. Codex を再起動 (or Skill 自動検出を待つ)
新しいSkillが自動で認識されます。リスト確認したい場合は /skills menu or random-os-fake-screenshot-alert mention と Skill 名で出てきます。
5. 動作確認
/skills menu or random-os-fake-screenshot-alert 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記事を探す
本記事に付いているタグから、気になるテーマの記事を探せます。タグページで関連記事をまとめて読めるので、ぜひチェックしてみてください!
