J5ik2o Takt Skill Updater

TAKT Skill Updater

nrslib/takt の新しいリリースタグに合わせて、takt-*スキル群を最新バージョンに追従させる。

前提 takt バージョン: v0.47.0

パス表記について

本スキルでは skills/ で始まるパスを使用する。実際のパスは実行環境に応じて読み替える：

takt の source of truth は環境変数 TAKT_SRC が指す nrslib/takt のチェックアウトとする。git submodule や特定リポジトリのレイアウトには依存せず、Step 0 の手順で nrslib/takt を直接 clone して使う。

対象スキル

ワークフロー

Step 0: takt ソースの取得

nrslib/takt のチェックアウトを用意し、TAKT_SRC に設定する。手元に既存のチェックアウトがあればそれを TAKT_SRC に指定してもよい。 更新先バージョンが指定されている場合（CI から呼ばれる場合等）は NEW_VERSION にそのタグを設定する。目的のタグを checkout 済みの TAKT_SRC が与えられている場合、この Step は省略してよい。

TAKT_SRC="${TAKT_SRC:-/tmp/takt}"
if [[ ! -d "$TAKT_SRC" ]]; then
  git clone https://github.com/nrslib/takt.git "$TAKT_SRC"
fi
git -C "$TAKT_SRC" fetch --tags
# NEW_VERSION 指定時はそのタグを、未指定時は最新の安定版タグを checkout する
git -C "$TAKT_SRC" checkout \
  "${NEW_VERSION:-$(git -C "$TAKT_SRC" tag --list 'v*' --sort=-v:refname | grep -E '^v[0-9]+\.[0-9]+\.[0-9]+$' | head -1)}"

Step 1: takt バージョン確認

takt チェックアウト（TAKT_SRC）のバージョンと、各スキルが前提とするバージョンを比較する。

# 更新先の takt バージョン（TAKT_SRC のチェックアウトから取得）
NEW_VERSION=$(git -C "$TAKT_SRC" describe --tags --abbrev=0)
echo "更新先のtaktバージョン: ${NEW_VERSION}"

# 各スキルの前提バージョン（旧バージョンの特定に使う）
grep -r "前提 takt バージョン" skills/j5ik2o-takt-*-builder/SKILL.md skills/j5ik2o-takt-analyzer/SKILL.md skills/j5ik2o-takt-optimizer/SKILL.md

各スキルの前提バージョンから旧バージョン（OLD_VERSION）を特定する。全スキルが同じバージョンであればその値を使う。異なる場合は最も古いバージョンを OLD_VERSION とする。

OLD_VERSION と NEW_VERSION が一致していれば更新不要。差分がある場合は Step 1.5 に進む。

Step 1.5: リファレンスファイルの同期

TAKT_SRC のチェックアウトから、各スキルの references/takt/ ディレクトリにリファレンスファイルを同期する。 rsync --delete により、takt 側で削除されたファイルもスキル側から自動的に削除される。

# sync スクリプトがある場合（TAKT_SRC で更新元を指定する）
TAKT_SRC="$TAKT_SRC" scripts/sync-takt-references.sh --dry-run
TAKT_SRC="$TAKT_SRC" scripts/sync-takt-references.sh

sync スクリプトが存在しない repo では、各スキルが参照するサブセットを rsync -a --delete で個別同期する。builtins/, docs/, builtins/skill/references/, src/infra/task/, src/core/logging/, src/core/workflow/ など、当該スキルが実際に読む範囲だけを同期対象にする。

各スキルには自身が参照する takt リソースのサブセットのみが同期される。 同期対象の定義は scripts/sync-takt-references.sh 内の各スキルセクションを参照。

同期内容の品質チェック（誤読防止）

「本家がそう書いてあったから」での盲目的コピーはしない。同期で追加・変更されたドキュメントを読み、 誤読を招く記述（設定例の誤り、正式リファレンスと矛盾する説明、ネスト構造が曖昧な設定キー表記等）がないか、 正とする情報源（docs/configuration.md、スキーマ定義、実装コード）と突き合わせて確認する。

検出した場合の対応:

1. スナップショット側を修正し、「ローカル修正の記録」（本ファイル末尾）に追記する
2. 既存の記録エントリは毎回の同期後に必ず確認する。上流で修正済みなら記録から削除し、未修正なら同じ修正を再適用する（rsync --delete で上書きされて消えているため）
3. 上流（nrslib/takt）への issue / PR での報告を検討する（報告が修正の恒久化につながる）

Step 2: タグ間差分の取得

旧バージョンと現バージョン間の差分を取得し、どのスキルに影響があるかを判定する。

cd "$TAKT_SRC"

# 変更されたファイル一覧
git diff --name-only ${OLD_VERSION}..${NEW_VERSION}

# 変更の統計（追加/削除行数）
git diff --stat ${OLD_VERSION}..${NEW_VERSION}

# 変更履歴（コミットメッセージ）
git log --oneline ${OLD_VERSION}..${NEW_VERSION}

影響スキルの判定

変更されたファイルパスから影響スキルを判定する。該当しないスキルは以降のステップをスキップする。

Step 3: 影響スキルの詳細チェック

影響ありと判定されたスキルについて、タグ間差分の詳細を確認し、各スキルへの反映内容を特定する。

cd "$TAKT_SRC"

# 影響ファイルの詳細差分を確認（例）
git diff ${OLD_VERSION}..${NEW_VERSION} -- src/infra/task/taskRecordSchemas.ts src/infra/task/taskExecutionSchemas.ts
git diff ${OLD_VERSION}..${NEW_VERSION} -- builtins/ja/workflows/
git diff ${OLD_VERSION}..${NEW_VERSION} -- builtins/ja/facets/
git diff ${OLD_VERSION}..${NEW_VERSION} -- builtins/skill/references/

以下の領域を、影響ありと判定されたもののみチェックする。

a) TaskRecord スキーマ差分（→ j5ik2o-takt-task-builder）

差分で src/infra/task/taskRecordSchemas.ts と src/infra/task/taskExecutionSchemas.ts の変更を確認し、以下の観点で反映内容を特定する：

b) ビルトインワークフロー差分（→ j5ik2o-takt-workflow-builder）

差分で builtins/**/workflows/*.yaml（旧 builtins/**/pieces/*.yaml）の変更を確認し、以下の観点で反映内容を特定する：

c) ファセット構造差分（→ j5ik2o-takt-facet-builder）

差分で builtins/**/facets/** と *STYLE_GUIDE*.md の変更を確認し、以下の観点で反映内容を特定する：

d) エンジン仕様差分（→ j5ik2o-takt-analyzer, j5ik2o-takt-optimizer）

差分で builtins/skill/references/ 配下の変更を確認し、以下の観点で反映内容を特定する：

Step 4: スキル更新の実施

Step 3 で特定した反映内容をもとに、影響のあるスキルを更新する。

更新ルール

1. バージョン表記: 各 SKILL.md の > **前提 takt バージョン**: を NEW_VERSION に更新
2. フィールド追加: 新フィールドは既存テーブルの末尾に追加（順序を保持）
3. リネーム: 旧名→新名の注意書きを添える（例: 「v0.28.1 で expert → dual にリネーム」）
4. 削除: テーブルから削除し、注意書きで言及
5. 参照ドキュメント: skills/j5ik2o-takt-task-builder/references/task-schema.md 等のリファレンスファイルも同時に更新

更新対象ファイル一覧

j5ik2o-takt-skill-updater 自身の更新

対象スキルの更新が完了したら、このスキル自身も更新する：

1. 冒頭の > **前提 takt バージョン**: を NEW_VERSION に更新
2. 末尾の「過去の更新履歴」セクションに今回の変更内容を追記

Step 5: バリデーション

更新後の整合性を確認する。

自動検証

# order.md バリデーション（j5ik2o-takt-task-builder）
bash skills/j5ik2o-takt-task-builder/scripts/validate-order-md.sh

# ワークフロー・ファセット バリデーション（j5ik2o-takt-workflow-builder）
bash skills/j5ik2o-takt-workflow-builder/scripts/validate-takt-files.sh --workflows

手動検証チェックリスト

• 全 SKILL.md の 前提 takt バージョン が NEW_VERSION に更新されている
• task-schema.md のステータス enum が skills/j5ik2o-takt-task-builder/references/takt/src/infra/task/taskRecordSchemas.ts の TaskStatusSchema と一致
• task-schema.md のフィールド一覧が TaskRecordSchema と TaskExecutionConfigSchema の全フィールドを網羅
• task-schema.md の不変条件テーブルが superRefine のバリデーションルールと一致
• j5ik2o-takt-workflow-builder/SKILL.md のビルトインテーブルが skills/j5ik2o-takt-workflow-builder/references/takt/builtins/ja/workflows/ の実態と整合
• j5ik2o-takt-workflow-builder/SKILL.md で廃止・リネームされたワークフロー名が残っていない
• j5ik2o-takt-facet-builder/SKILL.md の参照パスが全て実在する
• j5ik2o-takt-analyzer/SKILL.md の参照パスが全て実在する
• j5ik2o-takt-skill-updater 自身の 前提 takt バージョン と「過去の更新履歴」が更新されている
• 「ローカル修正の記録」の全エントリが、同期後のスナップショットに再適用されている（または上流修正を確認して記録から削除されている）

Step 6: コミットとPR

更新内容をコミットする。

ブランチ命名規約

chore/update-takt-skills-for-v{バージョン}

例: chore/update-takt-skills-for-v031

コミットメッセージテンプレート

chore: update takt-* skills for takt v{バージョン}

- Add "前提 takt バージョン: v{バージョン}" to all takt-* skills
- j5ik2o-takt-task-builder: {変更サマリ}
- j5ik2o-takt-workflow-builder: {変更サマリ}
- Sync takt reference snapshots to v{バージョン}

ローカル修正の記録

上流ドキュメントの誤読を招く記述に対する、スナップショットへのローカル修正。 同期（rsync --delete）のたびに失われるため、Step 1.5 の品質チェックで毎回再適用する。 上流で修正がリリースされたら該当行を削除する。

過去の更新履歴

今後の更新時に参照できるよう、主要な変更をここに記録する。

v0.46.0 → v0.47.0（2026-06-18）

v0.45.0 → v0.46.0（2026-06-17）

v0.44.0 → v0.45.0（2026-06-11）

v0.43.0 → v0.44.0（2026-06-10）

v0.42.0 → v0.43.0（2026-06-02）

v0.36.0 → v0.42.0（2026-05-21）

v0.35.4 → v0.36.0（2026-04-16）

v0.31.0 → v0.35.4（2026-04-13）

v0.29.0 → v0.31.0（2026-03-09）

v0.29.0 → v0.30.0（2026-03-06、未適用 → v0.31.0 に統合）

v0.22.0 → v0.29.0（2026-03-04）