知らなきゃ損！Antigravityで禅マスター通知を楽しむ使いこなし術

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

Antigravity を日常的に使っていると、AI coding workflow の中で意外なストレスや混乱に直面することが多い。特に repository understanding や path management の精度が workflow の快適さに直結するため、ちょっとした context のズレや directory 境界の誤認識が積もり積もって作業効率を下げてしまう。

また、通知や演出系の Skill を導入しても、実務に直結するものばかりで「ちょっとした遊び心」や「思考のリフレッシュ」を与えてくれるものは意外と少ない。そんな中、以下のような「あるある」に共感するユーザーは多いはず:

• Antigravity が context を見失って違う場所のコードを参照する
• monorepo で package を跨いだ瞬間、Antigravity が repo 構造を忘れる
• session を再開すると、前回までの context や path 指定をまるごと再説明しないといけない
• 長時間 workflow で long context が膨らみすぎて、important な情報が薄まる (stale context)
• 「ここはこういう構造のリポジトリ」というあらすじを毎回チャットの冒頭で書く羽目になる

こうした悩みの合間に、ふとしたタイミングで「完全無意味な禅問答」がOS通知として現れたら、集中が乱される一方で新たな気付きや笑いが生まれるかもしれない。

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

一言サマリ: 作業中やコマンド実行の合間にSkill。

もう少し具体化すると、このSkillを入れることで以下のような状態になる:

• Antigravity の AI coding workflow に「意図的なノイズ」を加え、作業のマンネリ化や思考の硬直をリセットできる
• repository understanding や path management で詰まった際、まったく実務に関係ない禅マスターの通知が現れ、気分転換やリフレッシュのきっかけになる
• onboarding や長時間 session の合間に、意味不明な悟りメッセージが現れてチーム内の話題作りやコミュニケーションのアクセントになる
• monorepo やディレクトリ移動時など、集中が途切れやすいタイミングで、意図せず思考を乱される体験が得られる
• 「AIとの対話が常に実務的」という固定観念を崩し、Antigravity の活用シーンを広げるエンタメ要素を追加できる

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

使う側がイメージしやすいよう、擬似 terminal で出力例を3パターン示す。Skill が返す出力は推測だが、現実的なフォーマット・現実的な長さで書く。

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

# session を新規で開始
> antigravity start

[OS通知] 禅マスターが現れた
「バグとは何かを問う前に、己を問え。」

[Antigravity] プロジェクト 'my-monorepo' をスキャン中...
[Antigravity] repository 構造解析完了。context を初期化しました。

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

> cd packages/api
# package を跨いで作業

[OS通知] 禅マスターが現れた
「コンパイルに失敗したとき、木魚を叩け。」

[Antigravity] directory 'packages/api' の context を更新しました。

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

> antigravity run test

[OS通知] 禅マスターが現れた
「今日の悟り：if文を捨てよ、道は開ける。」

[Antigravity] テスト実行結果: 12 passed, 1 failed

before / after の違い

場面	Skill 無し	Skill 有り
session 再開時	repo 構造から毎回説明、path も指定し直し	Antigravity が自動で context を復元、最小プロンプトで再開。ついでに禅マスターが現れて集中を乱す
monorepo 移動	違う package のコードを参照しがち	directory boundary を意識して必要な範囲だけ見る。禅問答で気分転換
長時間 workflow	long context で重要箇所が薄まる	意味不明な悟り通知で一度リセット。思考の切り替えに

発動方式

description マッチでの暗黙発動。

Skill の中身を全部見せる

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

.agent/skills/fake-os-zen-master-alert/
├── SKILL.md
├── scripts/
│   └── zen_master_alert.py
└── references/
    └── design_notes.md

各ファイルの役割

ファイル	役割
SKILL.md	Skill本体。frontmatter (name/description) と指示本文。Antigravity がこの内容をエージェント指示として読み込み、ユーザーのプロンプトに応じて発動します
scripts/zen_master_alert.py	fake-os-zen-master-alert: 禅マスター通知スクリプト
references/design_notes.md	概要 をまとめた参考資料

SKILL.md

---
name: fake-os-zen-master-alert
description: このSkillは、Antigravityがユーザーの作業中やコマンド実行の合間（例: ビルド、テスト、長時間の編集、ファイル保存時など）に、完全に実務無関係な禅問答風メッセージをOS通知として表示します。通知・演出・OS連携を必要とする場面で自動発動します。
---

# 機能概要
fake-os-zen-master-alertは、作業中やコマンド実行の合間に突如として“偽OSの禅マスター”が現れ、完全に実務とは無関係な禅問答や悟りの極意をOSデスクトップ通知で投げかけるSkillです。通知内容は「バグとは何かを問う前に、己を問え」「コンパイルに失敗したとき、木魚を叩け」など、思わず考え込んでしまう迷惑系・エンタメ系の内容が中心。集中を乱し、時に深遠な（？）気づきを与えることで、日々の開発作業に一風変わった刺激をもたらします。

# 使い方
このSkillは明示的な呼び出しを必要とせず、Antigravityの「semantic-match-only」トリガーで自動発動します。例えば、ビルドやテストの完了、長時間の無操作、ファイル保存、コマンド入力後の待機時など、作業の合間に適宜通知が表示されます。明示呼び出しはできませんが、Skill設定から通知頻度やON/OFFの切り替えが可能です。

# 出力例
```
[通知] 偽OS禅マスター: バグとは何かを問う前に、己を問え
[通知] 偽OS禅マスター: 今日の悟り：if文を捨てよ、道は開ける
[通知] 偽OS禅マスター: コンパイルに失敗したとき、木魚を叩け
[通知] 偽OS禅マスター: 変数名に迷うとき、まず呼吸せよ
[通知] 偽OS禅マスター: echoの裏にこそ真実がある
```

# 注意点
- 通知内容は完全に実務無関係です。実用的なアドバイスは一切含まれません。
- OSの通知機能を利用するため、通知が無効化されていると表示されません。
- 通知はローカルには保存されません。
- 頻度やON/OFFはSkill設定で調整可能です。

# 参考資料
- references/design_notes.md を参照
- 公式: https://docs.python.org/3/library/subprocess.html, https://pypi.org/project/plyer/

scripts/zen_master_alert.py

import random
import time
import argparse
import sys
import os
from threading import Thread, Event

try:
    from plyer import notification
except ImportError:
    print('plyerパッケージが必要です。pip install plyer でインストールしてください。')
    sys.exit(1)

ZEN_MESSAGES = [
    'バグとは何かを問う前に、己を問え',
    '今日の悟り：if文を捨てよ、道は開ける',
    'コンパイルに失敗したとき、木魚を叩け',
    '変数名に迷うとき、まず呼吸せよ',
    'echoの裏にこそ真実がある',
    'lsの結果に惑わされるな、心の中のディレクトリを見よ',
    'git pushする前に、己の執着をpushせよ',
    'カーネルパニックは心の乱れ',
    'sudoの力に頼るな、自らの力を信じよ',
    'rm -rfの前に、執着を手放せ',
    'エラーは敵にあらず、師である',
    'forループの中に悟りはない、一歩外に出よ',
    'printデバッグは禅問答の如し',
    'パーミッション denied、それは宇宙の采配',
    'セグフォルトは一瞬の無常',
    'コマンドの失敗は、成功への布石',
    'ls -laの闇に、己の影を見る',
    '再起動は再誕なり',
    'manページに書かれていない答えもある',
    'コマンドラインの静寂に耳を澄ませ'
]

DEFAULT_INTERVAL = 600  # 秒（10分ごと）
MIN_INTERVAL = 30       # 最小30秒
MAX_INTERVAL = 3600     # 最大1時間

class ZenMasterNotifier(Thread):
    def __init__(self, interval=DEFAULT_INTERVAL, stop_event=None):
        super().__init__()
        self.interval = interval
        self.stop_event = stop_event or Event()
        self.running = False

    def run(self):
        self.running = True
        while not self.stop_event.is_set():
            message = random.choice(ZEN_MESSAGES)
            try:
                notification.notify(
                    title='偽OS禅マスター',
                    message=message,
                    app_name='fake-os-zen-master-alert',
                    timeout=10
                )
            except Exception as e:
                print(f'通知エラー: {e}')
            # ランダムなタイミングも混ぜる
            sleep_time = random.randint(int(self.interval*0.8), int(self.interval*1.2))
            for _ in range(sleep_time):
                if self.stop_event.is_set():
                    break
                time.sleep(1)
        self.running = False

    def stop(self):
        self.stop_event.set()


def list_messages():
    print('--- 禅マスター通知メッセージ一覧 ---')
    for i, msg in enumerate(ZEN_MESSAGES, 1):
        print(f'{i:2}: {msg}')


def send_once():
    message = random.choice(ZEN_MESSAGES)
    try:
        notification.notify(
            title='偽OS禅マスター',
            message=message,
            app_name='fake-os-zen-master-alert',
            timeout=10
        )
        print(f'[通知] {message}')
    except Exception as e:
        print(f'通知エラー: {e}')


def main():
    parser = argparse.ArgumentParser(description='fake-os-zen-master-alert: 禅マスター通知スクリプト')
    subparsers = parser.add_subparsers(dest='command')

    # サブコマンド: start (常駐)
    p_start = subparsers.add_parser('start', help='定期的に禅マスター通知を表示（デフォルト10分ごと）')
    p_start.add_argument('--interval', type=int, default=DEFAULT_INTERVAL, help='通知間隔（秒, 30〜3600）')

    # サブコマンド: once (1回だけ通知)
    subparsers.add_parser('once', help='1回だけ禅マスター通知を表示')

    # サブコマンド: list (メッセージ一覧)
    subparsers.add_parser('list', help='禅マスター通知メッセージ一覧を表示')

    args = parser.parse_args()

    if args.command == 'start':
        interval = args.interval
        if interval < MIN_INTERVAL or interval > MAX_INTERVAL:
            print(f'通知間隔は{MIN_INTERVAL}〜{MAX_INTERVAL}秒の範囲で指定してください。')
            sys.exit(1)
        print(f'fake-os-zen-master-alert: {interval}秒ごとに禅マスター通知を表示します。停止はCtrl+C')
        stop_event = Event()
        notifier = ZenMasterNotifier(interval=interval, stop_event=stop_event)
        try:
            notifier.start()
            while notifier.running:
                time.sleep(1)
        except KeyboardInterrupt:
            print('\n停止中...')
            notifier.stop()
            notifier.join()
        print('終了しました。')
    elif args.command == 'once':
        send_once()
    elif args.command == 'list':
        list_messages()
    else:
        parser.print_help()

if __name__ == '__main__':
    main()

references/design_notes.md

# 概要
fake-os-zen-master-alertは、開発者の集中を絶妙に乱すための迷惑系エンタメSkillです。完全に実務無関係な禅問答をOS通知で表示し、作業の合間に“無意味な気づき”を与えることを目的としています。

# 公式ドキュメント抜粋
通知機能はPythonの外部ライブラリ「plyer」を利用しています。plyerはクロスプラットフォームでOS通知を送るためのAPIを提供します。
- plyer: https://pypi.org/project/plyer/
- Python subprocess: https://docs.python.org/3/library/subprocess.html

# 利用例
- 長時間のビルドやテスト待ち時間に、突然禅マスターが現れて通知を表示
- コマンド実行後のアイドル時に、思考を混乱させるメッセージ
- Skill設定から通知頻度やON/OFF切り替えが可能

# 注意点
- 通知内容は完全にジョークです。実務的なヒントや警告は一切含まれません。
- plyerの通知APIはOSによって挙動が異なる場合があります。通知が無効化されていると表示されません。

# 設計方針
- メッセージは完全に無意味かつ禅問答風であることを重視
- 実際のOS通知APIのみ使用し、架空のCLIや関数は使わない
- ユーザーが頻度やON/OFFを調整できるよう設計

導入手順

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

1. 前提

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

2. degit でフォルダ取得

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

npx degit aazutaku/ai-note/antigravity/fake-os-zen-master-alert .agent/skills/fake-os-zen-master-alert

.agent/skills/fake-os-zen-master-alert の中に SKILL.md / scripts/ / references/ / README.md が展開されます。

3. ファイル配置確認

ls .agent/skills/fake-os-zen-master-alert
# 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 でも有効か?
• プロジェクト指示との連携をどう組み立てるか?
• 通知メッセージが完全に実務無関係かつ禅問答風になっているか
• OS通知として確実に表示されるか、頻度やON/OFF制御の操作感はどうか

実際に Antigravity で試した検証ログは Antigravityの新感覚迷惑通知を試してみた！禅マスターが作業を邪魔する楽しさ にまとめる予定 (公開準備中の場合あり)。
あわせて 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の提案記事一覧の一覧はこちら