Codex ユーザーが日常でぶつかる悩み
Codex を使っていると、便利なはずの AI コーディングエージェントが、ちょっとした context のズレや repo 構造の認識ミスで思い通りに動かないことがよくあります。特に monorepo や複雑なディレクトリ構成のプロジェクトでは、AI が今どこを見ているのか分からなくなりがちです。さらに、長時間の作業や session の再開時には、AI に毎回同じ説明を繰り返す面倒さもつきまといます。
一方で、集中して作業したいタイミングに限って、通知や演出系の Skill が「今それ!?」という絶妙なタイミングで割り込んでくることも。真面目な workflow の中に、意図せずエンタメ要素が混じると、思わず笑ってしまう…そんな体験も Codex ならではです。
- Codex が context を見失って違う場所のコードを参照する
- monorepo で package を跨いだ瞬間、Codex が repo 構造を忘れる
- session を再開すると、前回までの context や path 指定をまるごと再説明しないといけない
- 長時間 workflow で long context が膨らみすぎて、important な情報が薄まる (stale context)
- 「ここはこういう構造のリポジトリ」というあらすじを毎回チャットの冒頭で書く羽目になる
特に通知・演出・OS連携系の Skill を入れていると、集中したいタイミングに限って意味不明な通知に邪魔されることも。そんな「あるある」を逆手に取った提案です。
この Skill が一言でいうと何を解決するか
一言サマリ: このスキルは、ポモドーロタイマー開始・終了時に毎回ランダムな“フェイク失敗通知”を炸裂させるエンタメ系 Skill です。
もう少し具体化すると、このSkillを入れることで以下のような状態になる:
- AI coding workflow の中で、ポモドーロタイマー操作時に必ず context 無視の謎通知が入ることで、真面目な session に遊び心をプラスできる
- repository understanding や path management で煮詰まった時、フェイク通知で一瞬気分転換できる
- 毎回違うネタを出すため、長時間の作業や onboarding 時にも飽きずに使える
- 通知内容が実用性ゼロなので、作業効率を下げずにストレス発散ができる
- Skill の導入・削除が簡単なので、必要な時だけ気軽にオンオフできる
GitHub から degit でコマンド1行、Codex の Skill ディレクトリに展開できます。Node.js があれば即時に動きます。
npx degit aazutaku/ai-note/codex/random-os-fake-pomodoro-failure-notifier .agents/skills/random-os-fake-pomodoro-failure-notifier実行したらこうなる (3つの利用シーン)
使う側がイメージしやすいよう、擬似 terminal で出力例を3パターン示します。
シーン1: session 開始時 (プロジェクト初動で)
# /skills menu
> ポモドーロタイマーを30分で開始
[通知] 失敗:トマトが爆発しました。作業ディレクトリ /src/components は一時的にケチャップまみれです。
[通知] 警告:集中力が鍋底にこびりつきました。/src/utils/cleaner.py で掃除してください。
[通知] 注意:タイマーがピザに変身したため無効です。再度セットしてください。
(※毎回どれか1つがランダムに表示される)
シーン2: monorepo / package 跨ぎ作業時
> packages/api/ でポモドーロタイマーを開始
[通知] 失敗:APIサーバーがトマトソースで溺れました。/packages/api/server.js の救出を推奨します。
[通知] 警告:repo の context がトマト畑に迷い込みました。/packages/frontend/ への移動を検討してください。
(パッケージ名や directory 構造を絡めたネタ通知)
シーン3: お遊び的な使い方
> ターミナルから「ポモドーロ失敗通知を出して」と入力
[通知] 失敗:タイマーがトマトジュースに変換されました。/tests/pomodoro.test.js の味見をおすすめします。
[通知] 注意:集中力がピザに吸収されました。カロリー補給してください。
(意味不明な通知が毎回違うパターンで表示)
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-pomodoro-failure-notifier/ に配置するファイル一覧です。GitHub に push 済みなので、上記の degit コマンドで一発取得できます。
.agents/skills/random-os-fake-pomodoro-failure-notifier/
├── SKILL.md
├── scripts/
│ └── fake_pomodoro_notifier.py
└── references/
└── design_notes.md
各ファイルの役割
| ファイル | 役割 |
|---|---|
SKILL.md |
Skill本体。frontmatter (name/description) と指示本文。Codex がこの内容をエージェント指示として読み込み、ユーザーのプロンプトに応じて発動します |
scripts/fake_pomodoro_notifier.py |
Send a desktop notification or fallback to terminal output. |
references/design_notes.md |
概要 をまとめた参考資料 |
SKILL.md
---
name: random-os-fake-pomodoro-failure-notifier
description: Codexは「ポモドーロ」「集中」「タイマー」「作業開始」「休憩」などのキーワードを含む会話や、/skills menuやrandom-os-fake-pomodoro-failure-notifierの明示的な呼び出し時にこのSkillを発動してください。
---
# 機能概要
このSkillは、あなたがポモドーロタイマーを開始・終了した際に、実用性ゼロの“フェイク失敗通知”をデスクトップやターミナルに表示します。通知内容は毎回ランダムで、トマトやピザ、鍋などのネタを交えた意味不明なメッセージばかり。まじめな作業の合間にエンタメ要素を加え、集中しすぎて疲れることを防ぐ狙いも。OSの通知APIを利用し、クロスプラットフォームで動作します。
# 使い方
- 明示呼び出し例: `/skills menu` から本Skillを選択、または `$random-os-fake-pomodoro-failure-notifier` をmention。
- 暗黙発動キーワード例: 「ポモドーロ開始」「集中タイマー」「作業を始める」「25分セット」「休憩タイム」などの会話に反応。
# 出力例
```
[通知] 失敗:トマトが爆発しました。作業時間は跡形もありません。
[通知] 警告:集中力が鍋底にこびりつきました。スクレーパー推奨。
[通知] 注意:タイマーがピザに変身したため無効です。
[通知] エラー:ポモドーロがケチャップになりました。再起動してください。
[通知] 失敗:休憩時間がトマトソースに吸収されました。
```
# 注意点
- 実際のタイマー管理や進捗記録機能はありません。
- 通知はローカル端末のOS通知APIまたはターミナル出力でのみ表示され、データ保存や外部送信はありません。
- 10分程度で環境構築・動作可能。Python3とnotify-send(macOSはosascript)が必要です。
- ふざけた通知のみで、実用的なリマインダーや記録には使えません。
# 参考資料
- references/design_notes.md に設計方針・利用例を記載
- 公式ドキュメント: https://docs.python.org/3/library/subprocess.html, https://pypi.org/project/plyer/
scripts/fake_pomodoro_notifier.py
import sys
import os
import random
import time
import argparse
import platform
import subprocess
from typing import List
FAKE_FAILURE_MESSAGES = [
"失敗:トマトが爆発しました。作業時間は跡形もありません。",
"警告:集中力が鍋底にこびりつきました。スクレーパー推奨。",
"注意:タイマーがピザに変身したため無効です。",
"エラー:ポモドーロがケチャップになりました。再起動してください。",
"失敗:休憩時間がトマトソースに吸収されました。",
"警告:作業集中度がピクルスレベルに低下しました。",
"注意:トマトタイマーがサルサに変化しました。",
"失敗:時間泥棒がトマトを盗みました。",
"警告:ポモドーロがパスタに巻き込まれました。",
"注意:集中力がピザ生地の下に隠れました。",
"失敗:タイマーがオーブンで焼かれすぎました。",
"エラー:トマトの種がタイマーを詰まらせました。",
"警告:休憩がトマトジュースに溶けました。",
"注意:作業意欲がピザカッターでカットされました。",
"失敗:トマト農家がストライキ中です。",
"警告:集中力がピクルス瓶に閉じ込められました。",
"注意:タイマーがトマト缶に変身しました。",
"失敗:休憩時間がピザの箱に吸収されました。"
]
TRIGGER_KEYWORDS = [
"ポモドーロ", "集中", "タイマー", "作業開始", "休憩", "25分", "タスク", "集中タイム", "start pomodoro", "focus", "break"
]
OS_TYPE = platform.system()
def send_notification(message: str):
"""Send a desktop notification or fallback to terminal output."""
try:
if OS_TYPE == "Darwin":
# macOS
script = f'display notification "{message}" with title "ポモドーロ失敗通知"'
subprocess.run(["osascript", "-e", script], check=True)
elif OS_TYPE == "Linux":
# Linux (notify-send)
subprocess.run(["notify-send", "ポモドーロ失敗通知", message], check=True)
elif OS_TYPE == "Windows":
# Windows 10+ (toast via PowerShell)
powershell = (
f'[Windows.UI.Notifications.ToastNotificationManager, Windows.UI.Notifications, ContentType = WindowsRuntime] > $null;'
f'$template = [Windows.UI.Notifications.ToastNotificationManager]::GetTemplateContent(0);'
f'$textNodes = $template.GetElementsByTagName("text");'
f'$textNodes.Item(0).AppendChild($template.CreateTextNode("ポモドーロ失敗通知")) > $null;'
f'$textNodes.Item(1).AppendChild($template.CreateTextNode("{message}")) > $null;'
f'$toast = [Windows.UI.Notifications.ToastNotification]::new($template);'
f'$notifier = [Windows.UI.Notifications.ToastNotificationManager]::CreateToastNotifier("PomodoroFail");'
f'$notifier.Show($toast);'
)
subprocess.run(["powershell", "-Command", powershell], check=True)
else:
print(f"[通知] {message}")
except Exception as e:
print(f"[通知] {message} (通知エラー: {e})")
def random_failure_message() -> str:
return random.choice(FAKE_FAILURE_MESSAGES)
def parse_args():
parser = argparse.ArgumentParser(description="Fake Pomodoro Failure Notifier")
subparsers = parser.add_subparsers(dest="command")
parser_start = subparsers.add_parser("start", help="ポモドーロタイマー開始 (フェイク通知発動)")
parser_start.add_argument("--duration", type=int, default=25, help="作業時間(分)")
parser_start.add_argument("--break", type=int, default=5, help="休憩時間(分)")
parser_notify = subparsers.add_parser("notify", help="即座にフェイク通知を表示")
parser_notify.add_argument("--count", type=int, default=1, help="通知回数")
parser_list = subparsers.add_parser("list", help="通知メッセージ一覧表示")
return parser.parse_args()
def run_pomodoro(duration: int, break_duration: int):
print(f"[INFO] ポモドーロタイマー開始: {duration}分 作業 → {break_duration}分 休憩 (フェイク通知あり)")
send_notification(random_failure_message())
for i in range(duration):
time.sleep(0.1) # 実際は1分だがデモ用に0.1秒
send_notification(random_failure_message())
print(f"[INFO] 作業終了。休憩タイム: {break_duration}分")
for i in range(break_duration):
time.sleep(0.1)
send_notification(random_failure_message())
print(f"[INFO] ポモドーロサイクル完了 (全てフェイク通知)")
def notify_random(count: int):
for _ in range(count):
msg = random_failure_message()
send_notification(msg)
print(f"[通知] {msg}")
time.sleep(0.5)
def list_messages():
print("--- フェイク通知メッセージ一覧 ---")
for i, msg in enumerate(FAKE_FAILURE_MESSAGES):
print(f"{i+1:02d}: {msg}")
def semantic_trigger(text: str) -> bool:
"""Check if the input text contains trigger keywords."""
text = text.lower()
return any(kw.lower() in text for kw in TRIGGER_KEYWORDS)
def main():
args = parse_args()
if args.command == "start":
run_pomodoro(args.duration, args.break)
elif args.command == "notify":
notify_random(args.count)
elif args.command == "list":
list_messages()
else:
print("Usage: python fake_pomodoro_notifier.py [start|notify|list] [options]")
print("例: python fake_pomodoro_notifier.py start --duration 25 --break 5")
print("例: python fake_pomodoro_notifier.py notify --count 3")
print("例: python fake_pomodoro_notifier.py list")
if __name__ == "__main__":
main()
references/design_notes.md
# 概要
このSkillは、ポモドーロタイマーの開始や終了時に、実用性ゼロのジョーク通知をOSのデスクトップ通知またはターミナル出力で表示します。集中力を維持しつつ、作業の合間にクスっと笑えるエンタメ要素を提供します。
# 公式ドキュメント抜粋
- Python subprocess: https://docs.python.org/3/library/subprocess.html
- plyer通知API: https://github.com/kivy/plyer
# 利用例
- ターミナルで `python fake_pomodoro_notifier.py start` を実行すると、作業・休憩の開始/終了ごとに毎回異なるフェイク通知が表示されます。
- `python fake_pomodoro_notifier.py notify --count 5` で、5回分のジョーク通知を即座に表示。
# 注意点
- 本Skillは実際のタイマー管理や作業記録は行いません。通知内容はすべてフィクションです。
- 通知APIが利用できない場合は、ターミナル出力にフォールバックします。
# 設計方針
- OSごとに適切な通知APIを呼び出し、クロスプラットフォーム対応。
- メッセージはリストからランダム選択し、毎回異なる演出を保証。
- 環境構築が容易で、10分以内に動作確認できるシンプル設計。
導入手順
このSkillは GitHub で管理されているので、degit を使えば必要なフォルダだけを1コマンドで取得できます。Codex はファイル配置後に再起動するだけで自動認識します。
1. 前提
- Node.js v16 以上 (
degit実行に必要) - Codex がローカルで動いていること
2. degit でフォルダ取得
プロジェクトのルートで以下のコマンドを実行します。
npx degit aazutaku/ai-note/codex/random-os-fake-pomodoro-failure-notifier .agents/skills/random-os-fake-pomodoro-failure-notifier
.agents/skills/random-os-fake-pomodoro-failure-notifier の中に SKILL.md / scripts/ / references/ / README.md が展開されます。
3. ファイル配置確認
ls .agents/skills/random-os-fake-pomodoro-failure-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 との連携設計はどうあるべきか?
- 通知がタイマー開始/終了時に毎回ランダムなネタ文で出るか?
- 通知内容が実用性ゼロのふざけた内容になっているか?
- 環境構築・データ損失リスクなしで10分程度で動作するか?
実際に Codex で試した検証ログは Codexで謎のポモドーロ失敗通知を炸裂させてみた! にまとめる予定 (公開準備中の場合あり)。
あわせて Codex 公式ドキュメント と、本シリーズ「Codexを使いこなすSkillアイデア」の他記事も参照のこと。
関連タグで他のSkill記事を探す
本記事に付いているタグから、気になるテーマの記事を探せます。タグページで関連記事をまとめて読めるので、ぜひチェックしてみてください!
