| name | update-from-upstream |
| description | テンプレートリポジトリ（YukiWorks432/extendscript-ts-template）に更新があった場合に、自分のスクリプトを消さずに安全に取り込む。Use when: テンプレートの更新を取り込みたい、アップデートを確認したい、ポリフィルやビルドツールを最新化したい、upstream の変更を反映したい |
| argument-hint | 確認のみ / 自動更新 / 特定ファイルのみ など、用途を指定できます |
テンプレートのアップデートを取り込む
テンプレートリポジトリ (YukiWorks432/extendscript-ts-template) の最新の変更を、
ユーザー自身のスクリプトを上書きせずに安全に取り込む。
When to Use
- 「テンプレートのアップデートを取り込みたい」
- 「ポリフィルやビルドスクリプトが古くなっていそう」
- 「元のリポジトリで何が変わったか確認したい」
更新対象ファイルの分類
✅ 自動的に更新するファイル（テンプレート管理のインフラ）
| パス | 説明 |
|---|
scripts/ | ビルドツール・スクリプト生成ツール |
src/lib/ | 共通ポリフィル |
src/init.ts | 初期化コード |
src/tests/ | テストインフラ |
src/types/ | グローバル型定義 |
src/aeft/lib/, src/aeft/types/ | After Effects 共通ライブラリ・型 |
src/ilst/lib/, src/ilst/types/ | Illustrator 共通ライブラリ・型 |
src/phxs/lib/, src/phxs/types/ | Photoshop 共通ライブラリ・型 |
rollup.config.mjs | バンドル設定 |
tsconfig.json | TypeScript 設定 |
eslint.config.mjs | Lint 設定 |
package.json | パッケージ情報・依存関係 |
.prettierrc, .prettierignore | フォーマット設定 |
pnpm-workspace.yaml | ワークスペース設定 |
AGENTS.md | エージェント共通の入口 |
.agents/instructions/ | Codex 向け追加指示 |
.agents/skills/add-script/ | add-script スキル |
.agents/skills/debug-script/ | debug-script スキル |
.agents/skills/es-to-ts/ | es-to-ts スキル |
.agents/skills/update-from-upstream/ | update-from-upstream スキル |
docs/ | ドキュメント |
❌ 自動更新しないファイル（ユーザーが管理するもの）
| パス | 説明 |
|---|
src/aeft/<スクリプト名>/ | ユーザーの After Effects スクリプト |
src/ilst/<スクリプト名>/ | ユーザーの Illustrator スクリプト |
src/phxs/<スクリプト名>/ | ユーザーの Photoshop スクリプト |
es.config.mjs | スクリプトのビルド設定（ユーザーが追加したエントリを保持） |
README.md | ユーザーが書き換えた可能性がある |
LICENSE | ユーザーが書き換えた可能性がある |
Procedure
1. upstream リモートを確認・設定する
git remote -v
出力に upstream が含まれない場合は追加する:
git remote add upstream https://github.com/YukiWorks432/extendscript-ts-template.git
注意: すでに upstream が設定されている場合はスキップする。
2. 最新の情報を取得する
git fetch upstream
3. 差分を確認・ユーザーに報告する
コミット差分を確認する:
git log HEAD..upstream/main --oneline
変更ファイル一覧を確認する:
git diff --name-status HEAD..upstream/main
取得した差分情報をもとに、以下を日本語でユーザーに報告する:
- 新しい機能・変更点の要約（コミットメッセージを元に）
- 自動更新対象のファイル一覧
es.config.mjs が変更されている場合は、手動マージが必要な旨を明記する- 差分がない場合は「最新の状態です」と報告してスキルを終了する
4. 更新の方針をユーザーに確認する
利用可能な質問ツールまたは簡潔な日本語の質問で以下を確認する:
header: "update-policy"
question: "アップデートを取り込みますか？"
options:
- label: "インフラファイルのみ自動更新する（推奨）"
description: "ユーザーのスクリプトは変更しません。"
recommended: true
- label: "差分の詳細を確認してから判断する"
description: "変更ファイルごとの差分を確認します。"
- label: "キャンセル"
「キャンセル」の場合はここで停止する。
「差分の詳細を確認」の場合は、自動更新対象ファイルそれぞれの差分 (git diff HEAD..upstream/main -- <file>) を表示し、再度確認を取る。
5. インフラファイルを upstream から取り込む
以下のコマンドで対象ファイルを取り込む（実際に upstream に存在するファイルのみ実行する）:
git checkout upstream/main -- scripts/
git checkout upstream/main -- src/lib/
git checkout upstream/main -- src/init.ts
git checkout upstream/main -- src/tests/
git checkout upstream/main -- src/types/
git checkout upstream/main -- src/aeft/lib/ src/aeft/types/
git checkout upstream/main -- src/ilst/lib/ src/ilst/types/
git checkout upstream/main -- src/phxs/lib/ src/phxs/types/
git checkout upstream/main -- rollup.config.mjs tsconfig.json eslint.config.mjs
git checkout upstream/main -- package.json .prettierrc .prettierignore pnpm-workspace.yaml
git checkout upstream/main -- AGENTS.md .agents/instructions/
git checkout upstream/main -- .agents/skills/add-script/ .agents/skills/debug-script/
git checkout upstream/main -- .agents/skills/es-to-ts/ .agents/skills/update-from-upstream/
git checkout upstream/main -- docs/
ファイルが upstream に存在しない場合は error: pathspec が出るのでスキップする。
6. es.config.mjs の構造が変わっていた場合
git diff HEAD..upstream/main -- es.config.mjs を確認する。
構造や新しいフィールドが追加されていれば、変更点をユーザーに提示し、手動で es.config.mjs を更新するよう案内する。
自動マージは行わない（ユーザーのスクリプト設定を破壊するリスクがあるため）。
7. 依存関係を更新する
pnpm install
pnpm-lock.yaml は自動生成されるため、checkout 対象には含めない。
8. ビルドを確認する
pnpm build --all
エラーがある場合は原因を調査・修正してから次のステップへ進む。
9. 完了を報告する
ユーザーに以下を伝える:
- 取り込んだ変更点の要約（日本語）
- ユーザーのスクリプトに影響する可能性のある変更がある場合は警告
- 変更をコミットするよう案内（例:
git add . && git commit -m "chore: upstream からアップデートを取り込む"）
Notes
pnpm-lock.yaml は pnpm install で自動更新されるため、git checkout 対象から除外する- ユーザーの
src/aeft/tsconfig.json など、アプリフォルダ直下の tsconfig は更新対象外
- 大きな破壊的変更（API 変更など）がある場合は、自動更新を中断してユーザーに確認する
.agents/skills/ 配下にユーザー独自スキルがある場合は、上記 4 スキル以外を上書きしない
