/bump-catalog

name: bump-catalog
description: >-
  Promote frequently used mojiemoji variants from the local usage cache into
  prestamp-catalog.yml and open a deterministic catalog update pull request.
allowed-tools:
  # bump_catalog.py 本体。`--dry-run` / `--apply` / `--pr` <img src="https://mojiemoji.jozo.beer/emoji/%E3%83%A2%E3%83%BC%E3%83%89?font=hachimaru&amp;color=4ade80&amp;animation=bane&amp;background=transparent&amp;outline=4a16a3&amp;outline_width=2" alt="モード" height="24" align="absmiddle">全てで使用。
  # `--pr` <img src="https://mojiemoji.jozo.beer/emoji/%E3%83%A2%E3%83%BC%E3%83%89?font=noto&amp;color=22c55e&amp;animation=kage_neon&amp;background=transparent&amp;outline=5e22c5&amp;outline_width=2" alt="モード" height="24" align="absmiddle">では内部から `git` / `gh pr create` を `system()` で呼ぶが、
  # Ruby プロセス内 subprocess なので外側の Bash gate 1 つで通る。
  - Bash(python3 skills/mojiemoji-github/scripts/bump_catalog.py*)
  - Bash(python3 */skills/mojiemoji-github/scripts/bump_catalog.py*)

Bump Catalog

`mojiemoji-github` <img src="https://mojiemoji.jozo.beer/emoji/%E3%83%97%E3%83%A9%E3%82%B0?font=kurobara&amp;color=60a5fa&amp;animation=psycho&amp;background=transparent&amp;outline_width=0" alt="プラグ" height="24" align="absmiddle">インの catalog をローカル usage cache から <img src="https://mojiemoji.jozo.beer/emoji/%E8%87%AA%E5%8B%95?font=kurobara&amp;color=4ade80&amp;animation=zairu&amp;background=transparent&amp;outline=4a16a3&amp;outline_width=2" alt="自動" height="24" align="absmiddle">的に育てる skill。selector subagent が catalog miss した term に flavor を選定したとき、`cache_record.py` が JSONL に<img src="https://mojiemoji.jozo.beer/emoji/%E8%BF%BD%E8%A8%98?font=zero&amp;color=f59e0b&amp;animation=yatta&amp;background=transparent&amp;outline=0bf59e&amp;outline_width=2" alt="追記" height="24" align="absmiddle">する。 この skill はその cache を集計して、しきい値を満たした variant を `prestamp-catalog.yml` に昇格させる <img src="https://mojiemoji.jozo.beer/emoji/PR?font=hachimaru&amp;color=ef4444&amp;animation=bure&amp;background=transparent&amp;outline=44ef44&amp;outline_width=2" alt="PR" height="24" align="absmiddle"> を 1 件作る。

**全工程はトークン<img src="https://mojiemoji.jozo.beer/emoji/%E4%B8%8D%E8%A6%81?font=hachimaru&amp;color=3b82f6&amp;animation=tatemoya&amp;background=transparent&amp;outline=f63b82&amp;outline_width=2" alt="不要" height="24" align="absmiddle">・LLM <img src="https://mojiemoji.jozo.beer/emoji/%E4%B8%8D%E8%A6%81?font=mincho&amp;color=8b5cf6&amp;animation=gatagata&amp;background=transparent&amp;outline=f68b5c&amp;outline_width=2" alt="不要" height="24" align="absmiddle">・<img src="https://mojiemoji.jozo.beer/emoji/%E6%B1%BA%E5%AE%9A?font=zero&amp;color=10b981&amp;animation=mozaiku&amp;background=transparent&amp;outline=8110b9&amp;outline_width=2" alt="決定" height="24" align="absmiddle">論的。** この<img src="https://mojiemoji.jozo.beer/emoji/%E3%82%B9%E3%82%AD%E3%83%AB?font=hachimaru&amp;color=60a5fa&amp;animation=kage_neon&amp;background=transparent&amp;outline=eb2563&amp;outline_width=2" alt="スキル" height="24" align="absmiddle">本体は単にスクリプトを呼ぶだけ。

起動条件

ユーザーが明示的に「catalog を育てて」「bump-catalog 走らせて」など 要求したとき。あるいは `/bump-catalog` を叩いたとき。

<img src="https://mojiemoji.jozo.beer/emoji/%E6%89%8B%E9%A0%86?font=kurobara&amp;color=c084fc&amp;animation=kaiten&amp;speed=slow&amp;background=transparent&amp;outline=fcc084&amp;outline_width=2" alt="手順" height="24" align="absmiddle">

1. まず引数なしで dry-run して何が<img src="https://mojiemoji.jozo.beer/emoji/%E8%BF%BD%E5%8A%A0?font=maru&amp;color=3b82f6&amp;animation=chirichiri&amp;background=transparent&amp;outline=f63b82&amp;outline_width=2" alt="追加" height="24" align="absmiddle">されるか<img src="https://mojiemoji.jozo.beer/emoji/%E7%A2%BA%E8%AA%8D?font=toge&amp;color=f59e0b&amp;animation=zanzo&amp;background=transparent&amp;outline=0bf59e&amp;outline_width=2" alt="確認" height="24" align="absmiddle">する(デフォルトが `--dry-run` なので破壊的操作は起きない):

   python3 skills/mojiemoji-github/scripts/bump_catalog.py

<img src="https://mojiemoji.jozo.beer/emoji/%E5%87%BA%E5%8A%9B?font=tamanegi&amp;color=22c55e&amp;animation=kage_bokashi&amp;background=transparent&amp;outline=5e22c5&amp;outline_width=2" alt="出力" height="24" align="absmiddle">に「would add N variant(s) ...」が出たら次へ。「no new variants to add」だけならその回はスキップして終わり。

2. <img src="https://mojiemoji.jozo.beer/emoji/%E5%86%85%E5%AE%B9?font=maru-bold&amp;color=a855f7&amp;animation=mochimochi&amp;background=transparent&amp;outline=f7a855&amp;outline_width=2" alt="内容" height="24" align="absmiddle">に<img src="https://mojiemoji.jozo.beer/emoji/%E5%95%8F%E9%A1%8C?font=chikara&amp;color=10b981&amp;animation=kage_kaiten&amp;speed=slow&amp;background=transparent&amp;outline=8110b9&amp;outline_width=2" alt="問題" height="24" align="absmiddle">なければ `--pr` を付けて本実行する:

   python3 skills/mojiemoji-github/scripts/bump_catalog.py --pr

`--pr` <img src="https://mojiemoji.jozo.beer/emoji/%E3%83%A2%E3%83%BC%E3%83%89?font=noto&amp;color=22c55e&amp;animation=kage_neon&amp;background=transparent&amp;outline=5e22c5&amp;outline_width=2" alt="モード" height="24" align="absmiddle">がやること:

• `usage.jsonl` を読む(`$MOJIEMOJI_CACHE_FILE` または

`${XDG_DATA_HOME:-~/.local/share}/mojiemoji-plugin/usage.jsonl`)

• 閾値(デフォルト 2)を満たした variant を diff として抽出
• <img src="https://mojiemoji.jozo.beer/emoji/%E6%97%A2%E5%AD%98?font=maru-bold&amp;color=c084fc&amp;animation=ekken&amp;background=transparent&amp;outline=fcc084&amp;outline_width=2" alt="既存" height="24" align="absmiddle"> variant とまったく<img src="https://mojiemoji.jozo.beer/emoji/%E5%90%8C%E4%B8%80?font=maru&amp;color=fb923c&amp;animation=neruneru&amp;background=transparent&amp;outline=0cea58&amp;outline_width=2" alt="同一" height="24" align="absmiddle">の flavor はスキップ
• `prestamp-catalog.yml` をマージ
• `plugin.json` の patch version を bump
• clean tree <img src="https://mojiemoji.jozo.beer/emoji/%E6%A4%9C%E8%A8%BC?font=gothic&amp;color=22c55e&amp;animation=nami&amp;background=transparent&amp;outline=5e22c5&amp;outline_width=2" alt="検証" h