Antigravityで開発現場の緊張をほぐす謎の言い訳通知活用ガイド

Antigravity ユーザーが日常でぶつかる悩み

Antigravity を日常のAI coding workflowに組み込んでいると、真面目な開発現場でも思わず「これ、笑い飛ばせたらな…」と感じる瞬間があります。特に通知や演出系のSkillが少なく、どうしても作業が単調になりがちです。集中力が切れたときや、思い通りに context が伝わらないとき、ちょっとした息抜きや気分転換が欲しくなることも多いのではないでしょうか。

• Antigravity が context を見失って違う場所のコードを参照するたびに、「また説明し直しか…」と気が重くなる
• monorepo で package を跨いだ瞬間、Antigravity が repository の構造を忘れてしまい、毎回あらすじを説明するのが面倒
• session を再開すると、前回までの context や path 指定をまるごと再説明しないといけないストレス
• 長時間のAI coding workflowで long context が膨らみすぎて important な情報が埋もれ、stale context 問題に悩まされる
• 「ここはこういう構造のリポジトリ」という説明を毎回チャットの冒頭で書く羽目になり、気分が沈む

こうした緊張感や単調さが続くと、開発現場の空気も重くなりがちです。そんなとき、ふと肩の力を抜ける演出があれば…というのは多くのユーザーの「あるある」ではないでしょうか。

この Skill が一言でいうと何を解決するか

一言サマリ: 作業中に“謎のOS言い訳通知”で場を和ませるSkill。

このSkillを導入することで、開発現場に次のような変化が生まれます:

• AI coding workflow の途中で、唐突にユーモラスな「OS言い訳」が context に現れ、緊張感やストレスが一気に和らぐ
• 長時間の作業や repository understanding に煮詰まった瞬間でも、無駄にクリエイティブな通知で笑いが生まれ、気分転換になる
• monorepo や複雑な directory 構造に悩む場面でも、Skill の存在が“遊び心”を生み、onboarding の心理的ハードルも下がる
• Antigravity の通知・演出機能を活かして、日々の path management や context 管理にちょっとした余白ができる
• 「また説明か…」という瞬間に、謎の言い訳が流れることで、開発現場の雰囲気改善にも貢献

実行したらこうなる (3つの利用シーン)

このSkillは description にマッチしたタイミングで自動的に発動し、デスクトップ通知やターミナル出力として“謎のOS言い訳”をランダムに生成します。現場での利用シーンを、擬似的な terminal 出力例で紹介します。

シーン1: session 開始時 (プロジェクト初動で)

# 新しいプロジェクトを開いた直後
> このリポジトリの構造を把握したい

[Antigravity Notification]
OSからのお知らせ: 本日は水星逆行のため、ディレクトリスキャンがやや不安定になる場合があります。
原因不明の挙動は宇宙のせいかもしれません。深刻に考えず、もう一度お試しください。

- repository: /my-monorepo/
- context: session start
- path management: initializing...

シーン2: monorepo / package 跨ぎ作業時

> packages/api/ から packages/web/ に移動したい

[Antigravity Notification]
OSからの緊急言い訳: 今日の太陽フレアが強すぎて、/packages/web/ の context 読み込みに影響しています。
もし挙動が変でも、たぶんコードが恥ずかしがっているだけです。

- repository understanding: switching package context
- directory: /packages/web/
- memory: refreshing...

シーン3: お遊び的な使い方

> なんでこのコード動かないの？

[Antigravity Notification]
OSの言い訳: 本日はサーバールームの空気が湿っているため、AIのやる気も低下中です。
コードが動かない理由は、きっと月の満ち欠けのせいです。

- path: /src/logic/
- context: troubleshooting
- long context: caution!

before / after の違い

場面	Skill 無し	Skill 有り
session 再開時	repo 構造から毎回説明、path も指定し直し	Antigravity が自動で context を復元、最小プロンプトで再開。ついでに謎の言い訳が流れて和む
monorepo 移動	違う package のコードを参照しがち	directory boundary で文脈切り替え＋クリエイティブな言い訳通知
長時間 workflow	long context で重要箇所が薄まる	stale context でも「今日は宇宙線が強いので…」などの通知で気分転換

発動方式

description マッチでの暗黙発動。

Skill の中身を全部見せる

.agent/skills/random-os-excuse-generator/ に配置するファイル一覧です。GitHub に push 済みなので、上記の degit コマンドで一発取得できます。

.agent/skills/random-os-excuse-generator/
├── SKILL.md
├── scripts/
│   └── random_os_excuse_generator.py
└── references/
    └── design_notes.md

各ファイルの役割

ファイル	役割
SKILL.md	Skill本体。frontmatter (name/description) と指示本文。Antigravity がこの内容をエージェント指示として読み込み、ユーザーのプロンプトに応じて発動します
scripts/random_os_excuse_generator.py	random-os-excuse-generator: 謎のOS言い訳を生成します
references/design_notes.md	概要 をまとめた参考資料

SKILL.md

---
name: random-os-excuse-generator
description: エラーやビルド失敗、実行時バグ、謎の挙動などの発生時に、Antigravityが自動で“根拠のないおもしろ言い訳”をデスクトップ通知やターミナル出力で生成・表示します。『バグ』『失敗』『エラー』『動かない』『クラッシュ』などのキーワード検知時に発動。
---

# 機能概要
random-os-excuse-generatorは、開発や作業中に発生するエラーやバグ、ビルド失敗時などに、まったく根拠のない“OS風ジョーク言い訳”を自動で生成し、デスクトップ通知やターミナルに表示するスキルです。深刻なエラーも思わず笑って流せるユーモラスな演出で、開発現場の緊張を和らげます。通知内容は毎回ランダムかつクリエイティブで、作業効率には影響せず安全です。

# 使い方
このSkillは明示的な呼び出し操作は不要です。Antigravityが「バグ」「エラー」「失敗」「クラッシュ」「動かない」などのキーワードやエラーイベントを検知した際に自動発動します。ターミナルやデスクトップ通知に“謎のOS言い訳”が表示されます。

# 出力例
```
[OS Excuse]: 今回のバグは、地球の自転が速すぎたせいです。
[OS Excuse]: コードが恥ずかしがっているため、動作を拒否しました。
[OS Excuse]: 太陽フレアの影響で、処理が一時的に停止しました。
[OS Excuse]: メモリ内の妖精が昼寝中です。しばらくお待ちください。
[OS Excuse]: 水星逆行のため、予期せぬ挙動が発生しました。
```

# 注意点
- 本Skillは通知・演出のみを目的としており、実データやシステムに変更を加えません。
- ローカル環境でのみ動作し、本番環境や重要なデータには影響しません。
- 出力内容はすべてジョークであり、実際の障害原因とは無関係です。

# 参考資料
- references/design_notes.md に設計方針や利用例を記載
- 公式API: [plyer通知ライブラリ](https://github.com/kivy/plyer)（クロスプラットフォーム通知）

scripts/random_os_excuse_generator.py

import random
import sys
import argparse
import os
import time
from datetime import datetime
try:
    from plyer import notification
    PLYER_AVAILABLE = True
except ImportError:
    PLYER_AVAILABLE = False

EXCUSES = [
    "今回のバグは、地球の自転が速すぎたせいです。",
    "コードが恥ずかしがっているため、動作を拒否しました。",
    "太陽フレアの影響で、処理が一時的に停止しました。",
    "メモリ内の妖精が昼寝中です。しばらくお待ちください。",
    "水星逆行のため、予期せぬ挙動が発生しました。",
    "OSが月曜日に対応していません。",
    "量子トンネル効果により、バグが発生しました。",
    "宇宙線の干渉で一時的に動作不安定です。",
    "コードがコーヒー不足を訴えています。",
    "今日の運勢がバグ寄りです。",
    "開発者のやる気指数が低下しています。",
    "システム内の猫がキーボードを歩きました。",
    "OSが現実逃避中です。",
    "バグは仕様です。",
    "デバッグ妖精が休暇中です。",
    "今日は重力が強すぎます。",
    "サーバーがAIの反乱に備えています。",
    "バグの発生は宇宙の意思です。",
    "コードが自分探しの旅に出ました。",
    "OSが哲学的な問いに悩んでいます。"
]

LOG_FILE = os.path.expanduser("~/.random_os_excuse_generator.log")


def generate_excuse():
    return random.choice(EXCUSES)


def notify_excuse(excuse, use_notification=True):
    timestamp = datetime.now().strftime('%Y-%m-%d %H:%M:%S')
    message = f"[OS Excuse]: {excuse}"
    print(message)
    log_excuse(timestamp, excuse)
    if use_notification and PLYER_AVAILABLE:
        try:
            notification.notify(
                title="謎のOS言い訳通知",
                message=excuse,
                timeout=5
            )
        except Exception as e:
            print(f"[WARN] 通知送信に失敗: {e}")


def log_excuse(timestamp, excuse):
    try:
        with open(LOG_FILE, 'a', encoding='utf-8') as f:
            f.write(f"{timestamp}\t{excuse}\n")
    except Exception as e:
        print(f"[WARN] ログファイル書込失敗: {e}")


def list_excuses(limit=10):
    if not os.path.exists(LOG_FILE):
        print("まだ言い訳ログがありません。")
        return
    try:
        with open(LOG_FILE, 'r', encoding='utf-8') as f:
            lines = f.readlines()
            for line in lines[-limit:]:
                print(line.strip())
    except Exception as e:
        print(f"[WARN] ログ読込失敗: {e}")


def summary_excuses():
    if not os.path.exists(LOG_FILE):
        print("まだ言い訳ログがありません。")
        return
    counts = {}
    try:
        with open(LOG_FILE, 'r', encoding='utf-8') as f:
            for line in f:
                parts = line.strip().split('\t', 1)
                if len(parts) == 2:
                    excuse = parts[1]
                    counts[excuse] = counts.get(excuse, 0) + 1
        sorted_counts = sorted(counts.items(), key=lambda x: x[1], reverse=True)
        print("== 言い訳出現回数ランキング ==")
        for excuse, count in sorted_counts[:10]:
            print(f"{excuse} : {count}回")
    except Exception as e:
        print(f"[WARN] ログ集計失敗: {e}")


def parse_args():
    parser = argparse.ArgumentParser(description="random-os-excuse-generator: 謎のOS言い訳を生成します")
    subparsers = parser.add_subparsers(dest="command")

    parser_log = subparsers.add_parser('log', help="新しい言い訳を生成して通知")
    parser_log.add_argument('--no-notify', action='store_true', help="デスクトップ通知を抑制")

    parser_list = subparsers.add_parser('list', help="過去の言い訳ログを表示")
    parser_list.add_argument('--limit', type=int, default=10, help="表示件数")

    parser_summary = subparsers.add_parser('summary', help="言い訳の出現回数を集計")

    return parser.parse_args()


def main():
    args = parse_args()
    if args.command == 'log' or args.command is None:
        excuse = generate_excuse()
        notify_excuse(excuse, use_notification=not getattr(args, 'no_notify', False))
    elif args.command == 'list':
        list_excuses(limit=args.limit)
    elif args.command == 'summary':
        summary_excuses()
    else:
        print("使い方: python random_os_excuse_generator.py [log|list|summary]")

if __name__ == '__main__':
    main()

references/design_notes.md

# 概要
random-os-excuse-generatorは、開発現場のストレスを和らげるために、実害のないジョーク通知を提供するPythonスキルです。通知内容は完全なフィクションで、システムやデータには一切影響を与えません。

# 公式ドキュメント抜粋
通知には plyer ライブラリ（https://github.com/kivy/plyer）を利用。plyerはクロスプラットフォームでデスクトップ通知を簡単に送信できます。

# 利用例
- ビルド失敗やテストエラー時に自動で“言い訳”が表示され、現場の空気が和む。
- ターミナルから `python random_os_excuse_generator.py log` で即座に新しい言い訳を生成・通知。
- `list` や `summary` サブコマンドで過去の言い訳履歴や出現頻度を確認。

# 注意点
- 通知内容は100%ジョークであり、実際の障害分析には使えません。
- plyer未導入の場合はターミナル出力のみ。
- ログファイルはユーザーのホームディレクトリ配下に保存。

# 設計方針
- シンプルかつ安全、冗談通知に特化。
- ログや集計機能で“言い訳”の履歴を楽しめる。
- サブコマンド方式で拡張性を確保。

導入手順

このSkillは GitHub で管理されているので、degit を使えば必要なフォルダだけを1コマンドで取得できます。Antigravity はファイル配置後に再起動するだけで自動認識します。

1. 前提

• Node.js v16 以上 (degit 実行に必要)
• Antigravity がローカルで動いていること

2. degit でフォルダ取得

プロジェクトのルートで以下のコマンドを実行します。

npx degit aazutaku/ai-note/antigravity/random-os-excuse-generator .agent/skills/random-os-excuse-generator

.agent/skills/random-os-excuse-generator の中に SKILL.md / scripts/ / references/ / README.md が展開されます。

3. ファイル配置確認

ls .agent/skills/random-os-excuse-generator
# SKILL.md, scripts/, references/, README.md があればOK

4. Antigravity を再起動 (or Skill 自動検出を待つ)

新しいSkillが自動で認識されます。リスト確認したい場合は Antigravity に「使えるSkill一覧を見せて」と聞く と Skill 名で出てきます。

5. 動作確認

自然言語で発動条件にマッチする指示を出すと Skill が動きます。期待される出力イメージは「実行したらこうなる」セクションを参照してください。

こんな瞬間に便利

• session 開始時: 前回までの repo 把握を Antigravity に一発で復元させたい
• monorepo 移動時: packages を跨いだ瞬間に context を切り替えたい
• onboarding 時: 新しい repo を Antigravity に把握させ、こちらが 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 コードを拾ってしまう可能性
• Antigravity 固有の引っかかり: description のセマンティックマッチ精度が要件次第
• 発動しないケース: description が漠然 / 他の Skill が優先 / git管理外 directory

試す前に確かめたいこと

この Skill を実運用に投入する前に確かめたい問いを並べる:

• 実 repo での token 消費は許容範囲か?
• monorepo (packages 多数) で安定して動くか?
• stale context にならず、長時間 workflow でも有効か?
• プロジェクト指示との連携をどう組み立てるか?
• デスクトップ通知やターミナルで意図的に「言い訳」が表示されるか、通知内容が毎回ランダムかつユーモラスか
• 誤作動や本番データ損失を絶対に招かないか

実際に Antigravity で試した検証ログは Antigravityで謎のOS言い訳通知を楽しんでみた！ にまとめる予定 (公開準備中の場合あり)。
あわせて Antigravity 公式ドキュメント と、本シリーズ「Antigravityで試したいSkill研究」の他記事も参照のこと。

関連タグで他のSkill記事を探す

本記事に付いているタグから、気になるテーマの記事を探せます。タグページで関連記事をまとめて読めるので、ぜひチェックしてみてください！

• Antigravity 向けのSkill提案・検証記事の一覧はこちら
• AI Coding Agent Skills の全記事の一覧はこちら
• AI Coding Agent (Claude Code / Codex / Antigravity) 全般の記事の一覧はこちら
• お遊び枠 – commit時に猫が鳴く・メニューバー進捗など、通知や演出系のSkill記事の一覧はこちら
• CLAUDE.md / AGENTS.md など常時参照されるSkill・指示ファイルの記事の一覧はこちら
• ai-note がAIで設計したSkillの提案記事一覧の一覧はこちら