Communitygithub.com

Hasnan42/Showfolio

將目前的 Octacer 專案轉換成一支精美的 Octacer 品牌展示影片(約 40、60 或 90 秒),使用 Hyperframes 技術。專案的實際畫面保持不變,周圍的一切(片頭、標題、背景、片尾、動畫標誌)皆採用 Octacer 品牌風格。

Showfolio 是什麼?

Showfolio 是一個專門為 Octacer 專案設計的 AI 助理技能,能將開發中的網站或應用程式直接轉變為品牌化的展示影片。它會先詢問三個關鍵問題(影片長度、要展示的功能或頁面、專案的一句話用途),若應用程式需要登入,還會要求提供測試憑證。接著,技能會自動讀取專案原始碼來理解應用程式,規劃展示概念,並透過 Hyperframes 技術建立完整的影片作品。 此技能支援多種語氣風格(例如:預設、精緻、Y Combinator 模仿、混亂、冷面、電影、應用商店),並可自訂格式(橫向、直向、方形)與長度。使用者也可選擇加入語音旁白(使用 Kokoro),並控制音樂與音效。Showfolio 支援多種 AI 代理平台(如 Claude Code、Cursor、Codex),並會自動辨識模型版本以切換至精簡版本。 Showfolio 的輸出包含計畫文件、分鏡腳本、最終 MP4 影片、最佳海報幀以及分享文案。所有的品牌元素(標誌、色彩、字體)均已內建,輸出目錄可設定為時間戳版本以避免覆蓋。

相容平台✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/Hasnan42/Showfolio/tree/HEAD/skills/showfolio

在你喜歡的 AI 中提問

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

說明文件

/showfolio

你打造了它。現在展示它。

調用分派(必須先執行)

模型檢查。 如果你是 Claude Opus 5.5,且調用時未要求完整工作流程(--full、「使用完整 showfolio」)或旁白(--voice,showfolio-slim 不支援),請切換至 showfolio-slim:讀取 <skill-dir>/slim.md(此處捆綁的 /showfolio-slim 技能),並在本次執行中遵循該檔案而非此檔案。將使用者的輸入傳遞過去,並將任何其他選項(--no-music、--title……)以純語言方向傳遞。先一行告知使用者,例如:「你正在使用 Opus 5.5,因此我將使用 /showfolio-slim:我會自己建立整個影片。說『use the full showfolio』即可切換回來。」如果你是任何其他模型,或無法判斷自己是哪個模型,請跳過此檢查。

在檢查專案之前,請解析完整的 /showfolio 調用。如果調用中包含 --voice,請將 voice.enabled 設為 true。僅在該次執行中啟用旁白。請勿自動啟用旁白,也請勿回退至一般的無旁白工作流程。

/showfolio 會將目前的專案網站或應用程式轉換成一個精美、可分享的展示影片,使用 Hyperframes 技術,並以 Octacer 所建立的專案形式呈現。它範圍狹窄、立場鮮明且充滿趣味。

Octacer 品牌永遠開啟。 專案自己的畫面保持原樣,而圍繞它們的框架(動畫標誌片頭、標題、背景、標籤、角落標誌、片尾)則是 Octacer。規則與資源:references/brand.md 與 <skill-dir>/assets/brand/。

此技能的功能

  1. 向使用者詢問三個引導問題(長度、要展示的內容、目的),並在應用程式需要登入時取得測試憑證。
  2. 讀取目前專案的程式碼以了解應用程式。
  3. 規劃一個特定於此專案的展示概念。
  4. 在 Octacer 品牌框架內為影片撰寫腳本與分鏡故事板。
  5. 將一份聚焦的構成簡報交給 Hyperframes。
  6. 驗證、渲染,並撰寫分享文案。

解析調用

使用者可以使用自然語言或旗標來調用:

/showfolio
/showfolio --duration 60
/showfolio --tone polished --format vertical
/showfolio this. Make it feel like a premium product film.

解析這些選項:

選項值預設值
--tone預設或自由格式描述推斷
--formatlandscape、vertical、squarelandscape
--duration秒數(約 40、60 或 90)在步驟 0 中詢問
--no-music旗標音樂開啟
--no-sfx旗標音效開啟
--title字串從專案推斷
--voice旗標旁白關閉

旁白為選擇性加入。如果存在 --voice,請透過 Hyperframes 使用 Kokoro,且不要新增任何提供者選擇邏輯。旁白工作流程刻意設定為單一提供者。

語氣可以是預設值(default、polished、yc-parody、chaotic、deadpan、cinematic、app-store),也可以是創意方向,例如「假裝是 2016 年的 Series A 上市」、「博物館展覽」或「過度製作的手機遊戲廣告」。

當使用者提供自由格式的語氣方向時,應將其對應至最接近的預設值以決定節奏與結構,但在計畫與構成簡報中保留使用者的方向。

旁白指導

當啟用 --voice 時,請撰寫能補充視覺效果的旁白:不要單純朗讀可見文字,需符合場景節奏,聽起來自然且如對話般流暢,並在不同場景間平順過渡。保持腳本簡潔且具體針對產品,讓旁白感覺像是剪輯的一部分,而非獨立的敘事音軌。


輸出目錄

預設情況下,輸出會放在 showfolio-output/。為了避免覆蓋先前的執行,請使用帶有時間戳的目錄:

showfolio-output-2026-05-04-143022/

在以下情況使用時間戳:

  • 使用者明確要求新執行而不覆蓋先前結果
  • 專案中已存在 showfolio-output/ 目錄

在執行開始時產生時間戳(YYYY-MM-DD-HHmmss),並在該次執行的所有輸出路徑中一致使用:計畫、簡報、構成、渲染以及分享文案。

技能目錄

<skill-dir> 是包含此 SKILL.md 的目錄。Claude Code 會在技能載入時將其列印為「此技能的基礎目錄」;對於其他代理程式,則為技能安裝的位置。捆綁的資源位於 <skill-dir>/assets/ 之下,腳本位於 <skill-dir>/scripts/。請勿猜測安裝路徑:插件安裝、~/.claude/skills/ 副本以及此儲存庫都會將其放在不同位置。


步驟 0:引導

閱讀: references/step-0-intake.md

在一則訊息中向使用者詢問三個引導問題(影片長度、要展示的功能/頁面、一句話的目的),並等待回答。然後執行登入檢查:如果要展示的部分需要登入,請使用使用者提供的憑證;否則在儲存庫中尋找測試憑證;再否則向使用者索取。

關卡: 你已獲得目標長度、必展示清單(附有使用者最喜愛的標記)以及一句話的目的。如果應用程式需要登入,你擁有可用的測試憑證,或者使用者已表示可以繼續而無需憑證。


步驟 1:檢查專案

閱讀: references/step-1-inspect.md

掃描專案目錄,並提取規劃影片所需的資訊。特別關注使用者在步驟 0 中挑選的功能與頁面。

關卡: 你能夠回答規劃評估標準中的所有 9 個問題。


步驟 2:規劃與分鏡

閱讀: references/step-2-plan.md 閱讀: references/brand.md

撰寫 <output-dir>/showfolio-plan.md(其中 <output-dir> 為 showfolio-output/ 或上方所選的時間戳變體)。回答規劃評估標準。確定一個創意角度。撰寫逐拍分鏡故事板,包含場景、文字、時間點、轉場以及音效提示。

若選取了音樂,請包含一個簡潔的「音樂提示指導」章節:若存在捆綁曲目的提示預設值,則從 <skill-dir>/assets/music/cues/ 讀取;否則註明提示將在構成時偵測(任何曲目現已支援節拍同步 — 請參閱 references/audio.md)。提示元資料僅為選擇性的時間指導:故事、可讀性、節奏以及產品清晰度仍為首要考量。

關卡: <output-dir>/showfolio-plan.md 存在,並包含完整的分鏡故事板。步驟 0 中的每一項必展示項目都有一個對應場景。場景時長總和落在步驟 0 目標長度的 ±10% 範圍內。


步驟 3:移交給 Hyperframes

閱讀: Hyperframes 領域技能 — hyperframes-core、hyperframes-animation、hyperframes-creative、hyperframes-keyframes、hyperframes-cli。/showfolio 有其自身的工作流程:請勿進入 hyperframes 入口點的面試對話流程,或路由至其一般的促銷/上市影片工作流程。 閱讀: references/step-3-compose.md 閱讀: references/audio.md 閱讀: references/brand.md

將 <skill-dir>/assets/brand/ 複製到構成的資源中。撰寫構成簡報,並使用 Hyperframes 在 <output-dir>/composition/ 中建立影片實作。

/showfolio 擁有產品角度、原始素材、故事板、語氣、格式、音訊選擇、音樂提示指導以及交付期望。Hyperframes 擁有具體的構成結構、確切動畫時間點、動畫機制、執行時期選擇、語法檢查規則以及渲染工作流程。

關卡: npx hyperframes check 在 <output-dir>/composition/ 內部通過,且無任何錯誤(渲染前的單一瀏覽器關卡 — 請參閱 hyperframes-cli 以了解其審計內容)。


步驟 4:驗證、渲染與交付

閱讀: references/step-4-deliver.md

驗證、預覽、渲染至 <output-dir>/showfolio.mp4,挑選最佳的海報幀至 <output-dir>/showfolio.jpg,將該海報幀燒錄為影片的第 0 幀,使其成為各處的閒置縮圖,並撰寫 <output-dir>/share-copy.txt。

關卡: <output-dir>/showfolio.mp4 存在。已挑選最佳幀海報 <output-dir>/showfolio.jpg(非任意幀),並燒錄為 showfolio.mp4 的第 0 幀。分享文案已撰寫完成。任何輸出檔案或幀中均未出現憑證。


語氣系統

/showfolio 內建七種語氣預設值。每種語氣會改變腳本能量、節奏、字體個性以及轉場風格。預設值為預設選項,而非限制。

完整定義:references/tones.md

語氣能量一句話描述
default活潑、乾淨、可發布良好氛圍的預設值
polished嚴肅、優雅適用於並非玩笑的專案
yc-parody面無表情的新創能量套用於荒謬專案的假嚴肅
chaotic快速、大聲、強烈誇張且失控
deadpan冷靜、乾燥、低調玩笑在於沒有玩笑
cinematic戲劇化、預告片規模大動作,更大主張
app-store流暢、功能卡片般乾淨企業化但不無聊

始終允許自由形式的創意方向來調整或覆蓋預設值。


創意法則

無論語氣為何,這些法則適用於每支 showfolio 影片。

Octacer 框架,真實產品。 產品的畫面保持原樣。周圍的一切使用 Octacer 品牌(Ink #040408、White、Lime #A3DC2F 作為信號色;Space Grotesk、Montserrat、JetBrains Mono;使用標誌 SVG,絕不輸入文字)。以動畫 Octacer 標誌開場,以「Built by Octacer」結尾。請參閱 references/brand.md。

使用者要求的長度。 達到步驟 0 目標(約 40、60 或 90 秒)的 ±10% 範圍內。用產品內容填滿,而非填充:展示更多功能與更長的操作應用程式時刻,絕不使用毫無內容的長時間停滯。無論旁白是否開啟均適用;旁白不會延長時間。

展示他們要求的內容。 使用者在步驟 0 中提到的每個頁面或功能都必須有專屬場景。他們標記為最喜愛的那個項目應獲得最多的螢幕時間與最強的呈現位置。

生動且快速。 60fps、快速 0.5–0.8 秒的鏡頭移動、無緩慢漂移、每 2–3 秒有新內容、在大多數產品場景中游標會點擊、以及在每個聊天或輸入框中進行即時打字。完整數據:請參閱 references/step-2-plan.md 中的「動作與節奏規則」。

可讀。 透過動作與剪輯來保持高節奏,切勿透過閃爍文字。觀眾必須閱讀的每一行文字都應停留足夠長的時間以供閱讀(短標籤約 0.8 秒穩定;一個句子約每個字 0.3 秒)。快速進入,然後停留 — 切勿快速進入,然後消失。

具體。 影片必須讓人感覺是專門為此專案製作的,而非任何專案。使用者提供的一句話目的是故事的骨幹。

展示事物本身。 大多數場景應顯示實際的 UI、文案或來自產品的關鍵視覺。無抽象填充。

無通用 SaaS 語言。 禁止使用「簡化您的工作流程」。請使用專案實際的文案與主張。

鉤子至關重要。 前 2 秒決定觀眾是否會繼續觀看。先規劃鉤子,再規劃其他一切。

幽默需名正言順。 幽默應來自專案的荒謬性,而非來自試圖搞笑。

模式:

Octacer 片頭 (1.5-2.5 秒) → 鉤子 (3-5 秒) → 目的/揭示 (4-8 秒) → 每個必展示功能一個區段 (每個 6-15 秒;最喜愛的功能最長) → 附有 Octacer 標誌的片尾 (3-5 秒)

根據情況調整。調整功能區段的大小,使總時長落在目標上。此模式為起始形狀,而非模板。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相關技能