目次
Codex ユーザーが日常でぶつかる悩み
AI coding workflow を日々回していると、ちょっとした「間」が気まずいことや、集中が切れる瞬間があります。特に通知や演出まわりが希薄なまま作業を続けると、気分転換のきっかけもなく、淡々とした画面に疲労感が溜まりがちです。Codex での作業中、こんな悩みを感じたことはありませんか？
- Codex が context を見失って違う場所のコードを参照する
- monorepo で package を跨いだ瞬間、Codex が repo 構造を忘れる
- session を再開すると、前回までの context や path 指定をまるごと再説明しないといけない
- 長時間 workflow で long context が膨らみすぎて、important な情報が薄まる (stale context)
- 「ここはこういう構造のリポジトリ」というあらすじを毎回チャットの冒頭で書く羽目になる
さらに、無機質な作業画面が続くことで「ちょっとした遊び心」や「気分転換」の余地がなくなり、オンボーディングや長時間の repo 作業が単調になりがちです。通知・演出・OS連携系の Skill が不足していると、こうした細かなストレスが積み重なります。
この Skill が一言でいうと何を解決するか
一言サマリ: あなたの作業気分Skill。
このSkillを導入すると、作業の合間や session の切り替え時に、完全ランダムな“気分天気”アイコンがデスクトップの片隅に表示されます。実際の天気や本当の気分とは無関係に、晴れ・雪・雷など多彩なアイコンが現れ、作業画面に予測不能な演出をもたらします。
- 作業中の気分転換やリフレッシュが自然に発生し、長時間の AI coding workflow でも集中力を維持しやすくなる
- monorepo や複雑な repo 構造の作業でも、気分天気アイコンが context 切り替えの目印や話題作りになる
- onboarding 時や session 再開時、無機質な画面にちょっとしたユーモアが加わり、チーム内コミュニケーションのネタにも
- directory や path 管理の合間に、理不尽な天気演出で思わずツッコミたくなる体験を提供
- 毎回異なるアイコンが出るため、memory や context の stale 感をリセットするきっかけにも
QUICK INSTALL
このSkillをすぐ試す
GitHub から degit でコマンド1行、Codex の Skill ディレクトリに展開できます。Node.js があれば即時に動きます。
npx degit aazutaku/ai-note/codex/desktop-mood-weather .agents/skills/desktop-mood-weather実行したらこうなる (3つの利用シーン)
使う側がイメージしやすいよう、擬似 terminal で出力例を3パターン示します。
シーン1: session 開始時 (プロジェクト初動で)
# /skills menu で Skill 一覧を表示
/skills menu
[Codex] Skill の中身を全部見せる
.agents/skills/desktop-mood-weather/ に配置するファイル一覧です。GitHub に push 済みなので、上記の degit コマンドで一発取得できます。
.agents/skills/desktop-mood-weather/
├── SKILL.md
├── scripts/
│ └── desktop_mood_weather.py
└── references/
└── design_notes.md
各ファイルの役割
ファイル
役割
SKILL.mdSkill本体。frontmatter (name/description) と指示本文。Codex がこの内容をエージェント指示として読み込み、ユーザーのプロンプトに応じて発動します
scripts/desktop_mood_weather.pydesktop-mood-weather: デスクトップにランダム天気アイコンを表示
references/design_notes.md概要 をまとめた参考資料
SKILL.md
---
name: desktop-mood-weather
description: デスクトップの片隅に完全ランダムな“気分天気”アイコンを表示したいとき、または「天気」や「気分」「演出」などのキーワードを含む会話や明示呼び出し時に発動します。実際の天気や気分とは無関係な演出が必要な場合に適しています。
---
# 機能概要
このSkillは、デスクトップの片隅に完全ランダムな“気分天気”アイコンを表示します。実際の天気やユーザーの気分状態とは一切連動せず、晴れ・曇り・雨・雷・雪などの天気アイコンが毎回ランダムで現れます。開発中や会議中、ふとした瞬間に理不尽な天気演出で画面に遊び心を加え、作業の気分転換や雑談のきっかけを提供します。
# 使い方
- 明示呼び出し例: `/skills menu` で「desktop-mood-weather」を選択、または `$desktop-mood-weather` と入力。
- 暗黙発動キーワード例: 「天気」「気分」「演出」「アイコン」「画面の端」「ランダム」などの語句を含む会話や説明文。
- Skillはsemantic-or-explicitトリガー型で、常時または明示的に呼び出せます。
# 出力例
```
[INFO] desktop-mood-weather: ランダム天気アイコン「雷」がデスクトップ右下に表示されました。
[INFO] desktop-mood-weather: 本日の気分天気は「雪」です。
[INFO] desktop-mood-weather: ウィンドウID=0x3e00007c, アイコン=rain.png, 位置=(screen_width-64, screen_height-64)
[INFO] desktop-mood-weather: 10分ごとに気分天気を再抽選します。
[INFO] desktop-mood-weather: 実際の天気や気分とは一切関係ありません。
```
# 注意点
- 実際の天候やユーザーの感情状態とは完全に無関係です。
- アイコン画像はローカル保存または一時生成されます。
- Windows/Mac/Linuxの主要デスクトップ環境で動作しますが、仮想環境やリモートデスクトップでは非対応の場合があります。
- 複数回起動時も毎回異なる天気が出る仕様です。
# 参考資料
- [PySimpleGUI公式](https://pysimplegui.readthedocs.io/)
- references/design_notes.md で設計方針や利用例を解説
scripts/desktop_mood_weather.py
import os
import sys
import random
import time
import argparse
from pathlib import Path
import threading
import PySimpleGUI as sg
# 天気アイコンの種別とファイル名 (最低限のSVG/PNGを同梱または生成)
WEATHER_TYPES = [
{"name": "晴れ", "file": "sun.png"},
{"name": "曇り", "file": "cloud.png"},
{"name": "雨", "file": "rain.png"},
{"name": "雷", "file": "thunder.png"},
{"name": "雪", "file": "snow.png"},
{"name": "あらし", "file": "storm.png"},
]
ICON_DIR = Path(__file__).parent / "icons"
ICON_SIZE = (64, 64)
# アイコン画像がなければサンプルPNGを生成 (簡易的な色付き四角)
def ensure_icons():
ICON_DIR.mkdir(exist_ok=True)
try:
from PIL import Image, ImageDraw, ImageFont
except ImportError:
print("[WARN] Pillow未インストールのためアイコン自動生成はスキップします。")
return
color_map = {
"sun.png": (255, 220, 0),
"cloud.png": (180, 180, 180),
"rain.png": (80, 140, 255),
"thunder.png": (255, 200, 0),
"snow.png": (220, 240, 255),
"storm.png": (100, 100, 120),
}
for w in WEATHER_TYPES:
f = ICON_DIR / w["file"]
if not f.exists():
img = Image.new("RGB", ICON_SIZE, color_map[w["file"]])
d = ImageDraw.Draw(img)
font = None
try:
font = ImageFont.truetype("arial.ttf", 24)
except:
font = None
d.text((8, 16), w["name"], fill=(0,0,0), font=font)
img.save(f)
# 現在の画面サイズを取得
def get_screen_size():
try:
return sg.Window.get_screen_size()
except Exception:
return (800, 600)
# ランダムな天気を選ぶ
def pick_random_weather():
return random.choice(WEATHER_TYPES)
# メインウィンドウを表示
def show_weather_icon(weather, duration=600):
screen_w, screen_h = get_screen_size()
icon_path = str(ICON_DIR / weather["file"])
layout = [[sg.Image(filename=icon_path, size=ICON_SIZE, pad=(0,0))]]
window = sg.Window(
f"気分天気: {weather['name']}",
layout,
no_titlebar=True,
keep_on_top=True,
alpha_channel=0.95,
grab_anywhere=False,
finalize=True,
location=(screen_w - ICON_SIZE[0] - 16, screen_h - ICON_SIZE[1] - 64),
margins=(0,0),
element_justification='center',
background_color='#ffffff',
)
# 10分(600秒)表示。ESCキーやクリックで即終了
start = time.time()
while True:
event, values = window.read(timeout=100)
if event == sg.WIN_CLOSED or event == 'Escape' or event == '__TIMEOUT__':
if time.time() - start > duration:
break
if event == '__TIMEOUT__' and (time.time() - start > duration):
break
window.close()
# CLIサブコマンド: show, list, summary
def list_weathers():
print("[INFO] サポートされる気分天気:")
for w in WEATHER_TYPES:
print(f"- {w['name']} ({w['file']})")
def summary():
print("desktop-mood-weather Skill 概要:")
print("- デスクトップ右下にランダムな天気アイコンを表示")
print("- 実際の天気や気分とは一切連動しません")
print("- アイコンは10分ごとに再抽選可能")
print("- 明示/暗黙トリガーで発動")
def main():
parser = argparse.ArgumentParser(description="desktop-mood-weather: デスクトップにランダム天気アイコンを表示")
subparsers = parser.add_subparsers(dest='command')
subparsers.required = False
show_parser = subparsers.add_parser('show', help='気分天気アイコンを表示')
show_parser.add_argument('--duration', type=int, default=600, help='表示秒数 (デフォルト600)')
list_parser = subparsers.add_parser('list', help='サポート天気一覧')
summary_parser = subparsers.add_parser('summary', help='Skill概要')
args = parser.parse_args()
ensure_icons()
if args.command == 'list':
list_weathers()
return
if args.command == 'summary':
summary()
return
# デフォルトまたはshowコマンド
weather = pick_random_weather()
print(f"[INFO] desktop-mood-weather: ランダム天気アイコン「{weather['name']}」がデスクトップ右下に表示されました。")
print(f"[INFO] desktop-mood-weather: 本日の気分天気は「{weather['name']}」です。")
print(f"[INFO] desktop-mood-weather: アイコン={weather['file']}, 位置=(右下)")
print("[INFO] desktop-mood-weather: 実際の天気や気分とは一切関係ありません。")
show_weather_icon(weather, duration=args.duration)
if __name__ == '__main__':
main()
references/design_notes.md
# 概要
このSkillは、デスクトップの片隅に完全ランダムな天気アイコンを表示することで、作業環境に遊び心や意外性を加えることを目的としています。天気や気分の実態とは無関係な演出で、会話や作業の合間に小さな話題やリフレッシュ効果をもたらします。
# 公式ドキュメント抜粋
- PySimpleGUI: https://pysimplegui.readthedocs.io/
- Pillow: https://pillow.readthedocs.io/
# 利用例
- チーム開発中、画面右下に突如「大雪」や「雷」アイコンが現れ、雑談やアイスブレイクのきっかけに。
- シリアスな会議中に「晴れ」マークが表示され、場の空気が和む。
# 注意点
- 実際の天気APIや感情認識APIは一切使わず、完全にランダムな演出です。
- デスクトップの描画位置は環境により微調整が必要な場合があります。
- アイコン画像はローカル生成または同梱されますが、Pillow未インストール時は色付き四角で代用します。
# 設計方針
- シンプルかつOS横断的な実装のためPySimpleGUIを採用。
- 起動のたびに毎回異なる天気を表示し、繰り返し利用時も飽きさせない工夫を重視しています。
導入手順
このSkillは GitHub で管理されているので、degit を使えば必要なフォルダだけを1コマンドで取得できます。Codex はファイル配置後に再起動するだけで自動認識します。
1. 前提
- Node.js v16 以上 (
degit 実行に必要)
- Codex がローカルで動いていること
2. degit でフォルダ取得
プロジェクトのルートで以下のコマンドを実行します。
npx degit aazutaku/ai-note/codex/desktop-mood-weather .agents/skills/desktop-mood-weather
.agents/skills/desktop-mood-weather の中に SKILL.md / scripts/ / references/ / README.md が展開されます。
3. ファイル配置確認
ls .agents/skills/desktop-mood-weather
# 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記事を探す
本記事に付いているタグから、気になるテーマの記事を探せます。タグページで関連記事をまとめて読めるので、ぜひチェックしてみてください！
