---

name: template-sync description: "テンプレート同期スキル。yellow-seed/template の更新を他のリポジトリに反映。Use when: テンプレート更新の反映、template同期、既存リポジトリへの変更適用を依頼された時。"

テンプレート同期

yellow-seed/template の更新内容を、このテンプレートを基に作成された他のリポジトリに反映するためのスキルです。

背景

• yellow-seed/template はテンプレート用途で、新しいリポジトリ作成時のベースとして使用される
• yellow-seed/template を更新した際、これを基にした既存リポジトリにも変更を追随させたい
• 多くのリポジトリが yellow-seed/template をベースにしているため、効率的な同期メカニズムが必要

同期原則

1. 非破壊的: 参照先リポジトリの既存設定を尊重
2. 選択的適用: 必要な変更のみを適用
3. カスタマイズ保持: プロジェクト固有のカスタマイズを保護
4. 透明性: 適用される変更を明確に説明
5. 安全性: 適用前に確認プロセスを提供

同期可能な要素

重要: .github/ 配下は将来的に新しいディレクトリやファイルが追加される可能性があります（例: .github/skills/, .github/configs/ など）。これらは全て自動的に同期対象となり、yellow-seed/template から他のリポジトリへ反映されます。

同期手順

1. yellow-seed/template の情報確認

Copy# yellow-seed/template のURL（デフォルト）
TEMPLATE_REPO="https://github.com/yellow-seed/template.git"

# yellow-seed/template の最新情報を取得
git ls-remote --heads $TEMPLATE_REPO

2. 現在のリポジトリ設定を分析

分析項目:

• プログラミング言語とフレームワーク
• 既存のCI/CD設定
• プロジェクト構造
• カスタマイズされた設定ファイル
• 既存のskillsとhooks

分析方法:

Copy# 言語検出
ls package.json pyproject.toml Cargo.toml go.mod Gemfile pom.xml build.gradle 2>/dev/null

# 既存のskills確認
ls -la .claude/skills/ 2>/dev/null

# 既存の.github/設定確認（全体）
ls -la .github/ 2>/dev/null
find .github/ -type f 2>/dev/null

# 既存のドキュメント確認
ls AGENTS.md CLAUDE.md README.md 2>/dev/null

3. yellow-seed/template との差分を検出

Copy# yellow-seed/template をリモートとして追加（一時的）
git remote add template $TEMPLATE_REPO 2>/dev/null || true
git fetch template main

# 差分を確認
git diff HEAD template/main --name-only

# 特定ディレクトリの差分を詳細確認
git diff HEAD template/main -- .claude/skills/
git diff HEAD template/main -- .github/
git diff HEAD template/main -- AGENTS.md

4. 適用すべき変更を選択

自動適用可能な変更:

• .claude/skills/内の新規skillファイル
• .github/配下の全ての新規ファイル・ディレクトリ
  • .github/workflows/内の新規ワークフローファイル
  • .github/ISSUE_TEMPLATE/内の新規テンプレート
  • .github/skills/, .github/configs/等、将来追加される新規ディレクトリ

確認が必要な変更:

• 既存ファイルの更新
• 設定ファイルの変更（.gitignore, .editorconfig等）
• ドキュメントファイルの更新（AGENTS.md, CLAUDE.md）

適用しない変更:

• プロジェクト固有のファイル（README.mdのプロジェクト名等）
• カスタマイズされた設定
• プロジェクト固有のworkflows

5. 変更内容の微調整

5.1 言語・フレームワーク固有の調整

Copy# 例: Node.jsプロジェクトの場合
if [ -f "package.json" ]; then
  # Node.js関連のworkflowsのみ適用
  # Python関連のworkflowsはスキップ
fi

5.2 既存設定との統合

戦略:

• 新規ファイル: そのまま追加
• 既存ファイルの新規セクション: セクション単位で追加
• 既存ファイルの更新: ユーザーに確認を求める

6. 変更を適用

Copy# yellow-seed/template の .github/workflows/new-workflow.yml を追加
git show template/main:.github/workflows/new-workflow.yml > .github/workflows/new-workflow.yml

# yellow-seed/template の .github/skills/ を追加する例
mkdir -p .github/skills
git archive --remote=$TEMPLATE_REPO HEAD:.github/skills/ | tar -x -C .github/skills/

# yellow-seed/template の .claude/skills/new-skill/SKILL.md を追加
git show template/main:.claude/skills/new-skill/SKILL.md > .claude/skills/new-skill/SKILL.md

7. 適用結果の確認

Copy# 変更内容を確認
git status
git diff

# 変更をコミット
git add .
git commit -m "chore: sync updates from yellow-seed/template

Applied changes:
- Added new skill: xxx
- Added new workflow: yyy
- Updated AGENTS.md with new sections

Source: yellow-seed/template@<commit-hash>"

8. クリーンアップ

Copy# 一時的に追加したリモートを削除
git remote remove template

同期時のチェックリスト

• yellow-seed/template の最新情報を取得した
• 現在のリポジトリの設定を分析した
• 差分を確認し、適用すべき変更を選択した
• プロジェクト固有の設定を保持する戦略を確認した
• 新規ファイルの追加を実行した
• 既存ファイルの更新（必要な場合）をユーザーと確認した
• 変更内容をコミットした
• 一時的なリモートをクリーンアップした
• 適用後の動作確認を行った

注意事項

1. バックアップの推奨: 同期前にブランチを作成することを推奨

   Copygit checkout -b sync-from-template
   

2. 段階的な適用: 一度に全ての変更を適用せず、段階的に適用することを推奨

3. テストの実施: 適用後、必ずCI/CDやローカルテストを実施

4. ドキュメントの確認: READMEやAGENTS.mdの内容がプロジェクトに適合しているか確認

5. カスタマイズの尊重: プロジェクト固有のカスタマイズは常に尊重

yellow-seed/template 情報

• リポジトリ: yellow-seed/template
• ブランチ: main
• URL: https://github.com/yellow-seed/template.git

別のテンプレートを使用する場合は、以下のように指定：

CopyTEMPLATE_REPO="https://github.com/your-org/your-template.git"