# 影片自動化工具包：技能書與協作來源

把影片素材的檢查與剪輯步驟，整理成可重跑的流程。

## 工坊收錄說明

內容與行銷

會剪短影音、經營頻道或想改造剪輯工具的人。

一份短影音判定結果與調整紀錄。

影音公會或小隊可用來比較剪輯規則，再逐步套用到自己的素材。

先跑不需真素材的範例，理解規則後再準備自己的影片。

## 封面與來源署名

封面插畫：/art/skills/video-autopilot.webp

原作者 GitHub：https://github.com/Hao0321/video-autopilot-kit

登入自由工坊並連結自己的 GitHub，即可在技能書加星或取消星星。

原作數據：/api/v1/github/books/video-autopilot/metrics

Stars、Forks、追蹤數、未結 Issues 與 PR 合計、最近程式更新時間以 GitHub 回覆為準；數據附核對時間，讀取失敗不冒充零。

## 讀者與格式

剪輯工具與方法框架

- 短影音剪輯者

- 頻道營運者

- 想改善剪輯工具的開發者

## 功能與使用範圍

收錄 v0.23.0；完整剪輯走 Editkin v4，另有無真素材範例。實際頻道設定、素材與執行環境需自行準備。

- 長片、Shorts 與 Reels 的規劃和品質檢查

- ffmpeg 素材處理及濾鏡工具

- 可重跑範例與逐步剪輯流程

## 開始前準備

- 入門範例使用 Python 3.9+，示範 04 不需要額外套件或 ffmpeg

- 真正渲染影片時另需 ffmpeg／ffprobe 及對應媒體相依

## 第一個練習

1. 先跑不需要影片素材的 Shorts 規則範例，看看不合格與修正後的差別。

2. 只改一個門檻，記錄判定為何改變。

3. 再依 SETUP.md 填自己的頻道資料，挑一段素材進入後續剪輯練習。

## 練習成果

一份可重跑的 Shorts 判定結果與你修改門檻的說明。

## 原始專案的起步指令

在自己的專案副本根目錄執行；指令已對照收錄版本的說明，這次介紹核對沒有代為安裝或執行。

```sh
python examples/04_shorts_gate.py
```

## 專案與授權

原作 Repo：https://github.com/Hao0321/video-autopilot-kit
從原作建立自己的版本：https://github.com/Hao0321/video-autopilot-kit/fork
工坊整合參考：https://github.com/FreeTWAI/video-autopilot-kit
記錄的授權：MIT

## 一起改這本技能書

把 Hao 的剪輯框架當共同底層，分工補測試素材、檢查工具、字幕配樂範例與使用回饋。

原作 Repo：https://github.com/Hao0321/video-autopilot-kit
預設 PR 目標：Hao0321/video-autopilot-kit:main
從原作建立自己的版本：https://github.com/Hao0321/video-autopilot-kit/fork
原作 PR：https://github.com/Hao0321/video-autopilot-kit/pulls

工坊整合參考：https://github.com/FreeTWAI/video-autopilot-kit
工坊整合任務專用 Fork：https://github.com/FreeTWAI/video-autopilot-kit/fork
工坊任務：https://github.com/FreeTWAI/video-autopilot-kit/issues
工坊 PR：https://github.com/FreeTWAI/video-autopilot-kit/pulls
GitHub Milestones：https://github.com/FreeTWAI/video-autopilot-kit/milestones

先閱讀原作現行的貢獻規則。Fork 不會自動回饋原作；修改要以 PR 提交，由原作維護者決定是否合併。工坊整合任務可在工坊審查，另外記錄回饋原作的 PR 或未回送原因。

以下是入口與建議，不代表已認領或已完成。以 GitHub 最新 Issue、PR 與維護者確認為準。

- 第一輪可重跑的共創成果（建議里程碑）：各項可分開提 PR；保留 Editkin v4 契約、公開素材來源與實跑記錄。不是已建立的 GitHub milestone。

### 建立可重現的剪輯測試素材 · GitHub 任務，查看最新狀態

重用 examples 的合成素材能力，加入小型 fixture 產生器與清單。

- 驗收：包含直式影片、已知靜音與字幕時間點；清單列時長、尺寸、音軌及來源。

- 驗收：壞時長或缺音軌的案例會失敗，缺 ffmpeg 時列未執行。

來源：https://github.com/FreeTWAI/video-autopilot-kit/issues/1

### 加入最小檢查指令與 JSON 結果 · GitHub 任務，查看最新狀態

新增貢獻者檢查入口，重用既有 system_health 與範例。

- 驗收：--list 不執行、--run 只跑指定已知檢查，拒絕任意 shell。

- 驗收：結果區分 passed／failed／not_run，附退出碼、時間與原因。

來源：https://github.com/FreeTWAI/video-autopilot-kit/issues/2

### 做出字幕與配樂擴充範例 · GitHub 任務，查看最新狀態

約十秒的合成素材，字幕與配樂資料接現有 Editkin v4；先確認輸入輸出草圖。

- 驗收：時間超界或反轉有拒絕測試，不另做 editor runtime。

- 驗收：分開列 plan、contract、render 的真實驗證；沒有 editor 就列 render 未驗證。

來源：https://github.com/FreeTWAI/video-autopilot-kit/issues/3

### 整理共同推廣與需求回饋 · GitHub 任務，查看最新狀態

以 README 和可跑範例寫一份介紹與訪談草稿；不代人群發。

- 驗收：功能主張連回來源，回饋附日期與同意範圍。

- 驗收：未有真人回饋就保留空白；未有人審查就明示等待 review。

來源：https://github.com/FreeTWAI/video-autopilot-kit/issues/4

### 核對 Pillow 依賴與影音相容性 · GitHub 任務，查看最新狀態

對照目前鎖版及官方 advisory，在隔離環境提出最小依賴修正。

- 驗收：附版本依據和相關影像／字幕／音軌回歸。

- 驗收：殘留告警與未驗證平台如實列出，不以版本字串代替修復證據。

來源：https://github.com/FreeTWAI/video-autopilot-kit/issues/5

Agent Skill：/development/skills/video-autopilot/SKILL.md
協作 JSON：/api/v1/skills/video-autopilot/collaboration

## 參與開發

參與自由工坊的影片共創任務，補可重現素材、測試或剪輯說明。

工坊 Issue／PR 協調入口：https://github.com/FreeTWAI/video-autopilot-kit/issues

先讀該 Repo 根目錄 README.md、AGENTS.md、CONTRIBUTING.md；原始程式、測試及來源授權留在該專案。平台介紹與公會收錄則在 freedom-platform 的 modules/community 維護。

要改善平台介紹：https://github.com/FreeTWAI/freedom-platform/issues

## 閱讀與來源

閱讀原始專案：https://github.com/Hao0321/video-autopilot-kit/blob/b449e7a57076cbc66db77ccbf2d3978f492af7dc/README.md
核對日期：2026-09-30
核對版本：b449e7a57076cbc66db77ccbf2d3978f492af7dc

- README.md：https://github.com/Hao0321/video-autopilot-kit/blob/b449e7a57076cbc66db77ccbf2d3978f492af7dc/README.md

- examples/README.md：https://github.com/Hao0321/video-autopilot-kit/blob/b449e7a57076cbc66db77ccbf2d3978f492af7dc/examples/README.md

- examples/04_shorts_gate.py：https://github.com/Hao0321/video-autopilot-kit/blob/b449e7a57076cbc66db77ccbf2d3978f492af7dc/examples/04_shorts_gate.py

## 共創原則

GitHub Issue 是待辦與協調來源，PR 是審查與合併紀錄。先確認任務範圍，再用自己的分支完成相關驗證；保留上游與實際貢獻者。Fork 不等於平台認證、已測試運行或新授權。

完整結構化目錄：/api/v1/development-map