| name | es-to-ts |
| description | 既存の ExtendScript (.jsx / .js) を TypeScript に書き直す。Use when: 既存のスクリプトを TypeScript 化したい、.jsx ファイルをプロジェクトに追加したい、古い ExtendScript コードをモダンな TypeScript に移植したい、JSX を TS に変換したい。 |
| argument-hint | 変換したい ExtendScript コードを貼り付けるか、ファイルパスを指定してください |
ExtendScript → TypeScript 変換
既存の ExtendScript (.jsx) を、このプロジェクトの TypeScript 形式に書き直す。
When to Use
- 既存の
.jsx スクリプトをプロジェクトに取り込みたい
- 古い ExtendScript コードを TypeScript で管理したい
Procedure
1. 対象コードを取得する
ユーザーがコードを貼り付けていない場合は、対象ファイルを読み込む。
2. 事前確認: 三項演算子の検出
コード内の三項演算子 (? :) を探す。
三項演算子は ExtendScript の既知バグのため、変換後は必ず代替構文に書き直す。
三項演算子が見つかった場合は、利用可能な質問ツールまたは簡潔な日本語の質問でユーザーに確認する:
header: "ternary"
question: "以下の三項演算子の仕様を教えてください。変換に必要です。"
condition ? valueIfTrue : valueIfFalse の valueIfTrue / valueIfFalse それぞれが
何を返すべきかを確認し、if 文または即時呼び出し無名関数で書き直す。
3. 対象アプリ・スクリプト名を確認する
ユーザーが指定していない場合は、利用可能な質問ツールまたは簡潔な日本語の質問で確認する:
header: "target"
question: "このスクリプトはどの Adobe アプリ向けですか？"
options:
- label: "After Effects"
- label: "Illustrator"
- label: "Photoshop"
4. 新しいスクリプトを作成する
add-script スキルを呼び出して、新しいスクリプトのファイルを生成する。
（スキルが利用できない場合は pnpm new -- --app=<appId> --name=<ScriptName> --license を実行する）
5. TypeScript に変換する
.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 など）。
6. lint・ビルドで確認する
pnpm lint && pnpm format && pnpm build -- <appId>/<ScriptName>
エラーがあれば修正する。
7. 完了を報告する
- 変換したファイルのパスをリンク付きで示す
- 三項演算子など手動確認が必要な点があれば明記する
Notes
