/video-ask
在單一畫面中引導使用者:他們在哪裡、各項目的狀態為何、下一步該輸入什麼。
1. 從檔案讀取狀態,而非從記憶體
PVS_HOME="$(cd "$(cd "${CLAUDE_SKILL_DIR}" && pwd -P)/../.." && pwd)"
"$PVS_HOME/bin/pvs-py" "$PVS_HOME/skills/video-ask/scripts/status.py"
當使用者詢問的資料夾非當前資料夾時,請將該資料夾作為第一個參數傳入。
如果需要欄位(路徑、版本、階段)來回答精確問題,請加上 --json。
該腳本從 docs/contracts.md 定義的檔案中推斷每支影片的階段,
以最新達到的階段為準:簡要未簽署、已簽署、來源已擷取、事實、規格、配音、
建置中、已渲染、QA 失敗、QA 通過、已交付。QA 報告僅在其 sha256 與最新渲染相符時才會計入,
因此重新渲染後的 QA 會顯示為「已渲染」。請相信腳本的結果,而非先前對話回合的說法:
子代理可能已在此期間修改了檔案。
2. 回答
直接顯示腳本的輸出(輸出已經很簡潔),然後在單獨一行顯示下一步指令。 如果使用者提出問題(即引數),請在狀態之後回答,依序使用下列來源,並說明使用了哪個檔案:
$PVS_HOME/README.md(技能說明、安裝方式、產品所需的輸入)$PVS_HOME/docs/contracts.md(檔案格式、資料夾佈局、命令列)- 問題所涉及技能的
SKILL.md,位於$PVS_HOME/skills/下 - 產品的
kit/RULES.md,用於回答「為什麼有這條規則」的問題
如果答案不在這些檔案中,請如實說明,不要猜測。
3. 遇到下列情況時應提示
- 設定未完成: 下一步指令是
/video-setup。在此之前其他操作都不可靠。 - 語音金鑰未設定: 使用者應在自己的編輯器中,將金鑰貼到工作台的
.env檔案中, 切勿在對話中提供。voice.provider: say在沒有金鑰時仍可運作。 絕對不要讀取.env來檢查:腳本已經會報告是否已設定。 - 位於工作台根目錄且有產品: 每個產品都是獨立的 Claude Code 專案,
擁有自己的技能和鉤子。使用者應執行
cd products/<slug> && claude來處理該產品。 - 簡要未簽署: 建置會故意等待審查者的兩個簽名。在這些技能所屬的生產環境中, 26 個版本中有 9 個是因為沒有人同意影片必須解釋哪些功能而發生的。 請勿建議編輯審查者的簽名欄位。
- QA 失敗: 請指向該影片的
qa/REPORT.md,以查看失敗的檢查項目。
請勿從此處開始建置、修復或交付。此技能僅負責報告;使用者會自行輸入下一步指令。