這份 Quickstart 給第一次下載 Visual Agent Design（VAD）的人。
你不需要先學會複雜 Prompt，也不需要先理解整套研究方法論。先完成一個真實任務，再回頭理解 TRC-3D、VAC-8 與 Agent Blueprint。
git clone https://github.com/draiagent/Visual-Agent-Design.git
cd Visual-Agent-Design核心檔案：
AGENT.md
AGENTS.md
CLAUDE.md
GEMINI.md
CHATGPT.md
CARD-REGISTRY.md
examples/
tools/
VAD 的 Five-Pack 提供五張核心標準執行卡：
| 任務 | Card ID | 主要檔案 |
|---|---|---|
| 影片剪輯 | VAC-VIDEO-001 |
examples/video-editing-vac.md |
| 簡報製作 | VAC-SLIDE-001 |
examples/slide-deck-vac.md |
| 網站生成 | VAC-WEB-001 |
examples/website-vac.md |
| 數據分析 | VAC-DATA-001 |
examples/data-analysis-vac.md |
| 報告製作 | VAC-REPORT-001 |
examples/report-vac.md |
另有兩張 Extended 標準卡，用法完全相同：
| 任務 | Card ID | 主要檔案 |
|---|---|---|
| 資訊圖卡製作 | VAC-INFOGRAPHIC-001 |
examples/infographic-card-vac.md |
| 漫畫筆記製作 | VAC-COMIC-001 |
examples/comic-notes-vac.md |
| 社群貼文製作 | VAC-SOCIAL-001 |
examples/social-post-vac.md |
機器可讀版本位於：
examples/machine-readable/
把「素材 + 對應 Visual Agent Card」一起交給支援檔案或多模態輸入的 AI Agent。
只需要說：
使用這張 Visual Agent Card 執行。
Agent 應該自行完成：
讀卡
→ 檢查素材
→ 執行流程
→ 使用可用工具
→ 檢查限制
→ 產出結果
→ Acceptance Criteria 驗收
如果缺少 Critical 素材，Agent 才需要詢問。
把 CHATGPT.md 的內容放入 Project Instructions，並把下列檔案加入專案知識：
AGENT.md
CARD-REGISTRY.md
examples/
使用時可直接說：
使用 Visual Agent Design。
把這些素材做成 10 頁簡報。
VAD 應先匹配 VAC-SLIDE-001，而不是要求你重新撰寫完整簡報 Prompt。
將本 Repository 作為專案工作目錄。
Codex 由：
AGENTS.md
→ AGENT.md
→ CARD-REGISTRY.md
→ 對應 VAC
取得工作規則。
讓 Gemini 讀取：
GEMINI.md
.agents/skills/visual-agent-design/SKILL.md
可直接要求：
使用 visual-agent-design，分析這份 Excel 並產出圖表與摘要。
預期路由：
TRC-3D
→ VAC-DATA-001
→ Workflow / Analysis Agent
→ Acceptance Criteria
將本 Repository 作為 Claude Code 專案目錄。
Claude 依：
CLAUDE.md
→ AGENT.md
→ CARD-REGISTRY.md
→ 對應 VAC
例如：
使用 VAD，把這份逐字稿與背景資料整理成正式報告。
預期使用 VAC-REPORT-001。
若環境可以執行 Python：
python tools/vac_runner.py list
python tools/vac_runner.py route "把這份 Excel 分析並產出圖表"
python tools/vac_runner.py validate VAC-DATA-001
python tools/vac_runner.py plan VAC-DATA-001
python tools/vac_runner.py envelope VAC-DATA-001VAD 不要求所有任務都建立 Agent。
簡單任務
→ Direct / Prompt
未知、單次、複雜
→ Research
固定、重複
→ Workflow + VAC
需要動態決策
→ Agent
需要跨 Agent 協作
→ Multi-Agent / MCP / A2A
先做最小、足夠的路由，再決定是否升級。
如果你只是更換公司名稱、品牌色、Logo、頁數、影片長度、受眾或輸出格式，通常不需要建立新卡，使用同一張標準 VAC 加上 override 即可。
只有核心流程、決策規則、限制條件、驗收契約或任務本質改變時，才建立新 Card ID。
準備：一份 1500–2500 字資料、3–5 張圖片、Logo、VAC-SLIDE-001。
交給 Agent：
使用 VAC-SLIDE-001 執行，輸出 10 頁 PPTX 與 PDF。
準備：Excel / CSV、欄位說明、一個分析問題、VAC-DATA-001。
交給 Agent：
使用 VAC-DATA-001 執行，產出清理資料、三張圖表與分析摘要。
VAD 不把「AI 已生成」當成完成，必須經過 Acceptance Criteria。
例如影片不是成功輸出 MP4 就算完成，而是還要確認：可播放、字幕正確、音畫同步、時長正確、主旨一致、Logo 正確。
完成第一個 Five-Pack 任務後，再閱讀：
docs/METHODOLOGY.md
templates/TRC-3D.md
templates/VAC-8.md
rubrics/VAC-QI.md
research/RESEARCH-PROTOCOL.md
VAD 的核心不是少打幾個 Prompt，而是把工作變成可理解、可執行、可驗收、可重用的標準。