動作樣本簿（Motion Specimen Book）
這是一本用於傳遞難以用語言描述的動作的樣本簿。使用者可透過視覺瀏覽選擇樣本，並以編號指示動作。本技能會從編號中提取「要移動什麼、如何移動」的規格。
| 卷 | 編號 | 內容 | 可提取的資料 |
|---|---|---|---|
| 01 | AE-001〜AE-322 | After Effects 內建的文字動畫預設集 | 正式名稱、類別、動作說明、單位／順序／變化項目／緩急／長度。曲線動作附有參考公式 |
| 02 | MG-001〜MG-137 | 動態圖形常用的動作 | 名稱、解說（機制與應用場景）、繪製樣本的 Canvas 2D 完整程式碼 |
| 03 | VT-001〜VT-130 | 語音合成使用的音訊標籤 | 標籤、效果、例句、來源、使用方式 |
工具位於此檔案同一個資料夾中的 scripts/specimen.mjs（下方的 <skill-dir> 指本 SKILL.md 所在的資料夾）。僅需 Node.js 18 以上即可執行，不會進行網路通訊（pick 指令只會在你的個人電腦內監聽）。
node <skill-dir>/scripts/specimen.mjs <command>
| 指令 | 使用時機 |
|---|---|
get <編號...> | 輸出指定編號的規格。可接受 AE-058、ae58、#MG-011 或樣本簿的 URL 等格式。一次最多12個 |
search <關鍵字...> | 以關鍵字搜尋。支援日文或英文。範例：search 文字 彈跳、search wipe transition。可使用 `--book ae |
list | 顯示三卷的分類與數量。加上 --book ae 可列出該卷所有項目，每行一筆 |
| `table --book ae | mg |
pick | 在瀏覽器中開啟樣本簿，等待使用者選取並按下「傳送給 AI」。選取完成後輸出所選編號的規格與備註 |
info | 顯示資料版本、筆數、樣本簿位置 |
共通選項：--lang en 輸出英文，不加則為日文。
執行步驟
- 使用者提到編號時，先執行
get。 當使用者以編號指示動作，直接將該編號傳給get，讀取輸出的規格後再開始作業。切勿只看名稱就憑空想像。 - 貼上的內容比照辦理。 從樣本簿「複製選取項目」產生的文字（以「從動作樣本簿中選取了以下 N 個項目」開頭）已包含規格，可直接使用。若不敷使用，再以
get重新提取。結尾的「備註：」為使用者的指示。 - 若需使用者選取，請執行
pick。 當使用者說「想看著選」「有哪些類型？」時，執行pick。若知道使用場景，可用--book限定卷別（文字動畫＝ae、形狀與轉場＝mg、聲音＝vo）。- 執行後會顯示 URL 並開啟瀏覽器。告知使用者：「請選擇樣本，然後點擊右下角的『傳送給 AI』按鈕。」
- 最長等待15分鐘（可使用
--timeout 秒變更）。若 shell 有執行時間限制，請在背景執行並等待結束，或加上較短的--timeout。 - 結束代碼 0：依選取順序輸出編號規格與備註。結束代碼 4：逾時且未選取任何項目。此時不應代為選取，而應詢問使用者。
- 若瀏覽器無法開啟，請將顯示的 URL 提供給使用者。若仍不可行，請使用者在樣本簿中「複製選取項目」並貼上。
- 僅使用被選取的項目。 透過
pick或貼上取得的編號即為確定。不得擅自增減或替換為其他編號。若覺得不適合該場景，應說明理由並詢問使用者。 - 搜尋時使用
search。 當使用者未自行選取，而是委託「選個合適的」，或無法開啟樣本簿的環境下，可使用此指令。不要只看名稱，應閱讀說明文字了解動作效果再選擇。
各卷使用方式
AE（After Effects 文字預設集）
- 若使用 After Effects 製作，請直接套用正式名稱的預設集。 位置為「效果與預設集 > 動畫預設集 > Text > (類別) > (正式名稱)」。這是最準確的方式。預設集檔案（副檔名
.ffx）位於 After Effects 應用程式資料夾內的Presets資料夾。 - 若在 After Effects 以外的環境（Web、Canvas、Remotion、對影片生成 AI 的指令等）重現，請根據
get的規格來製作。 直接移用「動畫單位」「順序」「變化項目」「重疊方式」「緩急」「長度」。若有附參考公式，請保持公式數值不變。 - 規格為近似值。 名稱與類別與 Adobe 官方說明清單一致，但動作規格並非從 After Effects 本體的預設集檔案中擷取，而是樣本簿作者在瀏覽器上重現的結果。請在回報給使用者時加註可能與實際效果不同。
MG（動態圖形動作）
get輸出的程式碼即為繪製該樣本的程式。包含draw(c, t, s)與輔助函式，可直接執行。寬 320×高 180，t為一個週期內的位置（0～1）。- 若轉移至其他技術（CSS、SVG、Remotion、After Effects 的關鍵影格），請保持程式碼中的秒數、延遲、緩急、過衝量、距離、角度不變。可變更的項目為顯示文字、顏色、標誌或圖片。
- 解說文字中的秒數與比例為參考值。調整時間長度時，請保持比例伸縮。
VT（音訊標籤）
- 標籤需以方括號書寫，並置於欲施加效果的詞語前方。相同語調會持續到下一個標籤為止。以逗號分隔可疊加效果（例：
[whispering, fearful]）。 - 相容於 ElevenLabs 的 Eleven v4 / v4 Turbo / v3。標籤並非固定清單，可自由書寫，但不保證一定有效。若無效果，可改用相近詞語重新生成。
- 來源標示為「Suno 歌曲用標籤」的項目，為製作歌曲所用，不保證在朗讀情境下有效。
- 語音生成會產生費用。未經使用者要求，請勿擅自生成。
注意事項
- 若編號不存在於樣本簿中，請告知使用者該編號不存在，並提供
search的候選結果。切勿自行建立編號。 - 不要一次擷取大量資料。
list與search用於尋找候選項目，get用於實際使用的少數項目。table僅在使用者要求查看編號表時使用。 - 工作結束時，請回報使用的編號與名稱、應用的位置，以及變更的內容。若有無法確認的部分，也請一併記錄。
疑難排解
pick顯示「找不到樣本簿位置」（結束代碼 3）：若手邊有樣本簿資料夾，請加上--site <資料夾>；若已知公開 URL，請加上--url <URL>。兩者皆無，則詢問使用者編號，或請使用者從樣本簿複製並貼上。- 沒有 Node.js：
data/catalog.json為一般 JSON 檔案。可在items[]中依id、name、nameJa、ja、en搜尋，prompt.ja（或prompt.en）即為get指令的輸出內容。