From takt
references/taktサブモジュール更新時に、takt-*スキル群(takt-task-builder, takt-piece-builder, takt-facet-builder, takt-analyzer, takt-optimizer)を最新のtaktバージョンに追従させるスキル。 TypeScriptスキーマ(schema.ts)、ピースYAML、ファセットMarkdownの差分を検出し、 SKILL.md・参照ドキュメント(task-schema.md等)を体系的に更新する。 トリガー:「taktスキルを更新」「takt-*スキルの鮮度チェック」「taktバージョンアップ対応」 「スキルが古くないか確認」「takt skill updater」
npx claudepluginhub j5ik2o/ai-tools --plugin taktThis skill uses the workspace's default tool permissions.
references/taktサブモジュール更新後に、takt-*スキル群を最新バージョンに追従させる。
references/takt/builtins/ja/INSTRUCTION_STYLE_GUIDE.mdreferences/takt/builtins/ja/KNOWLEDGE_STYLE_GUIDE.mdreferences/takt/builtins/ja/OUTPUT_CONTRACT_STYLE_GUIDE.mdreferences/takt/builtins/ja/PERSONA_STYLE_GUIDE.mdreferences/takt/builtins/ja/POLICY_STYLE_GUIDE.mdreferences/takt/builtins/ja/STYLE_GUIDE.mdreferences/takt/builtins/ja/config.yamlreferences/takt/builtins/ja/facets/instructions/ai-fix.mdreferences/takt/builtins/ja/facets/instructions/ai-review.mdreferences/takt/builtins/ja/facets/instructions/arbitrate.mdreferences/takt/builtins/ja/facets/instructions/architect.mdreferences/takt/builtins/ja/facets/instructions/dual-team-leader-implement.mdreferences/takt/builtins/ja/facets/instructions/fix-supervisor.mdreferences/takt/builtins/ja/facets/instructions/fix.mdreferences/takt/builtins/ja/facets/instructions/gather-review.mdreferences/takt/builtins/ja/facets/instructions/implement-after-tests.mdreferences/takt/builtins/ja/facets/instructions/implement-e2e-test.mdreferences/takt/builtins/ja/facets/instructions/implement-terraform.mdreferences/takt/builtins/ja/facets/instructions/implement-test.mdreferences/takt/builtins/ja/facets/instructions/implement.mdImproves existing pm-skills using feedback, validation reports, or convention changes. Reads files, previews grouped changes, applies on confirmation, suggests version bump.
Updates existing jaan-to skills to comply with standards via git branching, structure analysis, spec validation, documentation sync, and PR creation.
Evolves existing skills by refining content in-place or creating advanced variants. Assesses gaps, applies changes, updates version metadata, syncs registry/cross-references. Use for outdated steps, feedback gaps, complexity upgrades.
Share bugs, ideas, or general feedback.
references/taktサブモジュール更新後に、takt-*スキル群を最新バージョンに追従させる。
前提 takt バージョン: v0.31.0
本スキルでは skills/ で始まるパスを使用する。実際のパスは実行環境に応じて読み替える:
| 環境 | プレフィックス |
|---|---|
| Claude Code | .claude/skills/ |
| Codex CLI | .codex/skills/ |
| 共通(実体) | .agents/skills/ |
| スキル | 実体パス | チェック対象 |
|---|---|---|
| takt-task-builder | skills/takt-task-builder/SKILL.md | TaskRecordスキーマ、ステータス遷移、フィールド一覧 |
| takt-piece-builder | skills/takt-piece-builder/SKILL.md | ビルトインピース一覧、YAML構造、新機能フィールド |
| takt-facet-builder | skills/takt-facet-builder/SKILL.md | ファセット種別、スタイルガイド参照パス |
| takt-analyzer | skills/takt-analyzer/SKILL.md | エンジン仕様参照、ビルトインパス |
| takt-optimizer | skills/takt-optimizer/SKILL.md | ログ形式、最適化パラメータ |
references/taktの現在のバージョンと、各スキルが前提とするバージョンを比較する。
# 現在のサブモジュールバージョン
NEW_VERSION=$(cd references/takt && git describe --tags --abbrev=0)
echo "現在のtaktバージョン: ${NEW_VERSION}"
# 各スキルの前提バージョン(旧バージョンの特定に使う)
grep -r "前提 takt バージョン" skills/takt-*-builder/SKILL.md skills/takt-analyzer/SKILL.md skills/takt-optimizer/SKILL.md
各スキルの前提バージョンから旧バージョン(OLD_VERSION)を特定する。全スキルが同じバージョンであればその値を使う。異なる場合は最も古いバージョンを OLD_VERSION とする。
OLD_VERSION と NEW_VERSION が一致していれば更新不要。差分がある場合は Step 1.5 に進む。
サブモジュール更新後、各スキルの references/takt/ ディレクトリにリファレンスファイルを同期する。
rsync --delete により、サブモジュール側で削除されたファイルもスキル側から自動的に削除される。
# dry-run で確認
scripts/sync-takt-references.sh --dry-run
# 問題なければ実行
scripts/sync-takt-references.sh
各スキルには自身が参照する takt リソースのサブセットのみが同期される。
同期対象の定義は scripts/sync-takt-references.sh 内の各スキルセクションを参照。
旧バージョンと現バージョン間の差分を取得し、どのスキルに影響があるかを判定する。
cd references/takt
# 変更されたファイル一覧
git diff --name-only ${OLD_VERSION}..${NEW_VERSION}
# 変更の統計(追加/削除行数)
git diff --stat ${OLD_VERSION}..${NEW_VERSION}
# 変更履歴(コミットメッセージ)
git log --oneline ${OLD_VERSION}..${NEW_VERSION}
変更されたファイルパスから影響スキルを判定する。該当しないスキルは以降のステップをスキップする。
| 変更ファイルのパスパターン | 影響スキル |
|---|---|
src/infra/task/schema.ts | takt-task-builder |
builtins/**/pieces/*.yaml | takt-piece-builder |
builtins/**/facets/** | takt-facet-builder |
builtins/**/*STYLE_GUIDE*.md | takt-facet-builder |
builtins/skill/references/engine.md | takt-analyzer, takt-piece-builder |
builtins/skill/references/yaml-schema.md | takt-piece-builder |
src/**/log*, src/**/trace* | takt-optimizer |
影響ありと判定されたスキルについて、タグ間差分の詳細を確認し、各スキルへの反映内容を特定する。
cd references/takt
# 影響ファイルの詳細差分を確認(例)
git diff ${OLD_VERSION}..${NEW_VERSION} -- src/infra/task/schema.ts
git diff ${OLD_VERSION}..${NEW_VERSION} -- builtins/ja/pieces/
git diff ${OLD_VERSION}..${NEW_VERSION} -- builtins/ja/facets/
git diff ${OLD_VERSION}..${NEW_VERSION} -- builtins/skill/references/
以下の領域を、影響ありと判定されたもののみチェックする。
差分で src/infra/task/schema.ts の変更を確認し、以下の観点で反映内容を特定する:
| 確認項目 | 参照元 | 更新先 |
|---|---|---|
| ステータス enum 値 | TaskStatusSchema | skills/takt-task-builder/references/task-schema.md |
| TaskExecutionConfig フィールド | TaskExecutionConfigSchema | skills/takt-task-builder/references/task-schema.md |
| TaskRecord フィールド | TaskRecordSchema | skills/takt-task-builder/references/task-schema.md |
| superRefine バリデーション | TaskRecordSchema.superRefine | skills/takt-task-builder/references/task-schema.md ステータス遷移表 |
| TaskFailure 構造 | TaskFailureSchema | skills/takt-task-builder/references/task-schema.md |
差分で builtins/**/pieces/*.yaml の変更を確認し、以下の観点で反映内容を特定する:
| 確認項目 | 更新先 |
|---|---|
| ピース名のリネーム | skills/takt-piece-builder/SKILL.md ビルトインテーブル |
| 新規追加ピース | skills/takt-piece-builder/SKILL.md ビルトインテーブル |
| 削除されたピース | skills/takt-piece-builder/SKILL.md ビルトインテーブル |
| ピースYAML新フィールド | skills/takt-piece-builder/SKILL.md 設計判断ガイド |
差分で builtins/**/facets/** と *STYLE_GUIDE*.md の変更を確認し、以下の観点で反映内容を特定する:
| 確認項目 | 更新先 |
|---|---|
| スタイルガイドの内容変更 | skills/takt-facet-builder/SKILL.md 参照資料テーブル |
| ファセット種別の追加/変更 | skills/takt-facet-builder/SKILL.md ファセット作成規約 |
| 新規ビルトインファセット | skills/takt-facet-builder/SKILL.md 参照例 |
差分で builtins/skill/references/ 配下の変更を確認し、以下の観点で反映内容を特定する:
| 確認項目 | 更新先 |
|---|---|
| ルール評価方式の変更 | skills/takt-analyzer/SKILL.md, skills/takt-piece-builder/SKILL.md |
| 新しいムーブメント種別 | skills/takt-piece-builder/SKILL.md |
| ログフォーマット変更 | skills/takt-optimizer/SKILL.md |
| テンプレート変数の追加 | skills/takt-task-builder/references/task-schema.md |
Step 3 で特定した反映内容をもとに、影響のあるスキルを更新する。
> **前提 takt バージョン**: を NEW_VERSION に更新expert → dual にリネーム」)skills/takt-task-builder/references/task-schema.md 等のリファレンスファイルも同時に更新| ファイル | 更新内容 |
|---|---|
skills/takt-task-builder/SKILL.md | ステータス遷移表、フィールド参照、ピース名例 |
skills/takt-task-builder/references/task-schema.md | フィールド一覧、ステータス遷移図、不変条件テーブル |
skills/takt-piece-builder/SKILL.md | ビルトインテーブル、YAML構造例、設計判断ガイド |
skills/takt-facet-builder/SKILL.md | 参照パス、ファセット作成規約 |
skills/takt-analyzer/SKILL.md | 参照パス、分析基準 |
skills/takt-optimizer/SKILL.md | ログ形式、最適化パラメータ |
対象スキルの更新が完了したら、このスキル自身も更新する:
> **前提 takt バージョン**: を NEW_VERSION に更新更新後の整合性を確認する。
# order.md バリデーション(takt-task-builder)
bash skills/takt-task-builder/scripts/validate-order-md.sh
# ピース・ファセット バリデーション(takt-piece-builder)
bash skills/takt-piece-builder/scripts/validate-takt-files.sh --pieces
前提 takt バージョン が NEW_VERSION に更新されているtask-schema.md のステータス enum が skills/takt-task-builder/references/takt/src/infra/task/schema.ts の TaskStatusSchema と一致task-schema.md のフィールド一覧が TaskRecordSchema と TaskExecutionConfigSchema の全フィールドを網羅task-schema.md の不変条件テーブルが superRefine のバリデーションルールと一致takt-piece-builder/SKILL.md のビルトインテーブルが skills/takt-piece-builder/references/takt/builtins/ja/pieces/ の実態と整合takt-piece-builder/SKILL.md で廃止・リネームされたピース名が残っていないtakt-facet-builder/SKILL.md の参照パスが全て実在するtakt-analyzer/SKILL.md の参照パスが全て実在する前提 takt バージョン と「過去の更新履歴」が更新されている更新内容をコミットする。
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
- takt-task-builder: {変更サマリ}
- takt-piece-builder: {変更サマリ}
- Update references/takt submodule to v{バージョン}
今後の更新時に参照できるよう、主要な変更をここに記録する。
| スキル | 変更内容 |
|---|---|
| 全スキル | 前提 takt バージョン: v0.31.0 に更新 |
| takt-task-builder | pr_failed ステータス(6番目の終端状態)の遷移テーブルに追加 |
| takt-piece-builder | ビルトインテーブルを現行ピース一覧に刷新(expert/default-mini/review-only → dual/backend/frontend/review/takt-default 等)。allowed_tools → provider_options.claude.allowed_tools 移行例を追加。Loop monitor の instruction をビルトインファセット参照へ統一。takt-default-team-leader 廃止(takt-default に統合) |
| takt-facet-builder | ビルトイン一覧を大幅拡充(Instruction: dual-team-leader-implement, loop-monitor-reviewers-fix, team-leader-implement 等追加。Knowledge: task-decomposition 追加。Persona: supervisor, dual-supervisor 等追加。Output Contract: 各レビュー系追加)。レビュー出力契約に family_tag/reopened セクション構造追加 |
| takt-analyzer | provider_options 構造チェック項目追加。*-provider-events.jsonl(別ファイル)と trace.md のログ記述追加。observability → logging リネーム反映 |
| takt-optimizer | instruction 参照正規化・allowed_tools の provider_options 移行の最適化項目追加 |
| スキル | 変更内容 |
|---|---|
| 全スキル | 前提 takt バージョン: v0.30.0 に更新 |
| takt-task-builder | pr_failed ステータス(6番目の終端状態)追加。PR作成失敗を failed と分離。failure は任意(failed と異なり必須ではない) |
| takt-piece-builder | allowed_tools → provider_options.claude.allowed_tools に移動。Loop monitor の instruction をビルトインファセット参照(loop-monitor-ai-fix, loop-monitor-reviewers-fix)へ統一。設計判断ガイドに provider_options 追加 |
| takt-facet-builder | ビルトイン Instruction に loop-monitor-ai-fix, loop-monitor-reviewers-fix 追加。レビュー出力契約に family_tag/new/persists/resolved/reopened セクション構造追加 |
| takt-analyzer | provider_options 構造チェック項目追加。*-provider-events.jsonl(別ファイル)と trace.md のログ記述追加。observability → logging リネーム反映 |
| takt-optimizer | instruction 参照正規化の最適化項目追加 |
| スキル | 変更内容 |
|---|---|
| 全スキル | 前提 takt バージョン: v0.29.0 を追加 |
| takt-task-builder | exceeded ステータス(5番目の終端状態)追加。base_branch, exceeded_max_movements, exceeded_current_iteration フィールド追加 |
| takt-piece-builder | expert → dual リネーム(v0.28.1)。default-mini 廃止。review-fix 系・backend/frontend 系ピース追加。quality_gates フィールド追加 |
| takt-facet-builder | 変更なし |
| takt-analyzer | 変更なし |
| takt-optimizer | provider-events.jsonl 追加(minor) |