القائمة
herdr のバージョンが上がったときに、herdr プラグインの SKILL.md を現在インストールされている herdr の CLI 仕様に追従させる。「herdr スキルを更新して」「herdr のバージョンが上がったからスキルを直して」といった指示で発動する。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | update-herdr-skill |
| description | herdr のバージョンが上がったときに、herdr プラグインの SKILL.md を現在インストールされている herdr の CLI 仕様に追従させる。「herdr スキルを更新して」「herdr のバージョンが上がったからスキルを直して」といった指示で発動する。 |
herdr プラグインの SKILL.md を、現在インストールされている herdr の CLI 仕様に合わせて更新する。対象は herdr 本体の自作スキルであり、herdr 本体のアップデート自体はこのスキルの範囲外 (herdr update 等でユーザーが別途行う)。
herdr --version で確認できる)。git log --oneline -- packages/claude-plugins/plugins/herdr/skills/herdr/SKILL.md
直近のコミットメッセージから、前回同期した herdr バージョンを拾う (コミット規約は手順6を参照)。見つからない・読み取れない場合はユーザーに確認する。
前回バージョンから現在バージョンまでの 公式 CHANGELOG を取得し、CLI サブコマンド・フラグ・挙動に関わりそうな Added/Changed/Fixed エントリを洗い出す。
ここで拾った内容は「疑わしい変更点の候補」に過ぎない。CHANGELOG の文言をそのまま SKILL.md に書き写さない — 手順4で実機検証してから書く。
新しいトップレベルコマンドツリー (herdr <noun> ...) は herdr --help の usage 一覧に載らないことがある (例: plugin, terminal は追加時点で usage に出てこなかった)。CHANGELOG 内の herdr <word> パターンを grep するなどして見落としを防ぐ。
判明している全サブコマンドツリーに対して --help を取得する:
for cmd in "" status update config channel workspace worktree tab notification agent pane wait session integration api completion server plugin terminal; do
echo "===== herdr $cmd --help ====="
herdr $cmd --help
done
手順2で見つけた「usage に出てこない新規ツリー」があれば、上記のコマンドリストに追加してから実行する。
--help はサブコマンドの構文しか教えてくれない。公式 CLI リファレンスの環境変数一覧 (HERDR_PANE_ID 等) のように、--help に出てこないが CLI 経由の操作に関わる情報源もあるので、変更が疑われる場合はそちらも確認する。
SKILL.md を通読し、手順3の --help 出力と食い違う箇所 (存在しなくなったコマンド・フラグ、新規コマンド・フラグ、レスポンス形状の変化) を洗い出す。
--help はコマンドの構文までしか教えてくれない。挙動の解釈が絡む記述 (id が再利用されるか、プロセスが exit したときに pane がどうなるか、target 解決の優先順位、等) を新しく書く・書き換える場合は、CHANGELOG や --help の記述を鵜呑みにせず、安全な範囲で実際に再現してから書く。
検証の進め方の実例:
split / tab create / workspace create)close して片付ける (テスト用の痕跡を残さない)検証していないことを検証済みであるかのように書かない。書けるのは実際に確認できた範囲だけ。
安全に再現できない (ユーザーの画面上の UI フォーカスを動かす、既存の workspace/pane に影響しうる、その他副作用が読み切れない、等) 挙動に当たったら、次のどちらも避ける:
代わりに、何を・どう再現すれば確認できるか (具体的なコマンド列と、想定される副作用) をユーザーに提示し、実施してよいか確認を待つ。承認が得られたら実際に実行し、確認できた結果を SKILL.md にヘッジなしで反映する (副作用があった場合は元の状態に戻す)。「検証しようとしたがリスクを理由にやめた」状態の記述は、書く価値がほとんど無い — 結局あとから「じゃあやって」と言われるだけなので、その手前で確認を挟む。
手順4・5で判明した差分を反映する。書き方は以下のハウススタイルに従う:
atuin プラグインの recall-commands スキルと同じ形式)NEW_PANE=$(herdr pane split ... | python3 -c '...') で受け取ってから使う。前の手順で作っていない pane id を勘で埋めない)packages/claude-plugins/plugins/herdr/ 配下だけが変更対象であること (marketplace.json や設定ファイルへの追加登録は初回のみ必要な作業で、通常の更新では不要) を確認しつつ、変更内容をユーザーに提示する。想定外の追加判断が必要になった場合 (例: プラグイン構成そのものを変える必要が出てきた等) は、その場で立ち止まってユーザーに確認する。
ユーザーの確認が取れたら、次回の手順1で拾えるように、コミットメッセージに同期先バージョンを明記する:
docs(herdr): sync skill with vX.Y.Z
X.Y.Z は手順1〜3で確認した「今回同期した herdr バージョン」。
ハンドオーバー文書を読んで作業を引き継ぐ。
ctx (https://ctx.rs/) を使ってコーディングエージェントのトランスクリプトを検索・参照するときに使う。「過去のセッションを調べて」「前にやった作業を確認して」「Claude Code セッションID xxx の内容を教えて」「あのときの経緯を教えて」と依頼されたときに必ず使う。
herdr（ターミナルマルチプレクサ、https://herdr.dev/）の中で動いているときに、workspace・tab・pane・agent をソケット API 経由で操作する。他 pane の出力を読む、コマンドを実行する、出力やエージェント状態の変化を待つ、新しいエージェントを起動する、pane のレイアウトを操作する、git worktree を作る、といった操作をするときに使う。HERDR_ENV=1 で動いているときのみ有効。
OPINIONS.local.md を入力に、全マシン共通の要約版 (dotfiles 版) を蒸留する。
ワークスペース内における過去の Claude Code 対話ログ (ctx が索引した全 primary セッション) から、ユーザーの durable な意見・信念・判断基準を蒸留して OPINIONS.local.md を生成する。
コミット依頼があったら必ず使うスキル。「コミットして」「commit」「変更をコミット」「ここまでの作業をコミット」等の指示を受けたら、このスキルを呼び出してコミットを実行する。直接 git commit を実行せずこのスキルを経由すること。