메뉴
既存の ExtendScript (.jsx / .js) を TypeScript に書き直す。Use when: 既存のスクリプトを TypeScript 化したい、.jsx ファイルをプロジェクトに追加したい、古い ExtendScript コードをモダンな TypeScript に移植したい、JSX を TS に変換したい。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | es-to-ts |
| description | 既存の ExtendScript (.jsx / .js) を TypeScript に書き直す。Use when: 既存のスクリプトを TypeScript 化したい、.jsx ファイルをプロジェクトに追加したい、古い ExtendScript コードをモダンな TypeScript に移植したい、JSX を TS に変換したい。 |
| argument-hint | 変換したい ExtendScript コードを貼り付けるか、ファイルパスを指定してください |
既存の ExtendScript (.jsx) を、このプロジェクトの TypeScript 形式に書き直す。
.jsx スクリプトをプロジェクトに取り込みたいユーザーがコードを貼り付けていない場合は、対象ファイルを読み込む。
コード内の三項演算子 (? :) を探す。
三項演算子は ExtendScript の既知バグのため、変換後は必ず代替構文に書き直す。
三項演算子が見つかった場合は、利用可能な質問ツールまたは簡潔な日本語の質問でユーザーに確認する:
header: "ternary"
question: "以下の三項演算子の仕様を教えてください。変換に必要です。"
# 見つかった三項演算子を具体的に列挙して質問する
condition ? valueIfTrue : valueIfFalse の valueIfTrue / valueIfFalse それぞれが
何を返すべきかを確認し、if 文または即時呼び出し無名関数で書き直す。
ユーザーが指定していない場合は、利用可能な質問ツールまたは簡潔な日本語の質問で確認する:
header: "target"
question: "このスクリプトはどの Adobe アプリ向けですか？"
options:
- label: "After Effects"
- label: "Illustrator"
- label: "Photoshop"
add-script スキルを呼び出して、新しいスクリプトのファイルを生成する。
（スキルが利用できない場合は pnpm new -- --app=<appId> --name=<ScriptName> --license を実行する）
.agents/instructions/extendscript.md を読み、コーディングルールを確認してから変換する。
主な変換ポイント:
| Before (ExtendScript) | After (TypeScript) |
|---|---|
var x = ... | const x = ... / let x = ... |
function foo() {} | const foo = () => {} |
x ? a : b | if 文または即時呼び出し無名関数 |
try/catch の e.message | (e as Error).message |
| 関数の先頭に処理を書く | entry("name", () => { ... }) で囲む |
| ScriptUI ウィンドウをそのまま開く | entryUI("name", __ES_THIS__, (win) => { ... }) で囲む |
alert(...) / confirm(...) | new Window(...) を使う |
$.writeln(...) | デバッグ用途のみ可。本番では削除する |
型注釈を適切に追加する（app.project.activeItem as CompItem など）。
pnpm lint && pnpm format && pnpm build -- <appId>/<ScriptName>
エラーがあれば修正する。
Symbol / Promise は利用不可（ポリフィル対象外）$.writeln() はデバッグ用。本番コードには残さないことExtendScript プロジェクトに新しいスクリプトを追加する。Use when: 新しいスクリプトを作成する、After Effects / Illustrator / Photoshop 向けのスクリプトを追加する、スクリプトの実装を開始する、aeft / ilst / phxs スクリプトを作りたい。
TypeScript / Rollup のビルドエラーを修正する。Use when: pnpm build でエラーが出た、pnpm lint でエラーが出た、TypeScript の型エラーが出た、ビルドが失敗した、コンパイルエラー、型エラーの修正。
テンプレートリポジトリ（YukiWorks432/extendscript-ts-template）に更新があった場合に、自分のスクリプトを消さずに安全に取り込む。Use when: テンプレートの更新を取り込みたい、アップデートを確認したい、ポリフィルやビルドツールを最新化したい、upstream の変更を反映したい