Communitygithub.com

aktsmm/Agent-Skills

從結構化資料或測量結果,製作可重現的動畫資訊圖表 GIF,並支援觀眾語言標籤、明確的時間語意、代表性影格品質檢查與靜態備用方案。

Agent-Skills 是什麼?

這個技能(Animated Infographic)專門用來從 JSON、CSV 或純文字等結構化資料,自動產生可重現的動畫資訊圖表 GIF。它特別適合呈現基準測試結果、排名變化、比較長條圖或狀態轉換,且確保數值正確性與時間語意(演出時間 vs. 實際測量時間)的區別。支援三種時間模式:`illustrative`(純演出)、`measured`(影格時間來自實際時間戳記)、`mixed`(數值為實測,動作為演出),並要求產出前先將 source artifact 的 hash 記錄到 manifest 中,以確保可追蹤性。此技能適用於 Claude Code、Cursor、Codex 等平台,並會產出 GIF、靜態備用圖、以及驗證報告。工作流程包含凍結證據、設計敘事、本地化、明確時間標示、可重現生成、機械驗證(使用 `python scripts/validate_animation.py`)以及人工視覺檢查。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/aktsmm/Agent-Skills/tree/HEAD/animated-infographic

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

動畫資訊圖表

使用時機

  • 從 JSON / CSV / 基準測試結果建立 GIF 或動態圖表。
  • 以動畫呈現卡片移動、排名、比較長條圖、狀態轉換。
  • 製作數值準確性與演出時間/實際測量時間區分很重要的文章 / SNS 素材。

如果只需要靜態 PNG,請使用 visualize-as-infographic;若要分析現有影片,請使用 video-watch;若要製作可編輯的結構圖,請使用 draw.io 系列 workflow。

輸入

  • Source artifact:JSON / CSV / 文字。若有測量值,則以此為唯一事實來源(SSOT)。
  • 觀眾語言與目標媒介:例如日文部落格、X、簡報等。
  • 時間模式:
    • illustrative:動作為演出,不代表處理速度。
    • measured:影格時間來自實際時間戳記。
    • mixed:數值為實測,卡片或長條的動作為演出。
  • 輸出尺寸。預設為部落格/X 適用的 1200x675,必要時也建立靜態備用圖。

工作流程

  1. 凍結證據
  • 固定 source artifact、取得日期時間、對象筆數、測量邊界。
  • 決定延遲是 1 request、serial total、fresh-process end to end 等,明確所測量的值。
  • 若加工外部媒體,需在 manifest 中記錄原始 URL、取得日期、source 相對路徑、SHA-256,並在生成前比對 hash。
  1. 設計敘事
  • 每個 GIF 只聚焦一個主張。冗長說明請放回本文。
  • 固定閱讀順序:輸入 → 判斷 → 下一步處理、before → after、比較 → 結論等。
  • 若主題是狹窄的 decision gate,則使用強調色、粗外框、中央配置或 callout 等方式讓它成為視覺層級的主角。將輸入和輸出放在兩側,並在框內寫下 gate 決定的值。
  • 不要將官方術語與作者自創的分層/分類以相同外觀直接斷定。對於自創模型,應在 asset 內標示範圍(例如「本文中的整理」),並避免使用讓人誤以為是產品包含或成熟度的箭頭或巢狀結構。
  1. 在渲染前進行本地化
  • 說明 UI、狀態、標題文字要配合讀者語言。日文文章中不要殘留泛用英文 UI。
  • 產品名稱、API field、model ID 等專有名詞請保留官方寫法。
  • 避免直譯腔。例如:用「接近定義基準中的哪個階段」代替「階段で採点」。
  1. 在 asset 內明確標示時間
  • illustrative:顯示「卡片移動為演出(非實際測量速度)」。
  • measured:顯示測量邊界與單位,並根據實際測量值製作影格持續時間。
  • mixed:同時寫明「顯示值為實測 / 長條、卡片的動作為演出」。
  1. 可重現地生成
  • 保留 generator script、GIF、靜態備用圖,必要時保留 source snapshot。
  • 數值不應手動輸入,而是從 source artifact 讀取。
  • 第三方影片應裁剪到主張所需的最小影格(例如 before / operation / after),並移除無關的瀏覽器 chrome。在 asset 內區分顯示出處,以及可能造成誤讀的資訊(如 dummy 資料、未發送、作者額外註記等)。
  1. 機械驗證
python scripts/validate_animation.py output.gif `
  --expected-width 1200 --expected-height 675 `
  --timing-mode illustrative `
  --contact-sheet output-contact.jpg `
  --report output-validation.json
  1. 目視檢查
  • 以原始尺寸與目標嵌入寬度(手機約 360px)確認開始、中間、結束影格。
  • 修正文字重疊、裁切、順序、空白、無法閱讀的註記、殘留英文 UI 後重新生成。

時間規則

  • GIF 總播放時間不一定等於 API 延遲。請勿自動視為相同。
  • 若為多個 request 的總和,應顯示是並行還是序列。
  • 若比較對象的測量邊界不同,則視為「觀察到的端到端時間」,而非「模型速度」。
  • 估算成本、正確率、token 數也需與 source artifact 比對,並在 asset 中加入避免誤讀的註記。

完成條件

  • GIF 是動畫格式,且滿足預期尺寸與最少影格數。
  • 時間模式與測量邊界在 asset 內可見。
  • source artifact 的數值與顯示數值一致。
  • 若來自外部媒體,則 source URL / 取得日期 / SHA-256 與 manifest 一致。
  • 說明 UI 已統一使用讀者語言。
  • 主題的 decision gate 最先可見,且能讀懂它接收什麼、回傳什麼。
  • 在 asset 本身即可區分官方定義與作者自創的整理。
  • 已確認開始、中間、結束影格與循環播放。
  • 在目標嵌入寬度下文字可讀。
  • 已回報 generator、GIF、靜態備用圖、驗證報告的所在位置。

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

相關技能