菜单
herdr の機能ギャップ一覧(private gist)を棚卸しする。上流 ogulcancelik/herdr の実装状況を照会し、解決済み項目を Resolved へ移動して gist を更新する。引数 `add <text>` で新しいギャップを追記。herdr の足りない機能・不満点の管理はすべてこの skill 経由で行う。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | herdr-gaps |
| description | herdr の機能ギャップ一覧(private gist)を棚卸しする。上流 ogulcancelik/herdr の実装状況を照会し、解決済み項目を Resolved へ移動して gist を更新する。引数 `add <text>` で新しいギャップを追記。herdr の足りない機能・不満点の管理はすべてこの skill 経由で行う。 |
herdr に足りてない機能の一覧を管理する。データは private gist(write-many メモ)、この skill は棚卸しロジックのみ。
cd60ae40193d7340ca534812a3565162(https://gist.github.com/ShotaKitazawa/cd60ae40193d7340ca534812a3565162 、ファイル名 herdr-gaps.md)## 検査状況(検査済みバージョン)/ ## Gaps / ## Resolved / ## 検査履歴。運用ルールの説明は gist に書かず、この skill に集約するgh gist edit で直接追記することがあるGH_HOST=github.com を明示する(GHES がデフォルトの端末でも gist / 上流照会が github.com に向くように)gist には ## 検査状況(どのバージョンのリリース内容まで一覧に反映済みか)と ## 検査履歴 があり、この skill が維持する。検査済みバージョンより新しいリリースが上流にないときは項目ごとの照会をスキップする(余計な検索をしないため)。
GH_HOST=github.com gh api gists/cd60ae40193d7340ca534812a3565162 --jq '.files["herdr-gaps.md"].content'
## 検査状況 の検査済みバージョンと上流の最新リリースを比較する:
GH_HOST=github.com gh release list --repo ogulcancelik/herdr --limit 1
herdr status とだけ突き合わせて報告して終了(ローカルが検査済みバージョンより古ければ更新で直る項目に言及)。force 引数付きで呼ばれた場合のみスキップせず全照会する## Gaps の各項目について上流の状態を照会する:
GH_HOST=github.com gh api graphql -f query='query { repository(owner: "ogulcancelik", name: "herdr") { discussion(number: N) { closed stateReason comments(first: 10) { nodes { body } } } } }'
GH_HOST=github.com gh issue view N --repo ogulcancelik/herdr --comments
<!-- herdr:released:vX.Y.Z --> = そのバージョンでリリース済み、<!-- herdr:pending-release --> = master 実装済み・未リリースherdr status(client と server 両方。server が古いままなら live-handoff 未実施の可能性に言及)
- [x] にして ## Resolved セクションへ移動gh gist edit はエディタが開くので使わない。API で非対話更新):
## 検査状況 の検査済みバージョンを照会した最新リリースに書き換え、## 検査履歴 に 1 行追記する(日付、検査したバージョン、移動・変化した項目の要約)。項目に変化がなくてもこの 2 箇所は更新する(次回のスキップ判定のため)jq -n --rawfile c <更新後ファイル> '{files: {"herdr-gaps.md": {content: $c}}}' \
| GH_HOST=github.com gh api -X PATCH gists/cd60ae40193d7340ca534812a3565162 --input - > /dev/null
add <text>)## Gaps の末尾に - [ ] <text> を追記して手順 5 と同じ方法で PATCH する(検査状況・検査履歴は変更しない)。上流に対応する discussion/issue が既にないか軽く検索し(GH_HOST=github.com gh search issues --repo ogulcancelik/herdr ... と GraphQL の DISCUSSION search)、見つかればリンクを添える。
トリガー: 棚卸し(引数なし手順)を実施した直後の会話で、ユーザーが「では更新して」「アップデートして」のように更新を指示したら、確認を挟まず本節の手順 1〜4 を通しで実行する(「実装済み・要更新」の報告がなくても、単に手元の herdr を最新化したいだけの場合も含めてこの手順で良い)。バイナリは aqua 管理。herdr update / herdr update --handoff は herdr 自前の配布チャネルからバイナリを入れて aqua と二重管理になるため使わない:
chezmoi source-path で場所を確認する。パスは端末ごとに異なりうるので決め打ちしない)の aqua.yaml にある ogulcancelik/herdr@vX.Y.Z をバンプする。この時点ではまだ chezmoi のソースを変えただけで $HOME 側には反映されないchezmoi apply を実行する。dotfiles の aqua.yaml は chezmoi 管理下にあり、実体は chezmoi target-path aqua.yaml で確認できる場所($HOME 配下)。dotfiles 側を直接編集しただけでは反映されないため、この一手を飛ばさない
chezmoi apply は aqua 関連の後続フック(cd $HOME && aqua i && aqua vacuum 相当)を実行し、その中で新バージョンのバイナリが aqua のパッケージキャッシュに取得される(PATH 上の client も新バージョンになるが、稼働中 server は旧のまま)。go-delve/delve など herdr と無関係なパッケージがアセット欠落で失敗してフック全体がエラー終了することがあるが、herdr 自体のダウンロードが成功していれば無視してよい(ログで package_name=ogulcancelik/herdr の行にエラーが出ていないか確認する)--import-exe の指定が必須:
# 実体パスは `aqua root-dir` を起点に解決する(環境によって root-dir・OS/arch・ファイル名が変わるため決め打ちしない)
IMPORT_EXE=$(find "$(aqua root-dir)/pkgs/github_release/github.com/ogulcancelik/herdr/vX.Y.Z" -type f | head -1)
herdr server live-handoff \
--import-exe "$IMPORT_EXE" \
--expected-version X.Y.Z
--import-exe を省略すると、旧サーバが自分自身の実体パス(aqua の pkgs 配下はバージョン固定パス)を再 exec するため、handoff は成功表示でも旧バージョンのまま立ち上がり直る(0.7.3→0.7.4 更新時に実際に踏んだ)herdr status で client / server の両方が新バージョンになり restart_needed: no であることを確認するGH_HOST=github.com gh release view vX.Y.Z --repo ogulcancelik/herdr)は補助