Codex ユーザーが日常でぶつかる悩み
日々Codexで開発していると、作業の合間にふとした瞬間に集中力が落ちたり、長時間のAI coding workflowでマンネリ感が漂うことは珍しくありません。特に通知・演出・OS連携系のSkillが少ない現状では、「何か面白い刺激がほしい」と感じることも多いはずです。具体的には次のような悩みが挙げられます:
- Codex が context を見失って違う場所のコードを参照する
- monorepo で package を跨いだ瞬間、Codex が repo 構造を忘れる
- session を再開すると、前回までの context や path 指定をまるごと再説明しないといけない
- 長時間 workflow で long context が膨らみすぎて、important な情報が薄まる (stale context)
- 「ここはこういう構造のリポジトリ」というあらすじを毎回チャットの冒頭で書く羽目になる
こうした技術的な悩みだけでなく、単調な作業の合間に「何かインパクトのある通知や演出で空気を変えたい」と思うことも。特にOS風の演出があると、現実と虚構の境界が一瞬揺らぐような面白さや、作業への没入感をリセットする効果が期待できます。
この Skill が一言でいうと何を解決するか
一言サマリ: 作業中に“謎のOS公式・怪しすぎるパッチノート通知”を炸裂させ、マンネリ化したAI coding workflowに一瞬の混乱と笑いをもたらすSkill。
もう少し具体化すると、このSkillを入れることで以下のような状態になる:
- 長時間の repository understanding や path management の合間に、不意打ちの“偽パッチノート”通知でリフレッシュできる
- monorepo や複雑な directory 構造をいじっている最中でも、突然現れる謎通知で現実感が一瞬飛ぶ
- onboarding や session 再開時、AIからの「OS公式アップデート」風メッセージにより、堅苦しいcontext説明が和らぐ
- Skill の発動タイミングが絶妙で、毎回異なる内容・出力が楽しめる
- Codex のAI coding workflowに遊び心を注入し、チームや個人の開発体験をアップデートできる
GitHub から degit でコマンド1行、Codex の Skill ディレクトリに展開できます。Node.js があれば即時に動きます。
npx degit aazutaku/ai-note/codex/random-os-fake-mysterious-patch-notes .agents/skills/random-os-fake-mysterious-patch-notes実行したらこうなる (3つの利用シーン)
使う側がイメージしやすいよう、擬似 terminal で出力例を3パターン示します。
シーン1: session 開始時 (プロジェクト初動で)
# /skills menu or random-os-fake-mysterious-patch-notes
> 新しいプロジェクトでCodexを起動
─────────────────────────────
OS Patch Notes v13.4.7-mystery
新機能:
- Altキーで未来が見えるようになりました
- /src/utils/ghost-mode.js で幽霊ファイルの検出が可能に
改善:
- スペースキーの跳躍力を微増
既知の問題:
- たまに幸運が訪れます
─────────────────────────────
シーン2: monorepo / package 跨ぎ作業時
> packages/auth/ から packages/payment/ に移動
─────────────────────────────
OS Patch Notes v22.1.0-shadow
新機能:
- payment APIで無限ループが発生することがあります (仕様)
- package.json の "mystify" フィールドを自動生成
改善:
- packages/auth/ のバグを隠蔽する機能を追加
- /packages/payment/ghost-pay.js で不可視決済が可能に
既知の問題:
- 時々 context が消失しますが、気にしないでください
─────────────────────────────
シーン3: お遊び的な使い方
> ちょっと気分転換したい時に /skills menu で呼び出し
─────────────────────────────
OS Patch Notes v0.0.∞-absurd
新機能:
- Enterキーで次元が切り替わるようになりました
- README.md の行間に秘密のメッセージを挿入
改善:
- AIの記憶容量を気分で増減
既知の問題:
- 今日は何も問題がありません (明日は不明)
─────────────────────────────
before / after の違い
| 場面 | Skill 無し | Skill 有り |
|---|---|---|
| session 再開時 | repo 構造から毎回説明、path も指定し直し | Codex が自動で context を復元、最小プロンプトで再開+謎パッチノート通知 |
| monorepo 移動 | 違う package のコードを参照しがち | directory boundary を意識して必要な範囲だけ見る+妙なアップデート通知で一息 |
| 長時間 workflow | long context で重要箇所が薄まる | Skill通知で contextリセット感&作業の区切りがつく |
発動方式
明示呼び出し (/skills menu or $skill-name mention) と暗黙発動 (description マッチ) の両方に対応。
Skill の中身を全部見せる
.agents/skills/random-os-fake-mysterious-patch-notes/ に配置するファイル一覧です。GitHub に push 済みなので、上記の degit コマンドで一発取得できます。
.agents/skills/random-os-fake-mysterious-patch-notes/
├── SKILL.md
├── scripts/
│ └── random_os_patch_notes.py
└── references/
└── design_notes.md
各ファイルの役割
| ファイル | 役割 |
|---|---|
SKILL.md |
Skill本体。frontmatter (name/description) と指示本文。Codex がこの内容をエージェント指示として読み込み、ユーザーのプロンプトに応じて発動します |
scripts/random_os_patch_notes.py |
謎のOSパッチノートをランダム生成・履歴管理 |
references/design_notes.md |
概要 をまとめた参考資料 |
SKILL.md
---
name: random-os-fake-mysterious-patch-notes
description: Codexは、作業中・ビルド完了・コマンド実行後など、ユーザーの集中が途切れた瞬間や/skillsメニュー呼び出し時にこのSkillを発動してください。キーワード: OS, パッチノート, 通知, ジョーク, 不意打ち。
---
# 機能概要
このSkillは、作業中の開発者に突如として“謎のOS公式・怪しすぎるパッチノート通知”を届けます。実在しない新機能追加や不可解なバグ修正、シュールな既知の問題など、現実と虚構が曖昧になるような内容が毎回ランダム生成されます。開発の合間に一瞬の混乱と笑いを提供し、気分転換やチームの話題作りにも最適です。
# 使い方
- 明示呼び出し例: `/skills random-os-fake-mysterious-patch-notes` またはスキルメニューから選択
- 暗黙発動: 「パッチノート」「OSアップデート」「通知」などの単語を含む会話や、ビルド・テスト・コマンド実行直後などに自動発動します。
# 出力例
```
[OS Patch Notes v13.2.7]
新機能: Altキーで未来の天気予報が見えるようになりました
改善: スペースキーの跳躍力を微増
既知の問題: たまに幸運が訪れます
修正: システムが月曜日を認識しなくなる不具合
---
[OS Patch Notes v14.0.1]
新機能: ターミナルで「echo hello」で虹色の猫が出現
改善: CapsLockの押下音が静かに
既知の問題: ごく稀に時間が逆行することがあります
```
# 注意点
- 実在しない機能やバグ修正が混在します。実際のシステムには影響しません。
- 通知内容は毎回異なり、現実のOSアップデートとは無関係です。
- ローカルに履歴は保存されません(CLIで履歴表示可能)。
- 業務や重要な作業中の混乱にご注意ください。
# 参考資料
詳細な設計方針や出力例は `references/design_notes.md` を参照してください。公式OSパッチノートの例: [Windows Release Notes](https://learn.microsoft.com/en-us/windows/release-health/release-information/)、[macOS Release Notes](https://support.apple.com/en-us/HT201222)。
scripts/random_os_patch_notes.py
import random
import argparse
import datetime
import sys
import os
PATCH_NOTES_TEMPLATES = [
{
"new_features": [
"Altキーで未来の天気予報が見えるようになりました",
"ターミナルで『echo hello』で虹色の猫が出現",
"Ctrl+Shift+Zで開発者モードが一瞬だけ有効になります",
"システム通知が詩的な言葉で表示されるようになりました",
"右クリックで過去の自分にメッセージを送信可能になりました",
"CapsLock2.0: 2回押しで小文字に戻せます",
"新しい壁紙『謎の宇宙』を追加しました",
"F1キーでAIが人生相談に乗ってくれます",
"時計アプリが3秒進むことがあります",
"バッテリー残量が気分で増減します"
],
"improvements": [
"スペースキーの跳躍力を微増",
"CapsLockの押下音が静かに",
"ウィンドウの角が丸くなりました",
"タスクバーの色がランダムに変化",
"ファイル検索速度が気持ち速くなりました",
"ログイン画面のBGMが優しくなりました",
"マウスカーソルの滑らかさを改善",
"スクリーンショットの画質が謎に向上",
"エラーメッセージのフォントが美しく",
"設定画面のアイコンが少し大きく"
],
"known_issues": [
"たまに幸運が訪れます",
"ごく稀に時間が逆行することがあります",
"システムが月曜日を認識しなくなる不具合",
"設定画面が哲学的な質問を投げてくる場合があります",
"ファイル名が詩的になることがあります",
"バッテリー残量がマイナス表示になる場合あり",
"スクリーンセーバーが止まらないことがあります",
"音量調整が気まぐれに効かなくなることがあります",
"クリップボードの中身が謎の暗号になることがあります",
"ウィンドウが踊りだすことがあります"
],
"fixes": [
"システムが月曜日を認識しなくなる不具合を修正",
"ファイル検索で未来のファイルが表示される問題を修正",
"一部環境で時計が止まる問題を修正",
"CapsLockが永遠にONになる問題を修正",
"ターミナルが詩を詠むバグを修正",
"ウィンドウが画面外に消える問題を修正",
"音量バーが逆向きになる問題を修正",
"ログイン画面が無限ループする問題を修正",
"通知が5分遅れて届く問題を修正",
"壁紙が深夜に変わる問題を修正"
]
}
]
HISTORY_FILE = os.path.expanduser("~/.random_os_patch_notes_history")
def generate_patch_note():
template = random.choice(PATCH_NOTES_TEMPLATES)
version = f"{random.randint(10, 15)}.{random.randint(0, 9)}.{random.randint(0, 99)}"
new_feature = random.choice(template["new_features"])
improvement = random.choice(template["improvements"])
known_issue = random.choice(template["known_issues"])
fix = random.choice(template["fixes"])
note = f"[OS Patch Notes v{version}]\n新機能: {new_feature}\n改善: {improvement}\n既知の問題: {known_issue}\n修正: {fix}"
return note
def save_to_history(note):
try:
with open(HISTORY_FILE, "a", encoding="utf-8") as f:
f.write(f"{datetime.datetime.now().isoformat()}\n{note}\n---\n")
except Exception as e:
print(f"[WARN] 履歴保存に失敗: {e}", file=sys.stderr)
def list_history(limit=5):
if not os.path.exists(HISTORY_FILE):
print("履歴がありません。", file=sys.stderr)
return
try:
with open(HISTORY_FILE, "r", encoding="utf-8") as f:
lines = f.read().split("---\n")
notes = [l.strip() for l in lines if l.strip()]
for note in notes[-limit:]:
print(note)
print("---")
except Exception as e:
print(f"[ERROR] 履歴の読み込みに失敗: {e}", file=sys.stderr)
def summary_history():
if not os.path.exists(HISTORY_FILE):
print("履歴がありません。", file=sys.stderr)
return
try:
with open(HISTORY_FILE, "r", encoding="utf-8") as f:
content = f.read()
count = content.count("[OS Patch Notes v")
print(f"これまでに生成されたパッチノート数: {count}")
except Exception as e:
print(f"[ERROR] サマリー取得に失敗: {e}", file=sys.stderr)
def main():
parser = argparse.ArgumentParser(description="謎のOSパッチノートをランダム生成・履歴管理")
subparsers = parser.add_subparsers(dest="command", required=False)
parser_log = subparsers.add_parser("log", help="新しいパッチノートを生成し表示")
parser_list = subparsers.add_parser("list", help="履歴から直近のパッチノートを表示")
parser_list.add_argument("-n", type=int, default=5, help="表示件数 (デフォルト5)")
parser_summary = subparsers.add_parser("summary", help="履歴のサマリーを表示")
args = parser.parse_args()
if args.command == "log" or args.command is None:
note = generate_patch_note()
print(note)
save_to_history(note)
elif args.command == "list":
list_history(args.n)
elif args.command == "summary":
summary_history()
else:
parser.print_help()
if __name__ == '__main__':
main()
references/design_notes.md
# 概要
このSkillは、開発現場での“OSアップデート通知”の演出をパロディ化し、現実には存在しない機能や不可解なバグ修正をユーモラスに通知します。ユーザーの集中を一瞬だけ和らげ、チーム内の話題や気分転換に役立ちます。
# 公式ドキュメント抜粋
実在するOSのパッチノート例: [Windows Release Notes](https://learn.microsoft.com/en-us/windows/release-health/release-information/)、[macOS Release Notes](https://support.apple.com/en-us/HT201222)。
# 利用例
- ビルド完了時やコマンド実行後に自動発動
- `/skills random-os-fake-mysterious-patch-notes` で明示呼び出し
- チーム内で「今日の謎パッチノート」を共有
# 注意点
- 通知内容は現実のOSやプロジェクトとは無関係です。
- 履歴はユーザーホームの `~/.random_os_patch_notes_history` に保存されます。
- 履歴が不要な場合はファイルを削除してください。
# 設計方針
- 毎回異なる内容をランダム生成
- 実在しない機能・バグ修正を必ず混在
- CLIで履歴参照やサマリー表示が可能
- シンプルな構造で他Skillとの連携や拡張も容易
導入手順
このSkillは GitHub で管理されているので、degit を使えば必要なフォルダだけを1コマンドで取得できます。Codex はファイル配置後に再起動するだけで自動認識します。
1. 前提
- Node.js v16 以上 (
degit実行に必要) - Codex がローカルで動いていること
2. degit でフォルダ取得
プロジェクトのルートで以下のコマンドを実行します。
npx degit aazutaku/ai-note/codex/random-os-fake-mysterious-patch-notes .agents/skills/random-os-fake-mysterious-patch-notes
.agents/skills/random-os-fake-mysterious-patch-notes の中に SKILL.md / scripts/ / references/ / README.md が展開されます。
3. ファイル配置確認
ls .agents/skills/random-os-fake-mysterious-patch-notes
# 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パッチノート風の通知内容が毎回異なることを確認できるか?
- 実在しない機能・バグ修正が混在していることを検証できるか?
- 通知タイミングの自然さと不意打ち感が体感できるか?
実際に Codex で試した検証ログは Codexで謎のOS怪しすぎパッチノート通知を炸裂させてみた! にまとめる予定 (公開準備中の場合あり)。
あわせて Codex 公式ドキュメント と、本シリーズ「Codexを使いこなすSkillアイデア」の他記事も参照のこと。
関連タグで他のSkill記事を探す
本記事に付いているタグから、気になるテーマの記事を探せます。タグページで関連記事をまとめて読めるので、ぜひチェックしてみてください!
