產品素材包 (Product Kit)
每個產品的所有影片都從同一套素材包中提取,因此素材包只需提取一次、批准一次,即可重複使用。 在這些技能來源的製作過程中,零散處理的成本很高: 一個圖示字型未經詢問就被下載,後來才獲得批准,之後又擴展了三次; 期間一個子代理從瀏覽器擴充功能資料夾中的字型檔裡取了兩個字形; 同一個示範客戶在兩支影片中有不同的姓氏,因為一份否決名單從未獲得回覆; 一個更名後的產品在螢幕上保留了舊名稱,直到審查員發現。
開始之前
- 來源必須鎖定(
sources.lock、sources/<role>/)。如果尚未鎖定,請先執行 source-recon: 每個素材包檔案都需引用已鎖定的提交。 - 一次性詢問所有素材包所需的下載項目(字型套件、儲存庫中沒有的圖示套件),以單一清單列出內容、來源及大約大小。 未經同意不得下載任何項目,且絕不能從瀏覽器設定檔或擴充功能資料夾取得。
PVS_HOME="$(cd "$(cd "${CLAUDE_SKILL_DIR}" && pwd -P)/../.." && pwd)"
K="$PVS_HOME/skills/product-kit/scripts"
1. 設計符記 (Tokens)
執行 ui-spec-from-code 的解析器,針對產品主題進行解析,並將其描述的渲染事實(執行時期 rem、主題選擇器、實際載入的字型)寫入 kit/render-facts.md:
"$PVS_HOME/bin/pvs-py" "$PVS_HOME/skills/ui-spec-from-code/scripts/resolve_tokens.py" <product_dir> \
[--theme-selector "<dark selector>"]
從產品用於其主色調的符記中,設定 brand.accent 至 product.yaml,並引用該符記。
2. 字型 (Fonts)
找出應用程式實際載入的字型(link 標籤、@font-face、鎖定檔案中的字型套件),而非僅是 CSS 名稱所列出的。
從儲存庫或已安裝的套件中取得檔案(例如 node_modules 中的 @fontsource/<family> 套件);
僅存在於網路字型服務上的字型需要用戶批准才能下載。然後建立子集:
"$PVS_HOME/bin/pvs-py" "$K/subset_fonts.py" <product_dir> <font files...> \
[--text-file videos/*/audio/lines.tsv] [--license OFL-1.1] [--source <citation>]
它會寫入 kit/fonts/<family>-<weight>.woff2,重建 kit/fonts/fonts.css(font-display: block,
確保渲染時不會先顯示替用字型),將在字型檔案旁或其套件中找到的授權文字複製(OFL 要求授權文字
必須與字型一併傳遞),並將來源、授權和授權檔案記錄在 kit/fonts/fonts.md 中。
帶有「unknown」授權或「missing」授權檔案的字型視為未就緒:請尋找或詢問。
在 product.yaml 中設定 brand.font。
對於透過連字運作的圖示字型,請傳遞 --all-features 並將連字名稱作為 --text,
檢查每個名稱是否渲染為圖形,而非文字。
3. 圖示 (Icons)
從 ui-spec-from-code 的圖示提取工具(或規格書)中取得圖示清單,並按套件分組。 從產品自己的套件中複製:
"$PVS_HOME/bin/pvs-py" "$K/collect_icons.py" <product_dir> --package <dir with svg files> \
--names calendar,check,plus [--variant outline/24] [--prefix bx-] [--clean]
它會將每個 SVG 複製到 kit/icons/<set>-<name>.svg,並在 kit/icons/icons.md 中新增一行
(檔案、名稱、套件、來源引用、授權)。遇到遺失或模糊的名稱時,它會失敗,而不是挑選一個相似的圖示,
因為在來源製作過程中,一個近似但錯誤的圖示導致審查員拒絕了整份初稿。
僅以圖示字型形式存在的圖示:為字型建立子集(第 2 節),並從程式庫自己的 CSS 中取得碼點;
遇到未知名稱時,建置必須失敗。
4. 標誌 (Logos)
僅從儲存庫的資產(或用戶提供的品牌套件)取得:絕不重新繪製、描摹或從網站取得。 列出候選項目,進行檢視,然後複製三個變體:
"$PVS_HOME/bin/pvs-py" "$K/collect_logos.py" <product_dir> # candidates in sources/
"$PVS_HOME/bin/pvs-py" "$K/collect_logos.py" <product_dir> --light frontend/assets/logo.svg \
--dark frontend/assets/logo-white.svg --tile frontend/public/icon-512.png [--root <brand folder>]
它會寫入 kit/logos/logo-light.*(用於淺色背景)、logo-dark.*(用於深色背景)和
app-tile.*(方形圖示),如果產品有 SVG 格式則使用 SVG,並在 kit/logos/logos.md 中
為每個檔案新增一行並附上引用;它會拒絕網址。然後在 product.yaml 中將 brand.logo_light、
brand.logo_dark 和 brand.app_tile 設定為它列印的路徑。
在每支影片中根據背景選擇變體:淺色標誌在白色頁面上會消失,這在來源製作中曾經發生過。
5. 角色 (Cast)
從第一幀開始,示範資料就必須是虛構的,並且在所有影片中保持一致。
閱讀 references/cast-and-names.md 以了解保留的號碼範圍和網域。
在單一封閉式問題中提出一組完整的角色,並將您的提案作為建議的預設值:
所有 Acme Tasks 影片的示範角色(建議:原樣使用): Northwind Bakery, Portland OR (northwind.example);業主 Maya Lindqvist, [email protected];客戶 Omar Haddad, +1 503 555 0172。使用這個,還是要更改哪些名稱?
全名,每人一個姓氏,永久保留;號碼範圍 555-0100 到 555-0199;電子郵件和網站使用保留網域。
審查員可以基於品味否決名稱(在來源製作中,一個平淡無奇的名字曾被拒絕),
因此在任何動畫製作之前必須先詢問。如果審查員沒有回覆,請說您將凍結提案並凍結它:
沉默絕不能導致同一個人有兩個版本。將它寫入 product.yaml 中的 cast:,並進行檢查:
"$PVS_HOME/bin/pvs-py" "$K/check_cast.py" <product_dir>
如果缺少姓氏、名字包含兩個姓氏、電話非 555 或非虛構、電子郵件或網站使用看似真實的網域,它會失敗。
6. 名稱、發音、禁用詞彙
詢問用戶,然後寫入 product.yaml:
names:將標準名稱對應到絕對不能出現的舊有字串(即時 UI 或程式碼可能仍會顯示的舊產品名稱)。 即使實際 UI 較舊,每支影片都使用標準名稱,並且在渲染前 grep 會找到舊有名稱。pronounce:將品牌詞彙對應到語音引擎能正確發音的拼寫(在來源製作中,一個自創的產品名稱 被讀成另一個詞,是靠聽覺發現的)。banned_terms:競爭對手、團隊不希望出現在畫面上的第三方供應商、真實客戶、內部代號。never_say和positioning:一句話的 identity 以及它絕不能採用的措辭。
7. 唯讀工具
填寫 kit/RULES.md 的第 10 節「唯讀工具」(範本中已預留佔位符),
列出代理可以呼叫的產品 API 或 MCP 工具(文件、目錄、範本),
並說明其他所有內容都是禁止的。
具有寫入權限的連線也應透過此規則保持唯讀;建議使用範圍限定為唯讀的憑據,
因為在來源製作中,唯讀僅靠指令強制執行。
8. 報告
向用戶顯示素材包庫存(符記數量和標誌、附帶授權的字型、按套件分組的圖示、標誌、角色)、 仍需批准的事項,以及您變更的 product.yaml 鍵。