/showfolio-slim
作ったものを、見せよう。モデル自身がストーリー、映像、オーディオ、レンダリングを、マシン上にあるツールだけで全て行います。
トーンに関わらず、モダンで洗練された、磨き抜かれたショーケース動画であるべきです:画面上やサウンドトラックに、存在価値のないものは一切置きません。全ての動画は、Octacer が構築したプロジェクトを紹介します(以下の「Octacer ブランドフレーム」参照)。
使用方法: /showfolio-slim [input] [options]。オプション(フラグ形式または平文形式):
| オプション | デフォルト値 |
|---|---|
--tone <プリセットまたは自由形式> | 推測;明確に合致するものがなければ default |
--format landscape|vertical|square | landscape(1920×1080;vertical 1080×1920、square 1080×1080)、60fps |
--duration <秒> | ステップ0で質問(約40、60、90秒) |
生成物はカレントディレクトリの showfolio-output/ に出力します(既に存在する場合は showfolio-output-YYYY-MM-DD-HHmmss/ というタイムスタンプ付きのディレクトリを作成)。中間ファイル(フレーム、ダウンロード、スクリプト、ステム)は全て、その中の work/ サブフォルダに保持します。
0. インテーク
何よりも先に、ユーザーに 1つのメッセージ で3つの質問をし、回答を待ちます。事前にルートやページリストをざっと確認し、質問2で実際の選択肢を提示できるようにしておくと良いでしょう。呼び出し時に既に回答されている質問はスキップします。
- 長さ: 動画の長さはどのくらいが良いですか? 約40秒、60秒、90秒、またはユーザー自身の指定。回答がない場合は60秒を使用し、その旨を伝えます。
- 紹介する内容: 動画に含めるべき機能やページはどれですか? 見つけた主要なものをリストアップします。最も誇りに思うものをユーザーにマークしてもらい、その機能に最も長い表示時間を割り当てます。
- 目的: このプロジェクトは何のためのものですか? 一言で教えてください。
表示必須の項目は全て、それぞれ専用のシーンを持ちます。お気に入りは最長のセグメントと最も強い位置を得ます。目的の一文は、ストーリーの背骨となり、共有コピーのベースとなります。指定された機能がコード内に存在しない場合、または目的がコードの内容と矛盾する場合は、その旨を伝えます。
ログインチェック。 次に、表示するページがログインの背後にあるかどうかを判断します(ログインルート、認証ミドルウェアまたはルートガード、NextAuth、Clerk、Supabase、Firebase、Auth0、Passport、Devise などの認証ライブラリ)。該当する場合は、テスト用認証情報を取得します:
- ユーザーが既に認証情報を提供している場合 → それを使用します。
- 提供がない場合、リポジトリ内でデモアカウントやテストアカウントを探します:README やドキュメント(「デモアカウント」「テストユーザー」)、シードスクリプトとフィクスチャ、エンドツーエンドテストのログインヘルパー、
.env.example。実際の.envファイル、キー、シークレットフォルダは決して開かないでください。見つかった場合、どのアカウントでどこにあるかをユーザーに伝え、安全なテストアカウントであることを確認します。 - 見つからない場合 → ユーザーにテストアカウントと、アプリが動作している URL(ローカルまたはステージング)を尋ね、ログインと画面キャプチャのみに使用することを伝えます。
ユーザーが共有を希望しない場合は、コードからログイン後の画面を架空のデータで再構築します。
アプリにアクセスできない場合(URL が解決しない、またはローカルで実行すると共有データベースや本番データベースに影響を及ぼす可能性がある場合)は、アプリを実行しません。リポジトリ内の実際のスクリーンショット(docs、README、デザインフォルダ)をプロダクトレイヤーとして使用し、それらをインタラクティブに見せます。各スクリーンショットの実際の入力ボックスの上に、レプリカの入力を配置してタイピングします。ホバー状態については、カーソル下のカードやボタンの切り抜きコピーを持ち上げます。パネルをスライドインさせ、結果をアプリが行うようにワイプインします。状態が変化する連続したスクリーンショットをカットで繋ぎます。使用したソースをユーザーに伝えます。認証情報はヘッドレスブラウザセッション内でのみ使用されます。環境変数を介して渡し、ファイルに書き込んだり、画面上に表示したりしないでください。動画内のログイン画面では架空のメールアドレスとマスクされたパスワードを表示し、実際のユーザーデータは以下のルールで処理します。
ぼかし、削除しない。 重要な画面に実際の個人データ(メールアドレス、氏名、電話番号、アバター、顧客記録など)が表示されている場合、画面は残し、該当箇所のみをぼかします:テキストよりもやや大きめのボックスに強いガウシアンブラー(1080p で約8~12px)を適用し、拡大しても読み取れないようにします。プライベートデータがそのコンテンツそのものであり、ぼかし後に有用なものが残らない場合にのみ、画面を削除します。ズームやパンを通して、全てのフレームで同じ箇所をぼかします。既にプレースホルダーや架空のデータを使用しているスクリーンショットはぼかし不要です。
1. 調査
まず入力内容を特定し、そこから素材を収集します。ソースのみが変わります;以下の質問以降は、全ての入力で同じプロセスを辿ります。ステップ0で指定された表示必須機能を最も注意深く読みます。
| 入力 | 認識方法 | 素材の入手先 |
|---|---|---|
| プロジェクト | 入力がなく、カレントディレクトリがプロジェクトの場合 | コード |
| ウェブサイト | http(s):// 形式の URL、または example.com のようなベアドメイン | ライブサイト |
入力がいずれのタイプにも一致しない場合、または入力がなくカレントディレクトリがプロジェクトでない場合、ユーザーに何を紹介するか尋ねます。
プロジェクト
コードを読みます:メインページ、スタイル(正確な色とフォント)、README、ルート、主要コンポーネント。最良の素材は使用中のプロダクトです。表示必須機能それぞれについて、その流れ(エントリー → 主要アクション → 結果)を見つけます。
ソースコードがあるので、それを直接利用します:動画内でプロジェクトの実際のコンポーネント、スタイルシート、フォント、画像、アニメーションをインポートまたはレンダリングし、再構築する代わりに使用します。ログインが必要なページについては、アプリを実行し、ステップ0のテスト認証情報でログインして、実際のログイン後画面をキャプチャします。
ウェブサイト
訪問者が見るままのサイトを取得します。多くのサイトは JavaScript でページを構築するため、単純なダウンロードではほぼ空のシェルが返ってくることがあります。その場合は、ヘッドレスブラウザでページを読み込み、レンダリングされた結果を取得します。クッキーバナーやその他のオーバーレイを閉じ、セクションごとにスクロールします。スクロールに応じてアニメーション表示されるコンテンツは、1回の全ページキャプチャでは空白のままになるためです。ステップ0のテスト認証情報を使用して、ログインが必要なページにアクセスします。
- コピー: 見出し、タグライン、セクション見出し、機能名、コールトゥアクション、 testimonial(推薦の言葉)。タイトル、メタディスクリプション、ソーシャルプレビュータグも確認します。
- アイデンティティ: サイトの CSS から正確な色、読み込むフォント。
- ビジュアル: ロゴ、プロダクトスクリーンショット、ヒーロー画像、デモ動画。使用するものを
work/にダウンロードします。 - スクリーンショット: 動画のアスペクト比でページをキャプチャし、レイアウトを理解します。動画内では、フラットなスクリーンショットをパンするのではなく、実際のマークアップ、CSS、アセットを再利用してアニメーションを付けます。
- 使用中のプロダクト: デモ動画、使い方のセクション、リンクされたドキュメントで、エントリー → 主要アクション → 結果のフローを確認します。
そして、全ての入力に対して
計画を立てる前に、以下を明確にします:それは何か(ユーザーの目的の一文から始める1文)?誰のためのものか、何をもたらすか? 何が他と違うのか? 最も印象的、あるいは最も面白い主張は何か? 視覚的なフックは何か? 各表示必須機能を示す実際の UI またはフローはどれか? どのトーンが合うか? 一言の共有キャプションは何か?
Octacer ブランドフレーム
動画には決して混ざり合わない2つのレイヤーがあります。プロダクトレイヤーは、プロジェクトの実際の画面、UI、コピー、データを、プロジェクト独自の色とフォントで、変更することなく使用します。Octacer フレームは、それらを取り囲み、間に挿入される全ての要素です:ステージ背景、タイトル、キャプション、機能ラベル、トランジション、イントロ、アウトロ、コーナーロゴ。
- パレット(限定): ステージ Ink
#040408、パネル#0b0e14、ヘアライン境界線rgba(255,255,255,0.10)、オプションの細かいグリッドrgba(255,255,255,0.05)、情報用 White#FFFFFF、ラベル用 Mutedrgba(255,255,255,0.65)、シグナル用 Lime#A3DC2F(明るい#BBEF44)。他の色相は使用禁止。ライム上のテキストは常に#040408。 - ライムは意味を持つ: アクティブ状態、確認済みチェックマーク、小さなクリック波紋、現在の機能セグメント、プログレスバーの塗りつぶし。プロダクト画面上のものにライムのボックスを付けないでください。ポインティングはカーソルとズームで行います。装飾として決して使用しないでください:グロー、ブロブ、発光ドット、ウォッシュは禁止。
- タイポグラフィ: 見出しと機能名は Space Grotesk ボールド、本文とキャプションは Montserrat、アイブロウ(
FEATURE 02 · DOCUMENT READERなど)は0.14emトラッキングの JetBrains Mono 大文字。3つとも Google Fonts にあります。/showfolio スキルがインストールされている場合、そのassets/brand/fonts/にセルフホスト版があります。 - ロゴ: 常にこの SVG を使用。フォントで「octacer」と入力したり、再描画したり、色を変えたり、エフェクトを追加したりしないでください。パス1は「O」を兼ねるライムマーク。パス2~7は C-T-A-C-E-R の文字。コーナーロゴには、
viewBox="0 0 29 28"でパス1のみを使用します。
<svg width="170" height="28" viewBox="0 0 170 28" fill="none" xmlns="http://www.w3.org/2000/svg">
<path d="M17.9411 26.5149C16.793 26.8285 15.5839 27 14.3328 27C11.9515 27 9.71789 26.3893 7.78272 25.3239L14.3328 8.39238L19.7575 25.8763C24.4208 23.8505 27.6733 19.2966 27.6733 14.0001C27.6733 6.82026 21.7005 1 14.3328 1C6.96495 1 0.992188 6.82032 0.992188 14.0001C0.992188 18.1696 3.00904 21.878 6.14118 24.2568" stroke="#A3DC2F" stroke-width="1.5" stroke-miterlimit="10"/>
<path d="M35.7461 13.9987C35.7461 6.79727 41.2824 1 49.0918 1C53.8214 1 57.9645 3.37658 60.0911 7.04919L58.3678 8.02135C56.6813 4.92475 53.1249 2.83627 49.0918 2.83627C42.3456 2.83627 37.6893 7.80533 37.6893 13.9986C37.6893 20.1917 42.3456 25.1607 49.0918 25.1607C53.1615 25.1607 56.7546 23.0362 58.4412 19.8676L60.1643 20.8399C58.0745 24.5486 53.8949 26.9971 49.0919 26.9971C41.2824 26.9974 35.7461 21.2002 35.7461 13.9987Z" fill="white"/>
<path d="M80.1452 2.80037H72.079V26.2051H70.0994V2.80037H62.0332V1H80.1452V2.80037Z" fill="white"/>
<path d="M97.1224 19.7958H84.2534L81.7602 26.2051H79.707L89.6796 1H91.7328L101.669 26.2051H99.6155L97.1224 19.7958ZM96.4259 17.9954L90.7062 3.34047L84.9867 17.9954H96.4259Z" fill="white"/>
<path d="M103.025 13.9987C103.025 6.79727 108.562 1 116.371 1C121.101 1 125.244 3.37658 127.37 7.04919L125.647 8.02135C123.961 4.92475 120.404 2.83627 116.371 2.83627C109.625 2.83627 104.969 7.80533 104.969 13.9986C104.969 20.1917 109.625 25.1607 116.371 25.1607C120.441 25.1607 124.034 23.0362 125.721 19.8676L127.444 20.8399C125.354 24.5486 121.174 26.9971 116.371 26.9971C108.562 26.9974 103.025 21.2002 103.025 13.9987Z" fill="white"/>
<path d="M146.801 24.4046V26.205H132.025V1H146.618V2.80037H133.969V12.5944H145.701V14.3948H133.969V24.4048L146.801 24.4046Z" fill="white"/>
<path d="M161.614 15.8708H153.511V26.205H151.568V1H161.688C165.867 1 169.277 4.34867 169.277 8.45347C169.277 11.8742 166.894 14.7548 163.631 15.6189L170.01 26.205H167.774L161.614 15.8708ZM153.511 14.0706H161.688C164.804 14.0706 167.334 11.5501 167.334 8.45347C167.334 5.32083 164.804 2.80037 161.688 2.80037H153.511V14.0706Z" fill="white"/>
</svg>
- イントロスティング(1.5~2.5秒、動画時間に含める): Ink ステージ。ライムマークが描画される(
pathLength="1"、stroke-dashoffsetを 1→0 にアニメーション)。次に文字が 40~60ms ずつずれて立ち上がるかフェードイン。約 0.5 秒間ホールドした後、フックへ。フレア、パーティクル、グローは禁止。 - 機能セグメント: フレームのタイポグラフィでアイブロウと機能名を表示。実際の画面は、ヘアライン境界線のあるパネル色のブラウザまたはデバイスフレーム内に表示され、Ink 上に中央揃え。キャプションは画面の外側に配置。
- コーナーロゴ: マークを右下に、幅の約 6~9%、マージンは幅の約 3%、70~85% の不透明度で安定して表示。プロダクトシーン中のみ。
- アウトロ(3~5秒): プロジェクト名 → フル Octacer ロゴ →
Built by Octacer(Muted Montserrat)、オプションでoctacer.comを JetBrains Mono で表示。コールトゥアクションには、Map Your System のみを使用。 - トーンはフレームに影響しない: トーンはペースとコピーのエネルギーにのみ影響します。トーンが指定されていない場合は、
polishedまたはapp-storeを優先。 - 架空の Octacer の主張は禁止: クライアント名、数値、受賞歴、推薦の言葉は禁止。「Built by Octacer」、プロジェクト自体の事実、ユーザーの目的の一文のみ。
2. 計画
showfolio-plan.md を作成:インテークの回答(長さ、お気に入りをマークした表示必須リスト、目的、ログインの処理方法(認証情報自体は記載しない))、アングル、フック、表示必須機能ごとのセグメント、パンチライン、トーン、ビジュアルアイデンティティ、および目標時間に合計されるシーン別のストーリーボード(各シーンの時間を含む)。
ユーザーが特定の部分(新しいバージョン、新機能、特定のアングル)を指摘した場合は、それを動画の焦点にします。
形状: Octacer スティング(1.5~2.5秒)→ フック(3~5秒)→ 目的/公開(4~8秒)→ 表示必須機能ごとのセグメント(各6~15秒;お気に入りは最長)→ Octacer ロゴのアウトロ(3~5秒)。これはテンプレートではなく、開始形状です。
クリエイティブの法則
- Octacer フレーム、実際のプロダクト。 プロダクトの画面はそのまま維持。それ以外の全ては Octacer:パレット、フォント、SVG ロゴ、冒頭のロゴスティング、末尾の「Built by Octacer」。
- ユーザーが希望した長さ。 ステップ0の目標に対し ±10% 以内に収めます。余白ではなくプロダクトで時間を埋めます:各機能の流れをより多く見せ、何もない状態を長く保持しない。
- ユーザーが希望した機能を紹介。 表示必須項目はそれぞれ専用のシーンを持ち、お気に入りが最も多くの時間を得ます。
- 初見でも明確に。 1回の視聴で、全く知らない人でも、何をするものか、誰のためのものか、どうやって入手するかが分かるように。その情報を最初に伝え、構築方法を先に伝えない。
- フックが全て。 最初の2秒で誰かが見続けるかどうかが決まります。まずフックを計画します。
- 実際のものを見せる。 ソースコードから実際のもの(UI、コンポーネント、コピー、画像、動画、アニメーション)を再利用し、再作成しません。再作成は再利用できないものだけに限定します。ランディングページの説明よりも、実際に動作しているアプリを見せる方を優先します。プロダクト使用時に小さな説明用 UI テキスト(ファイル名、「エクスポート完了」トーストなど)は問題ありませんが、架空の主張、数値、推薦の言葉は禁止です。抽象的な埋め草も禁止です。
- 具体的に。 このプロジェクトのために作られたと感じられるように。独自のコピーと主張を使用します。汎用的な SaaS 用語(「ワークフローを効率化」などは禁止)は使わないでください。
- 読みやすく。 ペースはモーションとカットから生まれ、テキストを早く消すことから生まれるわけではありません。視聴者が読むことを意図された行は、完全に表示され安定した状態で、読むのに十分な時間(単語あたり約0.3秒、行全体が画面に表示されてから計測)維持されます。テクスチャとしてのみのテキストは読む必要はありません。
- 生き生きとさせる。 動画内で少しずつ現れるもの(文字、カード、データポイント)は、動き出しの前に、それぞれがどこから来るのかを確立します。アプリと動画の境界線を曖昧にします:レイアウトのサイズ変更やナビゲーションをアプリが行うように見せ、スクロールはカーソルで開始します。アプリがトランジションを行い、動画がそれを捉えます。動画は、固定されたシーンを切り替えるのではなく、アプリのリズムに追従します。
- コピーはボイスオーバーではない。 動画は主に視覚的です。視聴者はテキストを読み、UI の変化を見ます。ボイスオーバーを書かないでください。代わりに、画面上のテキストと視覚的な流れで全て伝えます。
- エミュレート、キャプチャではない。 動画の内側では、ブラウザウィンドウを開き、アプリを動かし、インタラクトします。そして、その動きを捉えます。全てのシーンは、アプリが動画のフレームレートとアスペクト比で自然に使用されていることを示す必要があります。画面全体の静的なスクリーンショットを見せたい場合でも、アプリ内でそのページに移動していることを示します。
Show don't tellの精神で。
3. 作成
計画のストーリーボードとタイミングに従い、動画を構築します。最終的な出力形式は MP4 ファイルです。作業中は work/ ディレクトリを使用し、最終的な showfolio-output/ バンドルに含めます。
適切なツールを使用:
- Manim (推奨) – 数学的アニメーション用 Python ライブラリ。複雑なモーション、トランジション、テキストアニメーションに最適。
- FFmpeg – 最終的な動画ファイルの編集、結合、エンコードに必須。
ffmpegは通常利用可能。 - ImageMagick – 画像処理、リサイズ、フォーマット変換に必要に応じて使用。
- Python / Pillow – プログラムによる画像生成や加工。
- ブラウザベースのツール (Puppeteer、Playwright) – 実際のウェブサイトのレンダリングとキャプチャに。
利用可能なツールを選択し、適切なスクリプト(Python、シェルなど)を作成してレンダリングパイプライン全体を実行します。
最終動画を生成するための自己完結型のレンダリングスクリプトを作成します。これは再利用可能で、必要に応じて再実行できるようにする必要があります。
4. 出力
すべての生成物を showfolio-output/ に配置する
- 最終動画ファイル (
showcase.mp4) – プライマリ出力 README.md– 生成された内容と使用方法の説明work/– 中間生成物 / ソースファイルshowfolio-plan.md– 計画ドキュメント
動画時間の検証: 出力動画がステップ0の目標時間の ±10% 以内であることを確認します。異なる場合は調整するか、ユーザーに通知します。
ソースファイルのクリーンアップ: 認証情報、秘密、個人データが生成物や中間ファイルに含まれていないことを確認します。