claude-harness-refs-updatelisted
Install: claude install-skill ystk-kai/claude-harness
# claude-harness-refs-update: 参照資料の鮮度チェックと更新
claude-harness の参照資料は 2 層 — 蒸留版 (`skills/*/references/*.md`。`harness-design` と `ui-design` が持つ) と原典 clone (`~/.claude/references/<repo>/`)。このスキルは鮮度チェックから再蒸留までを 1 コマンドで回す。参照資料の更新機構はこのスキルが一元所��する: `scripts/check-freshness.sh` が検出、[DISTILLING.md](DISTILLING.md) が更新レシピと再蒸留プロンプト雛形、`scripts/frontmatter.sh` が `install.sh` と共用のパーサ。参照スキル側 (`harness-design` / `ui-design`) は蒸留版を持つだけで、判定も規約も持たない。更新の入口はこのスキルだけ (スラッシュコマンドを増やさない)。
引数: repo 名 (例 `12-factor-agents`) を渡すとその repo だけを対象にする。`--check` で鮮度チェックのみ (更新に進まない)。無引数なら全 repo を対象に更新まで進む。
## Process (run in order)
0. **前提を解決する。**
- 当日日付を控える: `date +%F`。`distilled_at` に使う。**サブエージェントは当日日付を���らないので、後で必ずプロンプトに埋める。**
- このスキルの実体パスを解決する: `SELF="$(readlink -f "${CLAUDE_CONFIG_DIR:-$HOME/.claude}/skills/claude-harness-refs-update")"`。以降 `$SELF/scripts/check-freshness.sh` / `$SELF/DISTILLING.md` を使う (skills/ は symlink なので実体パスを取るため `readlink -f`)。
- claude-harness リポジトリのルートを解決する: `ROOT="$(dirname "$(dirname "$SELF")")"`。蒸留版は `harness-design` と `ui-design` の各スキル配下にあるので、出力先は `$ROOT/skills/<skill>/references/<repo>.md` に���る (どのスキルかは手順1�� STALE 行に併記される)。
- 原典ルート: `REFS="${CLAUDE_CONFIG_DIR:-$HOME/.claude}/references"`。clone は `$REFS/<repo>`。
1. **鮮度チェック** — `bash "$SELF/scripts/check-freshness.sh"` を実行 (fetch あり = 最新 upstream を反映)。行頭タグ `OK` / `BEHIND` / `STALE` / `MISS` / `ERR` / `SKIP` / `NOTE` を読む。引数に repo 名があれば、その repo の行だけを対象にする (スクリプトに絞り込み機能はないので出力からフィルタ)。引数が `--check` なら結果を提示してここで終了。全 `OK